How to write tests for Filament admin panels by Leandro C. Ferreira - Blog

Example

Introduction

For the purpose of this article, we will create a simple Post Resource to create, read, update and delete post posts. We will:

Write a test
Run the test — which will fail
Make changes to code to make the test pass(refactor)
Repeat

Installation

To get started with the Filament, you can install a new Laravel project called filament-tdd-example:

laravel new filament-tdd-example

Now you can install Filament using the command:

cd filament-tdd-example
composer require filament/filament:"^2.0"

Filament recommends adding this to your composer.json's post-update-cmd:

"post-update-cmd": [
    // ...
    "@php artisan filament:upgrade"
]

All examples in this article will be written using Pest. You can install Pest using the comand:

composer require pestphp/pest-plugin-laravel --dev
php artisan pest:install

Edit the User Migration File:

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('email')->unique();
    $table->boolean('is_admin')->default(0);
    $table->timestamp('email_verified_at')->nullable();
    $table->string('password');
    $table->rememberToken();
    $table->timestamps();
});

You can add the new columns to your User Model:

//app\Models\User.php
protected $fillable = [
    'name',
    'email',
    'password',
    'is_admin'
];

Edit the User Factory definition method:

//database\factories\UserFactory.php
public function definition()
{
    return [
        'name' => fake()->name(),
        'email' => fake()->unique()->safeEmail(),
        'is_admin' => fake()->boolean(),
        'email_verified_at' => now(),
        'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // password
        'remember_token' => Str::random(10),
    ];
}

Create the Post Model (with migration and factory files):

php artisan make:model Post -m -f

Edit the Post Migration File:

Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->string('title');
    $table->text('content')->nullable();
    $table->timestamps();
});

Edit the Post Model:

//app\Models\Post.php
namespace App\Models;
 
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
 
class Post extends Model
{
    use HasFactory;
 
    protected $guarded = ['id'];
}

Edit the Post Factory definition method:

//database\factories\PostFactory.php
public function definition()
{
    return [
        'title' => fake()->sentence(4),
        'content' => fake()->text()
    ];
}

Edit the DatabaseSeeder run method:

//database\seeders\DatabaseSeeder.php
public function run()
{
    \App\Models\User::factory(10)->create();
    \App\Models\Post::factory(10)->create();
}

Run the migrate command:

php artisan migrate --seed

Test

Create and write the Post Test:

php artisan pest:test PostsTest

You may delete these files: tests\Unit\ExampleTest.php, tests\Feature\ExampleTest.php

The next thing we need to do is write our actual test:

use App\Models\Post;
use App\Models\User;
use Livewire\Livewire;
 
beforeEach(function () {
    $this->actingAs(
        User::where('is_admin', true)->first()
    );
});
 
it('has posts page', function () {
    Livewire::test()->assertCanSeeTableRecords(
        Post::limit(10)->get()
    );
});
 
it('can create posts', function () {
    Livewire::test()->assertPageActionExists('create');
});
 
it('can edit posts', function () {
    Livewire::test()->assertTableActionExists('edit');
});
 
it('can delete posts', function () {
    Livewire::test()->assertTableActionExists('delete');
});
 
it('cannot view posts', function () {
    $this->actingAs(
        User::where('is_admin', false)->first()
    );
 
    Livewire::test()->assertStatus(403);
});

Now we need to run our test:

./vendor/bin/pest

Example

Our test FAILED! Ok. What we will be doing in this step is to make our test pass.

Resources

You can create an User Resource and a Post Resource:

php artisan make:filament-resource User --simple
php artisan make:filament-resource Post --simple

Edit the User Resource form/table methods:

//app\Filament\Resources\UserResource.php
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Columns\ToggleColumn;
 
public static function form(Form $form): Form
{
    return $form
        ->schema([
 
            //name
            TextInput::make('name')
                ->required()
                ->maxLength(255),
 
            //email
            TextInput::make('email')
                ->email()
                ->required()
                ->maxLength(255),
 
            //is_admin
            Toggle::make('is_admin')
                ->inline(false)
                ->required(),
        ]);
}
 
public static function table(Table $table): Table
{
    return $table
        ->columns([
 
            //name
            TextColumn::make('name'),
 
            //email
            TextColumn::make('email'),
 
            //is_admin
            ToggleColumn::make('is_admin'),
 
            //created_at
            TextColumn::make('created_at')
                ->dateTime('d/m/y H:i'),
 
            //modified_at
            TextColumn::make('updated_at')
                ->dateTime('d/m/y H:i'),
        ])
        ->filters([
            //
        ])
        ->actions([
            Tables\Actions\EditAction::make(),
            Tables\Actions\DeleteAction::make(),
        ])
        ->bulkActions([
            Tables\Actions\DeleteBulkAction::make(),
        ]);
}

Edit the Post Resource form/table methods:

//app\Filament\Resources\PostResource.php
 
use Filament\Forms\Components\RichEditor;
use Filament\Forms\Components\TextInput;
use Filament\Tables\Columns\TextColumn;
 
