diff --git a/js/net/src/announced.ts b/js/net/src/announced.ts index ae3401093..b9eaf6d4b 100644 --- a/js/net/src/announced.ts +++ b/js/net/src/announced.ts @@ -186,7 +186,15 @@ export class Broadcast { /** The broadcast path this handle watches. */ readonly path: Path.Valid; - /** The live broadcast, or `undefined` while it is offline. */ + /** + * The live broadcast, or `undefined` while it is offline. + * + * Borrowed, not yours to close: this handle owns the consumer and swaps it when the path is + * republished. `active` keeps pointing at whatever you closed, so once you drop the last + * reference the shared broadcast is gone and reads fail until the next announcement replaces + * it. Take a {@link broadcast.Consumer.clone} for a lifetime of your own, or close this whole + * handle to release everything. + */ readonly active: Getter; #active = new Signal(undefined);