1cdbaaaacc
- Introduced `testing-schemas.md` with detailed instructions on filling forms, asserting schema states, validating forms, and testing visibility and existence of form fields and components. - Added `testing-tables.md` covering table rendering, column testing, searching, sorting, filtering, and summarizing, along with visibility and existence checks for filters and columns.
478 lines
15 KiB
Markdown
478 lines
15 KiB
Markdown
# Testing Tables
|
|
|
|
## Testing that a Table Can Render
|
|
|
|
To ensure a table component renders, use the `assertSuccessful()` Livewire helper:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can render page', function () {
|
|
livewire(ListPosts::class)
|
|
->assertSuccessful();
|
|
});
|
|
```
|
|
|
|
To test which records are shown, you can use `assertCanSeeTableRecords()`, `assertCanNotSeeTableRecords()` and `assertCountTableRecords()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('cannot display trashed posts by default', function () {
|
|
$posts = Post::factory()->count(4)->create();
|
|
$trashedPosts = Post::factory()->trashed()->count(6)->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertCanSeeTableRecords($posts)
|
|
->assertCanNotSeeTableRecords($trashedPosts)
|
|
->assertCountTableRecords(4);
|
|
});
|
|
```
|
|
|
|
If your table uses pagination, `assertCanSeeTableRecords()` will only check for records on the first page. To switch page, call `call('gotoPage', 2)`.
|
|
|
|
If your table uses `deferLoading()`, you should call `loadTable()` before `assertCanSeeTableRecords()`.
|
|
|
|
## Testing Columns
|
|
|
|
To ensure that a certain column is rendered, pass the column name to `assertCanRenderTableColumn()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can render post titles', function () {
|
|
Post::factory()->count(10)->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertCanRenderTableColumn('title');
|
|
});
|
|
```
|
|
|
|
This helper will get the HTML for this column, and check that it is present in the table.
|
|
|
|
For testing that a column is not rendered, you can use `assertCanNotRenderTableColumn()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can not render post comments', function () {
|
|
Post::factory()->count(10)->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertCanNotRenderTableColumn('comments');
|
|
});
|
|
```
|
|
|
|
This helper will assert that the HTML for this column is not shown by default in the present table.
|
|
|
|
## Testing that a Column Can Be Searched
|
|
|
|
To search the table, call the `searchTable()` method with your search query.
|
|
|
|
You can then use `assertCanSeeTableRecords()` to check your filtered table records, and use `assertCanNotSeeTableRecords()` to assert that some records are no longer in the table:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can search posts by title', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
$title = $posts->first()->title;
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->searchTable($title)
|
|
->assertCanSeeTableRecords($posts->where('title', $title))
|
|
->assertCanNotSeeTableRecords($posts->where('title', '!=', $title));
|
|
});
|
|
```
|
|
|
|
To search individual columns, you can pass an array of searches to `searchTableColumns()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can search posts by title column', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
$title = $posts->first()->title;
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->searchTableColumns(['title' => $title])
|
|
->assertCanSeeTableRecords($posts->where('title', $title))
|
|
->assertCanNotSeeTableRecords($posts->where('title', '!=', $title));
|
|
});
|
|
```
|
|
|
|
## Testing that a Column Can Be Sorted
|
|
|
|
To sort table records, you can call `sortTable()`, passing the name of the column to sort by. You can use `'desc'` in the second parameter of `sortTable()` to reverse the sorting direction.
|
|
|
|
Once the table is sorted, you can ensure that the table records are rendered in order using `assertCanSeeTableRecords()` with the `inOrder` parameter:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can sort posts by title', function () {
|
|
Post::factory()->count(10)->create();
|
|
|
|
$sortedPostsAsc = Post::query()->orderBy('title')->get();
|
|
$sortedPostsDesc = Post::query()->orderBy('title', 'desc')->get();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->sortTable('title')
|
|
->assertCanSeeTableRecords($sortedPostsAsc, inOrder: true)
|
|
->sortTable('title', 'desc')
|
|
->assertCanSeeTableRecords($sortedPostsDesc, inOrder: true);
|
|
});
|
|
```
|
|
|
|
Filament tables use a SQL order statement to sort records before they are output. Different database drivers can use different sorting strategies, and they can differ from PHP's own sorting strategy, so you should ensure that test records are sorted using `orderBy()` on a database query rather than `sortBy()` on a collection of models.
|
|
|
|
## Testing the State of a Column
|
|
|
|
To assert that a certain column has a state or does not have a state for a record you can use `assertTableColumnStateSet()` and `assertTableColumnStateNotSet()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can get post author names', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
$post = $posts->first();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertTableColumnStateSet('author.name', $post->author->name, record: $post)
|
|
->assertTableColumnStateNotSet('author.name', 'Anonymous', record: $post);
|
|
});
|
|
```
|
|
|
|
To assert that a certain column has a formatted state or does not have a formatted state for a record you can use `assertTableColumnFormattedStateSet()` and `assertTableColumnFormattedStateNotSet()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can get post author names', function () {
|
|
$post = Post::factory(['name' => 'John Smith'])->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertTableColumnFormattedStateSet('author.name', 'Smith, John', record: $post)
|
|
->assertTableColumnFormattedStateNotSet('author.name', $post->author->name, record: $post);
|
|
});
|
|
```
|
|
|
|
## Testing the Existence of a Column
|
|
|
|
To ensure that a column exists, you can use the `assertTableColumnExists()` method:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('has an author column', function () {
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertTableColumnExists('author');
|
|
});
|
|
```
|
|
|
|
You may pass a function as an additional argument to assert that a column passes a given "truth test". This is useful for asserting that a column has a specific configuration. You can also pass in a record as the third parameter, which is useful if your check is dependent on which table row is being rendered:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
use Filament\Tables\Columns\TextColumn;
|
|
|
|
it('has an author column', function () {
|
|
$post = Post::factory()->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertTableColumnExists('author', function (TextColumn $column): bool {
|
|
return $column->getDescriptionBelow() === $post->subtitle;
|
|
}, $post);
|
|
});
|
|
```
|
|
|
|
## Testing the Visibility of a Column
|
|
|
|
To ensure that a particular user cannot see a column, you can use the `assertTableColumnVisible()` and `assertTableColumnHidden()` methods:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('shows the correct columns', function () {
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertTableColumnVisible('created_at')
|
|
->assertTableColumnHidden('author');
|
|
});
|
|
```
|
|
|
|
## Testing the Description of a Column
|
|
|
|
To ensure a column has the correct description above or below you can use the `assertTableColumnHasDescription()` and `assertTableColumnDoesNotHaveDescription()` methods:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('has the correct descriptions above and below author', function () {
|
|
$post = Post::factory()->create();
|
|
|
|
livewire(PostsTable::class)
|
|
->assertTableColumnHasDescription('author', 'Author! ↓↓↓', $post, 'above')
|
|
->assertTableColumnHasDescription('author', 'Author! ↑↑↑', $post)
|
|
->assertTableColumnDoesNotHaveDescription('author', 'Author! ↑↑↑', $post, 'above')
|
|
->assertTableColumnDoesNotHaveDescription('author', 'Author! ↓↓↓', $post);
|
|
});
|
|
```
|
|
|
|
## Testing the Extra Attributes of a Column
|
|
|
|
To ensure that a column has the correct extra attributes, you can use the `assertTableColumnHasExtraAttributes()` and `assertTableColumnDoesNotHaveExtraAttributes()` methods:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('displays author in red', function () {
|
|
$post = Post::factory()->create();
|
|
|
|
livewire(PostsTable::class)
|
|
->assertTableColumnHasExtraAttributes('author', ['class' => 'text-danger-500'], $post)
|
|
->assertTableColumnDoesNotHaveExtraAttributes('author', ['class' => 'text-primary-500'], $post);
|
|
});
|
|
```
|
|
|
|
## Testing the Options in a SelectColumn
|
|
|
|
If you have a select column, you can ensure it has the correct options with `assertTableSelectColumnHasOptions()` and `assertTableSelectColumnDoesNotHaveOptions()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('has the correct statuses', function () {
|
|
$post = Post::factory()->create();
|
|
|
|
livewire(PostsTable::class)
|
|
->assertTableSelectColumnHasOptions('status', ['unpublished' => 'Unpublished', 'published' => 'Published'], $post)
|
|
->assertTableSelectColumnDoesNotHaveOptions('status', ['archived' => 'Archived'], $post);
|
|
});
|
|
```
|
|
|
|
## Testing Filters
|
|
|
|
To filter the table records, you can use the `filterTable()` method, along with `assertCanSeeTableRecords()` and `assertCanNotSeeTableRecords()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can filter posts by `is_published`', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertCanSeeTableRecords($posts)
|
|
->filterTable('is_published')
|
|
->assertCanSeeTableRecords($posts->where('is_published', true))
|
|
->assertCanNotSeeTableRecords($posts->where('is_published', false));
|
|
});
|
|
```
|
|
|
|
For a simple filter, this will just enable the filter.
|
|
|
|
If you'd like to set the value of a `SelectFilter` or `TernaryFilter`, pass the value as a second argument:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can filter posts by `author_id`', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
$authorId = $posts->first()->author_id;
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertCanSeeTableRecords($posts)
|
|
->filterTable('author_id', $authorId)
|
|
->assertCanSeeTableRecords($posts->where('author_id', $authorId))
|
|
->assertCanNotSeeTableRecords($posts->where('author_id', '!=', $authorId));
|
|
});
|
|
```
|
|
|
|
## Resetting Filters in a Test
|
|
|
|
To reset all filters to their original state, call `resetTableFilters()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can reset table filters', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->resetTableFilters();
|
|
});
|
|
```
|
|
|
|
## Removing Filters in a Test
|
|
|
|
To remove a single filter you can use `removeTableFilter()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('filters list by published', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
$unpublishedPosts = $posts->where('is_published', false)->get();
|
|
|
|
livewire(PostsTable::class)
|
|
->filterTable('is_published')
|
|
->assertCanNotSeeTableRecords($unpublishedPosts)
|
|
->removeTableFilter('is_published')
|
|
->assertCanSeeTableRecords($posts);
|
|
});
|
|
```
|
|
|
|
To remove all filters you can use `removeTableFilters()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can remove all table filters', function () {
|
|
$posts = Post::factory()->count(10)->forAuthor()->create();
|
|
|
|
$unpublishedPosts = $posts
|
|
->where('is_published', false)
|
|
->where('author_id', $posts->first()->author->getKey());
|
|
|
|
livewire(PostsTable::class)
|
|
->filterTable('is_published')
|
|
->filterTable('author', $author)
|
|
->assertCanNotSeeTableRecords($unpublishedPosts)
|
|
->removeTableFilters()
|
|
->assertCanSeeTableRecords($posts);
|
|
});
|
|
```
|
|
|
|
## Testing the Visibility of a Filter
|
|
|
|
To ensure that a particular user cannot see a filter, you can use the `assertTableFilterVisible()` and `assertTableFilterHidden()` methods:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('shows the correct filters', function () {
|
|
livewire(PostsTable::class)
|
|
->assertTableFilterVisible('created_at')
|
|
->assertTableFilterHidden('author');
|
|
});
|
|
```
|
|
|
|
## Testing the Existence of a Filter
|
|
|
|
To ensure that a filter exists, you can use the `assertTableFilterExists()` method:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('has an author filter', function () {
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertTableFilterExists('author');
|
|
});
|
|
```
|
|
|
|
You may pass a function as an additional argument to assert that a filter passes a given "truth test". This is useful for asserting that a filter has a specific configuration:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
use Filament\Tables\Filters\SelectFilter;
|
|
|
|
it('has an author filter', function () {
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertTableFilterExists('author', function (SelectFilter $column): bool {
|
|
return $column->getLabel() === 'Select author';
|
|
});
|
|
});
|
|
```
|
|
|
|
## Testing Summaries
|
|
|
|
To test that a summary calculation is working, you may use the `assertTableColumnSummarySet()` method:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can average values in a column', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertCanSeeTableRecords($posts)
|
|
->assertTableColumnSummarySet('rating', 'average', $posts->avg('rating'));
|
|
});
|
|
```
|
|
|
|
The first argument is the column name, the second is the summarizer ID, and the third is the expected value.
|
|
|
|
Note that the expected and actual values are normalized, such that 123.12 is considered the same as "123.12", and ['Fred', 'Jim'] is the same as ['Jim', 'Fred'].
|
|
|
|
You may set a summarizer ID by passing it to the `make()` method:
|
|
|
|
```php
|
|
use Filament\Tables\Columns\Summarizers\Average;
|
|
use Filament\Tables\Columns\TextColumn;
|
|
|
|
TextColumn::make('rating')
|
|
->summarize(Average::make('average'));
|
|
```
|
|
|
|
The ID should be unique between summarizers in that column.
|
|
|
|
## Testing Summaries on Only One Pagination Page
|
|
|
|
To calculate the average for only one pagination page, use the `isCurrentPaginationPageOnly` argument:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can average values in a column', function () {
|
|
$posts = Post::factory()->count(20)->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertCanSeeTableRecords($posts->take(10))
|
|
->assertTableColumnSummarySet('rating', 'average', $posts->take(10)->avg('rating'), isCurrentPaginationPageOnly: true);
|
|
});
|
|
```
|
|
|
|
## Testing a Range Summarizer
|
|
|
|
To test a range, pass the minimum and maximum value into a tuple-style [$minimum, $maximum] array:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can average values in a column', function () {
|
|
$posts = Post::factory()->count(10)->create();
|
|
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->assertCanSeeTableRecords($posts)
|
|
->assertTableColumnSummarySet('rating', 'range', [$posts->min('rating'), $posts->max('rating')]);
|
|
});
|
|
```
|
|
|
|
## Testing Toggleable Columns
|
|
|
|
By default, only columns that are toggled on by default in the table will be rendered and testable. You can toggle all columns in the table on using `toggleAllTableColumns()`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can toggle all columns', function () {
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->toggleAllTableColumns();
|
|
});
|
|
```
|
|
|
|
You can also toggle all columns off using `toggleAllTableColumns(false)`:
|
|
|
|
```php
|
|
use function Pest\Livewire\livewire;
|
|
|
|
it('can toggle all columns off', function () {
|
|
livewire(PostResource\Pages\ListPosts::class)
|
|
->toggleAllTableColumns(false);
|
|
});
|
|
```
|