[12.x] - add dispatchedOnce methods (#56494)

lioneaglesolutions · web-flow · commit b4021b40c864 · 2025-08-04T15:16:54.000-05:00
* add methods

* adjust
diff --git a/src/Illuminate/Support/Testing/Fakes/BusFake.php b/src/Illuminate/Support/Testing/Fakes/BusFake.php
@@ -132,6 +132,18 @@ public function assertDispatched($command, $callback = null)
         );
     }
 
+    /**
+     * Assert if a job was pushed exactly once.
+     *
+     * @param  string|\Closure  $command
+     * @param  int  $times
+     * @return void
+     */
+    public function assertDispatchedOnce($command)
+    {
+        $this->assertDispatchedTimes($command, 1);
+    }
+
     /**
      * Assert if a job was pushed a number of times.
      *
diff --git a/src/Illuminate/Support/Testing/Fakes/EventFake.php b/src/Illuminate/Support/Testing/Fakes/EventFake.php
@@ -147,6 +147,18 @@ public function assertDispatched($event, $callback = null)
         );
     }
 
+    /**
+     * Assert if an event was dispatched exactly once.
+     *
+     * @param  string  $event
+     * @param  int  $times
+     * @return void
+     */
+    public function assertDispatchedOnce($event)
+    {
+        $this->assertDispatchedTimes($event, 1);
+    }
+
     /**
      * Assert if an event was dispatched a number of times.
      *
diff --git a/tests/Support/SupportTestingBusFakeTest.php b/tests/Support/SupportTestingBusFakeTest.php
@@ -275,6 +275,21 @@ public function testAssertDispatchedSyncWithCallbackFunction()
         });
     }
 
+    public function testAssertDispatchedOnce()
+    {
+        $this->fake->dispatch(new BusJobStub);
+        $this->fake->dispatchNow(new BusJobStub);
+
+        try {
+            $this->fake->assertDispatchedOnce(BusJobStub::class);
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString('The expected [Illuminate\Tests\Support\BusJobStub] job was pushed 2 times instead of 1 times.', $e->getMessage());
+        }
+
+        $this->fake->assertDispatchedTimes(BusJobStub::class, 2);
+    }
+
     public function testAssertDispatchedTimes()
     {
         $this->fake->dispatch(new BusJobStub);
diff --git a/tests/Support/SupportTestingEventFakeTest.php b/tests/Support/SupportTestingEventFakeTest.php
@@ -76,6 +76,21 @@ public function testAssertDispatchedWithCallbackInt()
         $this->fake->assertDispatched(EventStub::class, 2);
     }
 
+    public function testAssertDispatchedOnce()
+    {
+        $this->fake->dispatch(EventStub::class);
+        $this->fake->dispatch(EventStub::class);
+
+        try {
+            $this->fake->assertDispatchedOnce(EventStub::class);
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString('The expected [Illuminate\Tests\Support\EventStub] event was dispatched 2 times instead of 1 times.', $e->getMessage());
+        }
+
+        $this->fake->assertDispatchedTimes(EventStub::class, 2);
+    }
+
     public function testAssertDispatchedTimes()
     {
         $this->fake->dispatch(EventStub::class);
