AssertSelectorContains for Laravel

Features

Laravel's built-in assertSee is useful, but has some limitations:

• It makes a string match against the whole document, and could produce false positives.
• It is hard to assert if specific items have been correctly set (page titles, input labels, etc)
• When the assertion fails, it outputs the whole HTML document to the console.

This package provides a collection of additional assertions available on Laravel's TestResponse to help target specific elements/attributes and improve message on failure.

assertSelectorExists($selector)
assertSelectorDoesNotExist($selector)
assertSelectorContains($selector, $value)
assertSelectorDoesNotContain($selector, $value)
assertSelectorAttributeExists($selector, $attribute)
assertSelectorAttributeDoesNotExist($selector, $attribute)
assertSelectorAttributeEquals($selector, $attribute, $value)
assertSelectorAttributeDoesNotEqual($selector, $attribute, $value)

So, if you want to make sure that you are correctly setting the document title:

$response->assertSelectorContains('title', 'Welcome');

If you want to assert that a label has been set for a specific form input:

$response->assertSelectorExists('label[for=input-id]');

Or if a specific input has been set with the correct initial value:

$response->assertSelectorAttributeEquals('input[name=display_name]', 'value', 'SavvyWombat');

Usage

Usage

Use the AssertsWithSelectors trait in your TestCase:

namespace Tests\Feature;

use SavvyWombat\LaravelAssertSelectorContains\AssertsWithSelectors;
use Tests\TestCase;

class ExampleTest extends TestCase
{
  use AssertsWithSelectors;

  public function testDocumentTitleIsCorrect(): void
  {
    $response = $this->get('/');

    $response->assertSelectorContains('title', 'Welcome');
  }
}

Credit

This package was inspired by a blog post from Liam Hammett:

Laravel Testing CSS Selector Assertion Macros