@xan/broadcast-subject

A set of tooling that encapsulates an object that acts as a variant of Subject with the intent to enable the sending of values to other contexts (Browser tabs, iframes, workers, ect.).

Build

Automated by JSR.

Publishing

Automated by .github\workflows\publish.yml.

Running unit tests

Run deno task test or deno task test:ci to execute the unit tests via Deno.

Example

import { BroadcastSubject } from "@xan/broadcast-subject";

// Setup subjects
const name = "test";
const controller = new AbortController();
const subject1 = new BroadcastSubject<number>(name);
const subject2 = new BroadcastSubject<number>(name);

// Subscribe to subjects
subject1.subscribe({
  signal: controller.signal,
  next: (value) => console.log("subject1 received", value, "from subject1"),
  return: () => console.log("subject1 returned"),
  throw: (value) => console.log("subject1 threw", value),
});
subject2.subscribe({
  signal: controller.signal,
  next: (value) => console.log("subject2 received", value, "from subject2"),
  return: () => console.log("subject2 returned"),
  throw: (value) => console.log("subject2 threw", value),
});

subject1.next(1); // subject2 received 1 from subject1
subject2.next(2); // subject1 received 2 from subject2
subject2.return(); // subject2 returned
subject1.next(3); // No console output since subject2 is already returned

Glossary And Semantics

• @xan/observer
• @xan/observable
• @xan/subject