Začínáme

Testování

Tři úrovně testu — čistý objekt, Livewire komponenta a vykreslená stránka — a která selhání každá z nich chytí.

Na této stránce

Testování formulářů samostatně
Testování formulářů v Livewire
Testování tabulek v Livewire
Unit test vlastního pole
Testování pluginů
Testování průvodce
Spuštění sady
Viz také

Komponenty Wire jsou prosté PHP objekty, které se vykreslují do HTML, takže se snadno testují. Existují tři užitečné úrovně:

Úroveň	Použití pro	Potřebuje Livewire?
Samostatné	Validační pravidla, save logika, konfigurace	Ne
Livewire	Vazba stavu, akce, chyby, celý cyklus requestu	Ano
Unit	API a vykreslený výstup jednoho pole/sloupce	Ne

Balíčky jsou testovány pomocí Pest. Příklady níže používají Pest syntaxi, ale všechno funguje stejně v čistém PHPUnit.

Testování formulářů samostatně

Form funguje bez Livewire, což dělá z validace a save logiky nejrychlejší věc k testování. validate() vrací zvalidovaná data nebo vyhodí Illuminate\Validation\ValidationException.

use Illuminate\Validation\ValidationException;
use NyonCode\WireForms\Components\TextInput;
use NyonCode\WireForms\Forms\Form;
 
it('validates required fields', function () {
    $data = Form::make()
        ->schema([
            TextInput::make('name')->required(),
            TextInput::make('email')->rules(['email'])->required(),
        ])
        ->state(['name' => 'John', 'email' => 'john@example.com'])
        ->validate();
 
    expect($data)->toBe(['name' => 'John', 'email' => 'john@example.com']);
});
 
it('rejects a missing required field', function () {
    $form = Form::make()
        ->schema([TextInput::make('name')->required()])
        ->state(['name' => '']);
 
    expect(fn () => $form->validate())->toThrow(ValidationException::class);
});

Asertujte na posbíraná pravidla a stav bez spuštění validace:

$form = Form::make()
    ->statePath('data')
    ->schema([TextInput::make('name')->required()->maxLength(255)]);
 
expect($form->getValidationRules())->toHaveKey('data.name');

Otestujte save cestu proti databázi tím, že formuláři dáte model:

use App\Models\User;
 
it('creates a user on save', function () {
    Form::make()
        ->model(User::class)
        ->schema([
            TextInput::make('name')->required(),
            TextInput::make('email')->email()->required(),
        ])
        ->state(['name' => 'Jane', 'email' => 'jane@example.com'])
        ->save();
 
    expect(User::where('email', 'jane@example.com')->exists())->toBeTrue();
});

Pro test edit módu použijte model($instance) místo model(User::class) (save() volá update()) a isCreating() / isEditing() pro assert módu.

Testování formulářů v Livewire

Chcete-li protáhnout vazbu stavu, save akci a validační chyby tak, jak na ně narazí uživatel, mountněte hostitelskou komponentu pomocí Livewire::test(). Stav žije pod statePath formuláře, takže nastavujete a asertujete vnořené klíče jako data.name.

use Livewire\Livewire;
 
it('shows a validation error for a missing name', function () {
    Livewire::test(CreateUser::class)
        ->set('data.email', 'jane@example.com')
        ->call('save')
        ->assertHasErrors('data.name');
});
 
it('saves when the form is valid', function () {
    Livewire::test(CreateUser::class)
        ->set('data.name', 'Jane')
        ->set('data.email', 'jane@example.com')
        ->call('save')
        ->assertHasNoErrors()
        ->assertOk();
 
    expect(User::where('email', 'jane@example.com')->exists())->toBeTrue();
});

Hostitelská komponenta je jen Livewire komponenta používající WithForms:

use Livewire\Component;
use NyonCode\WireForms\Forms\Form;
use NyonCode\WireForms\Forms\WithForms;
 
class CreateUser extends Component
{
    use WithForms;
 
    public ?array $data = [];
 
    public function form(Form $form): Form
    {
        return $form->statePath('data')->model(User::class)->schema([ 
            TextInput::make('name')->required(),
            TextInput::make('email')->email()->required(),
        ]); 
    }
 
    public function save(): void
    {
        $this->form->save();
    }
 
    public function render(): string
    {
        return '<div>{{ $this->form }}</div>';
    }
}

Repeater a další field akce jsou Livewire volání, takže je testujte pomocí ->call():

Livewire::test(CreateUser::class)
    ->call('addRepeaterItem', 'data.contacts')
    ->assertCount('data.contacts', 1);

Testování tabulek v Livewire

Tabulka je Livewire komponenta používající WithTable. Její UI stav (hledání, filtry, řazení, stránkování) žije na syntetizované vlastnosti tableState, takže ji řídíte nastavováním vnořených cest jako tableState.search. Řádkové akce běží přes executeTableAction($recordKey, $actionName).

use Livewire\Livewire;
 
it('lists and searches records', function () {
    Invoice::factory()->create(['number' => 'INV-100']);
    Invoice::factory()->create(['number' => 'INV-200']);
 
    Livewire::test(InvoicesTable::class)
        ->assertOk()
        ->assertSee('INV-100')
        ->set('tableState.search', 'INV-100')
        ->assertSee('INV-100')
        ->assertDontSee('INV-200');
});
 
