drupal-functional-test

Drupal Functional Test

What It Is

Installs a complete Drupal site and simulates HTTP requests with Mink + BrowserKit. It is NOT a real browser. JavaScript does NOT execute.

Speed: 4-120 seconds per class (installs Drupal from scratch per class).

When to Use

• Module configuration forms (admin forms)
• Content creation/editing/deletion via UI
• Verify permissions: without permission -> 403, with permission -> 200
• Verify HTML output of pages
• Verify that blocks appear where they should
• Test redirects and routes
• Verify status/error messages

When NOT to Use

• If you can test the same logic with Kernel test -> use Kernel (10x faster)
• If you need JavaScript/AJAX -> FunctionalJavascript
• If it is pure PHP logic -> Unit test

Required Properties

protected $defaultTheme = 'stark';       // REQUIRED. Use 'stark' for speed.
protected static $modules = ['my_module']; // Required modules.
// protected $profile = 'testing';        // Default. Only use 'standard' if you need its config.

Base Template

NOTE: if the flow needs JavaScript/AJAX, switch to the drupal-functionaljs-test skill. assertSession()->statusCodeEquals() works HERE but does NOT work in FunctionalJavascript tests.

<?php
declare(strict_types=1);

namespace Drupal\Tests\MODULE\Functional;

use Drupal\Tests\BrowserTestBase;
use Drupal\user\UserInterface;

/**
 * Tests DESCRIPTION.
 *
 * @group MODULE
 */
class NameTest extends BrowserTestBase {

  protected $defaultTheme = 'stark';
  protected static $modules = ['node', 'block', 'MODULE'];

  protected UserInterface $adminUser;

  protected function setUp(): void {
    parent::setUp();
    $this->drupalCreateContentType(['type' => 'article', 'name' => 'Article']);
    $this->adminUser = $this->drupalCreateUser(['administer MODULE']);
  }

  public function testSomething(): void {
    $this->drupalLogin($this->adminUser);
    $this->drupalGet('admin/config/MODULE/settings');
    $this->assertSession()->statusCodeEquals(200);
  }

}