phpunit/phpunit-dom-assertions

DOM assertions for PHPUnit

v3.6.0 2025-10-23 14:08 UTC

Requires

• php: ~8.4.0 || ~8.5.0
• ext-dom: *
• phpunit/phpunit: ^10.5.58 || ^11.5.42 || ^12.4.1
• symfony/css-selector: ^6.4.24 || ^7.3.0
• symfony/dom-crawler: ^6.4.25 || ^7.3.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.89.0
• phpstan/phpstan: ^2.1.31
• phpstan/phpstan-deprecation-rules: ^2.0.3
• phpstan/phpstan-phpunit: ^2.0.7

MIT

• Sebastian Bergmann
• Jeff Welch
• Lars Strojny

• phpunit
• css
• dom
• Xpath
• tests
• assertions

README

A work in progress, drop-in replacement for the following deprecated PHPUnit assertions:

• assertSelectCount()
• assertSelectRegExp()
• assertXPathCount()
• assertXPathEquals()
• assertXPathSelectRegExp()
• assertSelectEquals()

Installation

$ composer require --dev phpunit/phpunit-dom-assertions

Usage

Extend PHPUnit\Framework\DOMTestCase to use the DOM assertions:

namespace My\Tests;

use PHPUnit\Framework\DOMAssert;
use PHPUnit\Framework\TestCase;

final class DOMTest extends TestCase
{
    public function testSelectEquals(): void
    {
        $html = file_get_contents('test.html');
        $selector = 'span.test_class';
        $content  = 'Test Class Text';

        DOMAssert::assertSelectEquals($selector, $content, true, $html);
    }
}

License

The PHPUnit DOM assertions library is licensed under the BSD 3-Clause license.