ReadableByteStreamController: метод error()

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

Это обычно вызывается базовым источником для отображения ошибки из интерфейса, где он получает свои данные (например, при ошибке чтения файла или сокета). Также его можно вызвать из другого места для вызова ошибки потока, например, если другая часть системы, от которой зависит поток, выйдет из строя.

errorObject

Любой объект, с которым вы хотите, чтобы будущие взаимодействия завершались ошибкой.

None (undefined).

TypeError

Выбрасывается, если объект-источник не является ReadableByteStreamController, или поток не является читаемым по какой-либо другой причине.

Пример в Использование потоков байтов для чтения > Создание потока байтов для чтения из сокета демонстрирует, как вы можете вручную вызвать ошибку потока, если другая часть системы, от которой он зависит, выйдет из строя.

В частности, базовый метод источника start() вызывает readRepeatedly() для выполнения всех операций настройки и отправки запроса на данные. Это возвращает промис. Если при чтении данных возникают какие-либо ошибки, они будут перехвачены цепочкой функций catch(). В catch() мы затем вызываем error() для контроллера, передавая причину из базового источника.

function start(controller) {
  readRepeatedly().catch((e) => controller.error(e));
}

function readRepeatedly() {
  return socket.select2().then(() => {
    // …
  });
}

• Использование потоков байтов для чтения