Iterator.prototype[Symbol.dispose]()

Метод [Symbol.dispose]() экземпляров Iterator реализует протокол удаления (disposable protocol) и позволяет удалить его при использовании с using. Он вызывает метод return() this, если он существует.

Синтаксис

iterator[Symbol.dispose]()

Параметры

Нет.

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

Нет (undefined).

Примеры

Объявление итератора с помощью using

Метод Symbol.dispose предназначен для автоматического вызова в объявлении using. Это полезно, если у вас есть итератор, который вы вручную перебираете, вызывая его метод next(); если вы перебираете его с помощью for...of или чего-то подобного, то обработка ошибок и очистка выполняются автоматически.

function* generateNumbers() {
  try {
    yield 1;
    yield 2;
    yield 3;
  } finally {
    console.log("Cleaning up");
  }
}

function doSomething() {
  using numbers = generateNumbers();
  const res1 = numbers.next();
  // Not iterating the rest of the numbers
  // Before the function exits, the async iterator is disposed
  // Logs "Cleaning up"
}

doSomething();

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

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

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

• Полифил Iterator.prototype[Symbol.dispose] в core-js
• Управление ресурсами в JavaScript
• Symbol.dispose
• using