it('runs a row action', function () {
    $invoice = Invoice::factory()->create(['status' => 'draft']);
 
    Livewire::test(InvoicesTable::class)
        ->call('executeTableAction', (string) $invoice->getKey(), 'publish');
 
    expect($invoice->fresh()->status)->toBe('published');
});

Hromadné akce používají executeBulkAction($actionName) po výběru řádků a akce, které otevírají modal, jdou přes openActionModal() a pak submitActionModal(). Pokud assert neodpovídá, vypište komponentu pomocí ->dump() a zkontrolujte živý tableState.

Unit test vlastního pole

Když píšete vlastní pole, otestujte jeho API a vykreslený výstup přímo — Livewire není potřeba.

use App\Forms\Components\MoneyInput;
 
it('exposes its configuration and renders the currency', function () {
    $field = MoneyInput::make('price')->currency('EUR')->decimals(2);
 
    expect($field->getCurrency())->toBe('EUR')
        ->and($field->getStateType())->toBe('int')
        ->and((string) $field->toHtml())->toContain('EUR');
});

Stejný přístup funguje pro vlastní sloupce, filtry a akce: postavte objekt, zavolejte jeho settery a asertujte na jeho gettery nebo toHtml().

Testování pluginů

Instancujte PluginManager přímo pro test registrace, bootu a hooků. Kompletní vzor viz Core Pluginy → Testování pluginů.

use NyonCode\WireCore\Core\Plugin\PluginManager;
 
it('adds updated_by before save', function () {
    $manager = new PluginManager();
    $manager->register(new FormAuditPlugin());
 
    $payload = $manager->runHook('form.saving', ['data' => ['name' => 'Jane']]);
 
    expect($payload['data'])->toHaveKey('updated_by');
});

Testování průvodce

O tom, který průvodce se spustí, se rozhoduje na serveru, takže části, které stojí za testování, prohlížeč nepotřebují: že je zaregistrovaný, že si nárokuje obrazovku, kterou jste mysleli, a že člověka, který ho už viděl, nechá být. Co test na této úrovni nevidí, je prohlídka sama — jestli panel přistane vedle správného prvku, jestli se skrytý krok přeskočí, jestli ho Escape zavře. To je chování prohlížeče.

Registrace je dotaz do kontejneru a nejlevnější pojistka proti provideru, který se přestal bootovat:

use NyonCode\WireCore\Tours\Tours;
 
it('registers the onboarding tour', function () {
    expect(app(Tours::class)->has('getting-started'))->toBeTrue();
});

Jestli běží na dané obrazovce, je otázka na vykreslení stránky. Panel nese element hook tour-panel, což je veřejné API — v minor verzi se nepřejmenuje ani neodstraní — takže je bezpečné na něj asertovat:

it('walks a new user through the orders list', function () {
    $this->actingAs(User::factory()->create())
        ->get('/admin/orders')
        ->assertSee('data-wire="tour-panel"', false);
});

Druhý argument vypíná escapování; bez něj uvozovky v atributu neodpovídají. Průvodce, který si obrazovku nenárokuje, nevykreslí vůbec nic, takže negativní případ je tatáž asertace obráceně — a právě tím se přišpendlí omezení:

use NyonCode\WireCore\Tours\TourState;
 
it('leaves somebody who has already finished it alone', function () {
    $user = User::factory()->create();
 
    app(TourState::class)->acknowledge('getting-started', $user);   // co zaznamenává Dokončit a Přeskočit
 
    $this->actingAs($user)
        ->get('/admin/orders')
        ->assertDontSee('data-wire="tour-panel"', false);
});

TourState::replay() je totéž opačně a je to volání, které dělá váš vlastní spouštěč.

Dvě věci, na kterých zakopávají spíš testy než aplikace:

Úložiště je podle driveru. Průvodci mají ve výchozím stavu driver session a každý test dostane čistou session, takže potvrzení mezi testy neprotékají. Na database musí proběhnout migrace wire_preferences, jinak se potvrzení nezapíše nikam a průvodce se objevuje dál.
Průvodce potřebuje layout, který ho kreslí. Vykreslení stránky výše asertuje přes layout wire-admin. Test, který vykresluje komponentu samostatně, nemá PageChrome, a tedy ani panel — ať je průvodce omezený sebelíp.

Spuštění sady

composer test            # všechno
composer test:core
composer test:forms
composer test:table
composer test:sortable
 
# Cross-package runtime, stav, makra, pluginy
vendor/bin/pest --configuration phpunit.xml --testsuite "Integration"

Když měníte jeden balíček, spusťte nejdřív vlastnící balíček, pak navazující balíčky a Integration sadu, když se změnil stav, rendering, makra nebo zapojení pluginů.

Viz také

Rozšíření formulářů — stavba polí, která testujete
Životní cyklus ukládání — hooky, kterými save() prochází
Core Pluginy — testování hooků a pluginů
Tour — jak se průvodce rozhoduje, že poběží, a co si ukládá