https://github.com/previousnext/drupal-test-utils

Utility traits for Drupal testing
https://github.com/previousnext/drupal-test-utils

drupal

Last synced: 4 months ago
JSON representation

Utility traits for Drupal testing

• Host: GitHub
• URL: https://github.com/previousnext/drupal-test-utils
• Owner: previousnext
• Created: 2022-12-13T22:44:24.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-23T06:05:20.000Z (7 months ago)
• Last Synced: 2024-10-01T00:06:48.224Z (4 months ago)
• Topics: drupal
• Language: PHP
• Homepage:
• Size: 22.5 KB
• Stars: 2
• Watchers: 7
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Drupal Test Utils

Utilities for testing Drupal!

## ConfigTrait

A trait to facilitate overriding config for the duration of a test.

### Usage

Add the trait to your base class and override the tearDown method.

```php

use PNX\DrupalTestUtils\Traits\ConfigTrait;

use weitzman\DrupalTestTraits\ExistingSiteBase;

abstract class MyBaseClass extends ExistingSiteBase {

  /**

   * {@inheritdoc}

   */

  protected function tearDown(): void {

    $this->setConfigValues($this->originalConfiguration, FALSE);

    parent::tearDown();

  }

}

```

In a test case, call `$this->setConfigValues`:

```php

$this->setConfigValues([

  'system.logging' => [

    'error_level' => \ERROR_REPORTING_DISPLAY_VERBOSE,

  ],

]);

```

## EntityLoadTrait

A trait to assist with loading entities in tests.

### Usage

Load one node with the title "Hello, World":

```php

$node = $this->loadEntityByProperty('node', ['title' => 'Hello, World']);

```

Load all article nodes:

```php

$nodes = $this->loadEntityByProperty('node', ['type' => 'article'], FALSE);

```

Get the last created node. Useful for asserting on entities created via the UI:

```php

$node = $this->getLastCreatedEntity('node');

```

## ExpectsCacheableResponseTrait

A trait to add Dynamic Page Cache cacheability testing to every request in your Functional tests.

### Usage

Once your trait is added to your test base class, you can check cachability by overriding the `drupalGet` function.

```php

/**

 * {@inheritdoc}

 */

protected function drupalGet($path, array $options = [], array $headers = []): string {

  $response = parent::drupalGet($path, $options, $headers);

  $this->detectUncacheableResponse($path, $options);

  return $response;

}

```

### Marking paths as uncacheable

There are some paths that are always uncacheable (i.e pages with forms like node/add). These paths can marked as uncacheable

by adding the `$uncacheableDynamicPagePatterns` property to your tests. You can add a common set of these to your test base

and add more specific paths in indivdual tests as these patterns will be gathered up the class hierarchy at run time.

Patterns are regular expressions matched with `preg_match`

E.g

```php

 protected static array $uncacheableDynamicPagePatterns = [

   '/user/login',

   '/big_pipe/no-js',

   '/batch',

   '/node/add/.*',

 ];

```