Laravel Tutorials

Feature Tests powered by database seeders

Published
Feature Tests powered by database seeders image

At Laracon AU in 2018, David Hemphill gave a talk titled "Abusing Laravel for Fun and Profit" and one section of the talk I found interesting was on feature tests powered by database seeders:

David goes through some common ways to set up your data before testing, such as using a setUp method, a trait, and then he came around to using custom seeders in his tests.

One advantage to seeders is you can create them for specific cases and call $this->seed directly from your test instead of using factories all over. Like this example:

class WebhookTest extends TestCase {
function setUp() {
$this-›seed( 'UserwithTeamSeeder');
$this-›user = User :: first);
$this-›team = Team:: first() ;
}
function test_a_user_can_create_a_webhook() {
// Act
//

Another advantage is that you can have isolated seeds to match specific scenarios. David gives the examples of:

  • UserWithValidApiKey
  • TeamWithExpiredBillingPlan
  • OrganizationOverUsageLimit
  • CreatorHasntFinishedSetup
  • CustomerWithNovaLicense

This allows you to make them specific for complex test setups and is great for testing complex edge cases.

One final tip he mentions is you don't even have to keep these with your other seeders. In your composer.json, you can autoload these from somewhere else, like your tests directory:

"autoload-dev": {
"psr-4": {
"Tests\\": "tests/",
"Tests\\Seeders\\": "tests/seeders"
}
},

Of course, like all things programming, this is just one way of doing tests with data. I've heard of others creating entire seeds with all the edge cases and lots of almost real-world data. Then only refreshing the db if they add a new migration.

If you are tired of writing lots of factories directly in your tests give this idea a try. You might like it.

Eric L. Barnes photo

Eric is the creator of Laravel News and has been covering Laravel since 2012.

Sponsored

masteringlaravel logo
Laravel Code Review

Get expert guidance in a few days with a Laravel code review

Visit Laravel Code Review

The latest

View all →
Bifrost Turns One With AI Builds and New Workflows image

Bifrost Turns One With AI Builds and New Workflows

Read article
Preview Blade Templates in macOS Finder with Quick Blade image

Preview Blade Templates in macOS Finder with Quick Blade

Read article
Artisan Debugging Commands in Laravel Telescope 5.24.0 image

Artisan Debugging Commands in Laravel Telescope 5.24.0

Read article
Queue totalSize() and JobInterrupted Event in Laravel 13.31 image

Queue totalSize() and JobInterrupted Event in Laravel 13.31

Read article
Find Unexpected Test Inputs with Fuzz for Pest image

Find Unexpected Test Inputs with Fuzz for Pest

Read article
Laravel Rulebook: Business Rules That Change by Date image

Laravel Rulebook: Business Rules That Change by Date

Read article