Assert Background Job Dispatching with Queue::fake() - Laravel

Use Queue::fake() to prevent jobs from executing during tests and verify that background tasks are dispatched with correct parameters.

When testing controller actions that dispatch background queue jobs, executing real jobs slows down tests and triggers unwanted external side effects.

Laravel's Queue::fake() intercepts job dispatching and provides rich test assertions.

Testing Job Dispatching

use App\Jobs\ProcessSubscriptionPaymentJob;
use Illuminate\Support\Facades\Queue;

test('checkout dispatches payment job with correct amount', function () {
    Queue::fake();

    $response = $this->post('/checkout', [
        'plan_id' => 'pro_monthly',
    ]);

    $response->assertOk();

    // Assert that the job was dispatched to the queue
    Queue::assertPushed(ProcessSubscriptionPaymentJob::class, function ($job) {
        return $job->planId === 'pro_monthly';
    });

    // Assert that no other unexpected jobs were pushed
    Queue::assertPushed(ProcessSubscriptionPaymentJob::class, 1);
});

Asserting Jobs Were Not Dispatched

// Assert that a job was never dispatched under error conditions
Queue::assertNotPushed(ProcessSubscriptionPaymentJob::class);

Summary

Prevents background workers from running during test execution.
Inspects dispatched job parameters using closure assertions.
Provides assertions: assertPushed(), assertNotPushed(), assertPushedOn().

Tags: Laravel Testing Queue Clean Code

Share on X

Related Tips

View all tips →

Laravel Testing

Fake Events Selectively with Event::fakeExcept()

Use Event::fakeExcept() to mock all application events while allowing specific mission-critical event listeners to run during tests.

Feb 25, 2026 • 1 min read READ >

Laravel Testing

Enforce Specific Fake Data Constraints with Faker's valid() Modifier

Use Faker's valid() modifier in seeders and factories to generate values that strictly satisfy custom validation closures.

Dec 25, 2024 • 1 min read READ >