DisposableStack.prototype.use()

Метод use() экземпляров DisposableStack регистрирует значение, реализующее протокол удаления, в стеке.

Синтаксис

use(value)

Параметры

value

Значение для регистрации в стеке. Должно либо содержать метод [Symbol.dispose](), либо быть null, либо undefined.

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

То же самое value, которое было передано.

Исключения

TypeError

Генерируется, если value не является null или undefined, и не содержит метода [Symbol.dispose]().

ReferenceError

Генерируется, если стек уже был удален.

Описание

Основное назначение use() — зарегистрировать значение, реализующее протокол удаления, в стеке, что является эквивалентом объявления using. Если значение не реализует протокол удаления (оно не имеет метода [Symbol.dispose]()), используйте вместо него adopt(), передав колбэк, который вызывает метод очистки ресурса.

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

using disposer = new DisposableStack();
const reader = stream.getReader();
disposer.use(reader);

Примеры

Использование use()

Этот код потребляет ReadableStream через ReadableStreamDefaultReader. Ридер автоматически закрывается по завершении функции, при условии, что он реализует метод [Symbol.dispose](), который синхронно снимает блокировку с потока.

{
  using disposer = new DisposableStack();
  const reader = disposer.use(stream.getReader());
  const { value, done } = reader.read();
  if (!done) {
    // Process the value
  }
  // The reader.releaseLock() method is called here before exiting
}

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

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

Смотрите также

• Управление ресурсами JavaScript
• DisposableStack
• DisposableStack.prototype.adopt()
• DisposableStack.prototype.defer()