Custom Fakes

[epixian]

When using a fake facade in a test, in certain instances the underlying logic may not be equivalent to your main application logic for the real thing. For instance, there could be notification handler logic containing additional checks whether to send a notification or not (e.g. user opt out). In this case it would be useful to be able to pass in and use a different fake other than the default.

// src/Illuminate/Support/Facades/NotificationFake.php

/**
 * Replace the bound instance with a fake.
 *
 * @param  \Illuminate\Support\Testing\Fakes\NotificationFake|null  $fake
 * @return \Illuminate\Support\Testing\Fakes\NotificationFake
 */
public static function fake($fake = null)
{
     $fake ??= new NotificationFake;

     static::swap($fake);

     return $fake;
}

For example,

namespace Tests\Support;

use Illuminate\Support\Testing\Fakes\NotificationFake;

class MyNotificationFake extends NotificationFake
{
    //
}

and call it with

use \Tests\Support\MyNotificationFake;

Notification::fake(new MyNotificationFake);