feat: adds toHaveText

Author: nunomaduro

playground/composer.json

@@ -21,8 +21,9 @@
         "laravel/sail": "^1.26",
         "mockery/mockery": "^1.6",
         "nunomaduro/collision": "^8.1",
-        "pestphp/pest": "^3.7",
-        "pestphp/pest-plugin-laravel": "^3.1"
+        "pestphp/pest": "^4.0",
+        "pestphp/pest-plugin-browser": "^4.0",
+        "pestphp/pest-plugin-laravel": "^4.0"
     },
     "autoload": {
         "psr-4": {
@@ -73,6 +74,6 @@
             "php-http/discovery": true
         }
     },
-    "minimum-stability": "stable",
+    "minimum-stability": "dev",
     "prefer-stable": true
 }

playground/composer.lock

@@ -22,8 +22,8 @@
         <env name="APP_MAINTENANCE_DRIVER" value="file"/>
         <env name="BCRYPT_ROUNDS" value="4"/>
         <env name="CACHE_STORE" value="array"/>
-        <!-- <env name="DB_CONNECTION" value="sqlite"/> -->
-        <!-- <env name="DB_DATABASE" value=":memory:"/> -->
+        <env name="DB_CONNECTION" value="sqlite"/>
+        <env name="DB_DATABASE" value=":memory:"/>
         <env name="MAIL_MAILER" value="array"/>
         <env name="PULSE_ENABLED" value="false"/>
         <env name="QUEUE_CONNECTION" value="sync"/>

playground/phpunit.xml

@@ -0,0 +1,7 @@
+@extends('layouts.app')
+
+@section('content')
+    <h1>
+        Nunonation Database
+    </h1>
+@endsection

playground/resources/views/database.blade.php

@@ -11,3 +11,7 @@
 Route::get('/test/{page}', function ($page) {
     return view('test-pages.'.$page);
 })->name('test-page');
+
+Route::get('/database', function () {
+    return view('database');
+})->name('database');

playground/routes/web.php

@@ -3,7 +3,7 @@
 declare(strict_types=1);
 
 it('returns a successful response', function () {
-    $response = $this->get('/');
+    $page = page()->goto(route('database'));
 
-    $response->assertStatus(200);
+    expect($page->locator('h1'))->toHaveText()('Nunonation Database');
 });

playground/tests/Feature/ExampleTest.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+it('may have a title', function (): void {
+    $page = page()->goto('/');
+
+    $locator = $page->locator('h3');
+
+    expect($locator)->toHaveText('Pest is a testing');
+});
+
+it('may not have a title', function (): void {
+    $page = page()->goto('/');
+
+    $locator = $page->locator('h3');
+
+    expect($locator)->not->toHaveText('PhpUnit is a testing framework');
+});

tests/Browser/Expectations/ToHaveTextTest.php

@@ -18,6 +18,16 @@
     return $this;
 });
 
+expect()->extend('toHaveText', function (string $content): Expectation {
+    if (! $this->value instanceof Locator) {
+        throw new InvalidArgumentException('Expected value to be an Locator instance');
+    }
+
+    expect($this->value->textContent())->toContain($content);
+
+    return $this;
+});
+
 expect()->extend('toBeChecked', function (): Expectation {
     if (! $this->value instanceof Locator) {
         throw new InvalidArgumentException('Expected value to be a Locator instance');
@@ -61,7 +71,7 @@
 });
 
 expect()->extend('toBeEditable', function (): Expectation
-
+{
     if (! $this->value instanceof Locator) {
         throw new InvalidArgumentException('Expected value to be a Locator instance');
     }