[10.x] Provide testing hooks

src/Illuminate/Support/Sleep.php

@@ -13,6 +13,13 @@ class Sleep
 {
     use Macroable;
 
+    /**
+     * The fake sleep callbacks.
+     *
+     * @var array
+     */
+    public static $fakeSleepCallbacks = [];
+
     /**
      * The total duration to sleep.
      *
@@ -252,6 +259,10 @@ public function __destruct()
         if (static::$fake) {
             static::$sequence[] = $this->duration;
 
+            foreach (static::$fakeSleepCallbacks as $callback) {
+                $callback($this->duration);
+            }
+
             return;
         }
 
@@ -305,6 +316,7 @@ public static function fake($value = true)
         static::$fake = $value;
 
         static::$sequence = [];
+        static::$fakeSleepCallbacks = [];
     }
 
     /**
@@ -435,4 +447,15 @@ public function unless($condition)
     {
         return $this->when(! value($condition, $this));
     }
+
+    /**
+     * Specify a callback that should be invoked when faking sleep within a test.
+     *
+     * @param  callable  $callback
+     * @return void
+     */
+    public static function whenFakingSleep($callback)
+    {
+        static::$fakeSleepCallbacks[] = $callback;
+    }
 }

tests/Support/SleepTest.php

@@ -3,6 +3,7 @@
 namespace Illuminate\Tests\Support;
 
 use Carbon\CarbonInterval;
+use Exception;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Sleep;
 use PHPUnit\Framework\AssertionFailedError;
@@ -501,4 +502,39 @@ public function testItCanSleepConditionallyWhen()
         Sleep::for(1)->second()->unless(fn () => false);
         Sleep::assertSlept(fn () => true, 4);
     }
+
+    public function testItCanRegisterCallbacksToRunInTests()
+    {
+        $countA = 0;
+        $countB = 0;
+        Sleep::fake();
+        Sleep::whenFakingSleep(function ($duration) use (&$countA) {
+            $countA += $duration->totalMilliseconds;
+        });
+        Sleep::whenFakingSleep(function ($duration) use (&$countB) {
+            $countB += $duration->totalMilliseconds;
+        });
+
+        Sleep::for(1)->millisecond();
+        Sleep::for(2)->millisecond();
+
+        Sleep::assertSequence([
+            Sleep::for(1)->millisecond(),
+            Sleep::for(2)->millisecond(),
+        ]);
+
+        $this->assertSame(3, $countA);
+        $this->assertSame(3, $countB);
+    }
+
+    public function testItDoesntRunCallbacksWhenNotFaking()
+    {
+        Sleep::whenFakingSleep(function () {
+            throw new Exception('Should not run without faking.');
+        });
+
+        Sleep::for(1)->millisecond();
+
+        $this->assertTrue(true);
+    }
 }