Back to Content

WritableStreamDefaultController

files/en-us/web/api/writablestreamdefaultcontroller/index.md

latest1.2 KB
Original Source

{{APIRef("Streams")}}{{AvailableInWorkers}}

The WritableStreamDefaultController interface of the Streams API represents a controller allowing control of a {{domxref("WritableStream")}}'s state. When constructing a WritableStream, the underlying sink is given a corresponding WritableStreamDefaultController instance to manipulate.

Constructor

None. WritableStreamDefaultController instances are created automatically during WritableStream construction.

Instance properties

  • {{domxref("WritableStreamDefaultController.signal")}} {{ReadOnlyInline}}
    • : Returns the {{domxref("AbortSignal")}} associated with the controller.

Instance methods

  • {{domxref("WritableStreamDefaultController.error()")}}
    • : Causes any future interactions with the associated stream to error.

Examples

js
const writableStream = new WritableStream({
  start(controller) {
    // do stuff with controller

    // error stream if necessary
    controller.error("My stream is broken");
  },
  write(chunk, controller) {
    // …
  },
  close(controller) {
    // …
  },
  abort(err) {
    // …
  },
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}