[9.x] Add helper to dispatch fake job batches

src/Illuminate/Support/Facades/Bus.php

@@ -9,6 +9,7 @@
 /**
  * @method static \Illuminate\Bus\Batch|null findBatch(string $batchId)
  * @method static \Illuminate\Bus\PendingBatch batch(array|mixed $jobs)
+ * @method static \Illuminate\Bus\Batch dispatchFakeBatch($name = '')
  * @method static \Illuminate\Contracts\Bus\Dispatcher map(array $map)
  * @method static \Illuminate\Contracts\Bus\Dispatcher pipeThrough(array $pipes)
  * @method static \Illuminate\Foundation\Bus\PendingChain chain(array $jobs)

src/Illuminate/Support/Testing/Fakes/BusFake.php

@@ -675,6 +675,17 @@ public function batch($jobs)
         return new PendingBatchFake($this, Collection::wrap($jobs));
     }
 
+    /**
+     * Dispatch an empty job batch for testing.
+     *
+     * @param  string  $name
+     * @return \Illuminate\Bus\Batch
+     */
+    public function dispatchFakeBatch($name = '')
+    {
+        return $this->batch([])->name($name)->dispatch();
+    }
+
     /**
      * Record the fake pending batch dispatch.
      *

tests/Support/SupportTestingBusFakeTest.php

@@ -2,6 +2,7 @@
 
 namespace Illuminate\Tests\Support;
 
+use Illuminate\Bus\Batch;
 use Illuminate\Bus\Queueable;
 use Illuminate\Contracts\Bus\QueueingDispatcher;
 use Illuminate\Support\Testing\Fakes\BusFake;
@@ -520,6 +521,25 @@ public function testBatchesCanBeCancelled()
 
         $this->assertTrue($batch->cancelled());
     }
+
+    public function testDispatchFakeBatch()
+    {
+        $this->fake->assertNothingBatched();
+
+        $batch = $this->fake->dispatchFakeBatch('my fake job batch');
+
+        $this->fake->assertBatchCount(1);
+        $this->assertInstanceOf(Batch::class, $batch);
+        $this->assertSame('my fake job batch', $batch->name);
+        $this->assertSame(0, $batch->totalJobs);
+
+        $batch = $this->fake->dispatchFakeBatch();
+
+        $this->fake->assertBatchCount(2);
+        $this->assertInstanceOf(Batch::class, $batch);
+        $this->assertSame('', $batch->name);
+        $this->assertSame(0, $batch->totalJobs);
+    }
 }
 
 class BusJobStub