public static function form(Form $form): Form
{
    return $form
        ->schema([
 
            //title
            TextInput::make('title')
                ->required()
                ->maxLength(255)
                ->columnSpan(2),
 
            //content
            RichEditor::make('content')
                ->maxLength(65535)
                ->columnSpan(2),
        ]);
}
 
public static function table(Table $table): Table
{
    return $table
        ->columns([
 
            //title
            TextColumn::make('title'),
 
            //content
            TextColumn::make('content')
                ->limit(30),
 
            //created_at
            TextColumn::make('created_at')
                ->dateTime('d/m/y H:i'),
 
            //updated_at
            TextColumn::make('updated_at')
                ->dateTime('d/m/y H:i'),
        ])
        ->filters([
            //
        ])
        ->actions([
            Tables\Actions\EditAction::make(),
            Tables\Actions\DeleteAction::make(),
        ])
        ->bulkActions([
            Tables\Actions\DeleteBulkAction::make(),
        ]);
}

Now we can pass to the Livewire test method the ManagePosts class as an argument:

use App\Filament\Resources\PostResource\Pages\ManagePosts;
use App\Models\Post;
use App\Models\User;
use Livewire\Livewire;
 
beforeEach(function () {
    $this->actingAs(
        User::where('is_admin', true)->first()
    );
});
 
it('has posts page', function () {
    Livewire::test(ManagePosts::class)->assertCanSeeTableRecords(
        Post::limit(10)->get()
    );
});
 
it('can create posts', function () {
    Livewire::test(ManagePosts::class)->assertPageActionExists('create');
});
 
it('can edit posts', function () {
    Livewire::test(ManagePosts::class)->assertTableActionExists('edit');
});
 
it('can delete posts', function () {
    Livewire::test(ManagePosts::class)->assertTableActionExists('delete');
});
 
it('cannot view posts', function () {
    $this->actingAs(
        User::where('is_admin', false)->first()
    );
 
    Livewire::test(ManagePosts::class)->assertStatus(403);
});

Now we need to run our test again:

./vendor/bin/pest

Example

Our test Failed again but this time it says that it cannot assert that 403 is identical to 200. It's because only admin users can manage posts. You may create a policy to control this behavior.

Policy

Create the Post Policy File:

php artisan make:policy PostPolicy --model=Post

Edit all methods to return $user->is_admin:

public function viewAny(User $user)
{
    return $user->is_admin;
}
 
public function view(User $user, Post $post)
{
    return $user->is_admin;
}
...

Once that is done, we will re-run our test.

./vendor/bin/pest

Example

WELL DONE! You have made the test pass.

You can download this project on GitHub: leandrocfe/filament-tdd-example

Otávio Araújo

1 year ago

Could you post an example on how to test a record creation?

Leandro C. Ferreira

https://filamentphp.com/docs/2.x/forms/testing#validation

use function Pest\Livewire\livewire;
 
livewire(CreatePost::class)
    ->fillForm([
        'title' => fake()->sentence(),
        // ...
    ])
    ->call('save')
    ->assertHasNoFormErrors();

Thank you very much!

👍 1

Cyril

But with "--simple" option, we don't have "CreatePost::class"

I tried with "ManagePost::class" but I got:

Unable to set component data. Public property [$name] not found on component

Arber Mustafa

You can try something like this

use App\Models\Post;
use Filament\Tables\Actions\DeleteAction;
use Filament\Tables\Actions\EditAction;
 
use function Pest\Livewire\livewire;
 
it('can create post', function (): void {
    $post = Post::factory()->make();
 
    livewire(ManagePosts::class)
        ->callPageAction('create', data: [
                            'title' => $post->title,
                            'content' => $post->content,
        ])
        ->assertHasNoPageActionErrors();
 
    $this->assertDatabaseHas(Post::class, [
                    'title' => $post->title,
                    'content' => $post->content,
    ]);
});
 
it('can edit post', function (): void {
    $post = Post::factory()->create();
    $newData = Post::factory()->make();
 
    livewire(ManagePosts::class)
                ->callTableAction(EditAction::class, $post, data: [
                        'title' => $newData->title,
                        'content' => $newData->content,
        ])
        ->assertHasNoTableActionErrors();
 
    expect($post->refresh())
        ->title->toBe($newData->title)
        ->content->toBe($newData->content);
});
 
it('can delete post', function (): void {
    $post = Post::factory()->create();
 
    livewire(ManagePosts::class)
        ->callTableAction(DeleteAction::class, $post);
 
    $this->assertModelMissing($post);
});

Introduction

Installation

Test

Resources

Policy

Other articles

The Filament Wire: Issue 2

The Filament Wire: Issue 1

Generate QR Code as a Filament Field and OnBoard Users Scanning it

#Introduction

#Installation

#Test

#Resources

#Policy

Other articles

The Filament Wire: Issue 2

The Filament Wire: Issue 1

Generate QR Code as a Filament Field and OnBoard Users Scanning it

Introduction

Installation

Test

Resources

Policy