Can disable turbo stream broadcasts globally

src/Broadcasting/Factory.php

@@ -27,6 +27,24 @@ class Factory
      */
     protected $recordedStreams = [];
 
+    /**
+     * Whether the broadcasts should be sent or not (globally).
+     */
+    protected bool $isBroadcasting = true;
+
+    public function withoutBroadcasts(callable $callback)
+    {
+        $original = $this->isBroadcasting;
+
+        $this->isBroadcasting = false;
+
+        try {
+            return $callback();
+        } finally {
+            $this->isBroadcasting = $original;
+        }
+    }
+
     public function fake()
     {
         $this->recording = true;
@@ -95,7 +113,7 @@ public function broadcastAction(string $action, $content = null, Model|string $t
             $broadcast->fake($this);
         }
 
-        return $broadcast;
+        return $broadcast->cancelIf(! $this->isBroadcasting);
     }
 
     public function record(PendingBroadcast $broadcast)

src/Facades/TurboStream.php

@@ -19,6 +19,7 @@
  * @method static \HotwiredLaravel\TurboLaravel\Broadcasting\Factory assertNothingWasBroadcasted()
  * @method static \HotwiredLaravel\TurboLaravel\Broadcasting\Factory assertBroadcasted(callable $callback)
  * @method static \HotwiredLaravel\TurboLaravel\Broadcasting\Factory clearRecordedBroadcasts()
+ * @method static mixed withoutBroadcasts(callable $callback)
  *
  * @mixin \HotwiredLaravel\TurboLaravel\Broadcasting\Factory
  */

tests/TurboStreamsBroadcastingTest.php

@@ -611,4 +611,40 @@ public function broadcast_passing_model_with_broadcasts_trait_to_channel()
             return true;
         });
     }
+
+    /** @test */
+    public function can_disable_turbo_stream_broadcasts()
+    {
+        TurboStream::withoutBroadcasts(fn () => (
+            TurboStream::broadcastRemove('todo_123')
+        ));
+
+        TurboStream::assertNothingWasBroadcasted();
+
+        TurboStream::broadcastRemove('todo_123');
+
+        TurboStream::assertBroadcasted(function (PendingBroadcast $broadcast) {
+            return
+                $broadcast->target === 'todo_123'
+                && $broadcast->action === 'remove';
+        });
+    }
+
+    /** @test */
+    public function globally_disabling_turbo_stream_broadcasts_also_disable_models()
+    {
+        $article = ArticleFactory::new()->create()->fresh();
+
+        TurboStream::withoutBroadcasts(fn () => (
+            $article->broadcastAppend()
+        ));
+
+        TurboStream::assertNothingWasBroadcasted();
+
+        $article->broadcastAppend();
+
+        TurboStream::assertBroadcasted(function (PendingBroadcast $broadcast) {
+            return $broadcast->target === 'articles' && $broadcast->action === 'append';
+        });
+    }
 }