WritableStreamDefaultController: метод error()

Примечание: Эта функция доступна в Потоках Web Workers.

Метод error() интерфейса WritableStreamDefaultController вызывает ошибку всех будущих взаимодействий с соответствующим потоком.

Этот метод используется редко, так как обычно достаточно вернуть промис, отклоненный одним из методов базового синкового объекта. Однако он может быть полезен для внезапной остановки потока в ответ на событие, выходящее за рамки обычного жизненного цикла взаимодействий с базовым синковым объектом.

Синтаксис

error(message)

Параметры

message: Строка, представляющая ошибку, с которой будут завершаться будущие взаимодействия.

Возвращаемое значение

None (undefined).

Исключения

TypeError: Поток, для которого вы пытаетесь вызвать ошибку, не является WritableStream.

Примеры

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

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

Спецификации

Спецификация
Потоки # ref-for-ws-default-controller-error①

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`error`	59	16	100	46	14.1	59	100	43	14.5	7.0	59

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WritableStreamDefaultController/error