Spec-Zone.ru › JavaScript

Iterator.prototype[Symbol.iterator]()

Базовый уровень Широко доступно

Эта функция хорошо зарекомендовала себя и работает на множестве устройств и версий браузеров. Она доступна во всех браузерах с июля 2015 года.

Метод [Symbol.iterator]() экземпляров Iterator реализует протокол итератора и позволяет использовать встроенные итераторы в большинстве синтаксисов, ожидающих итераторы, таких как синтаксис распространения и циклы for...of. Он возвращает значение this, которым является сам объект итератора.

Синтаксис

iterator[Symbol.iterator]()

Параметры

Нет.

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

Значение this, которым является сам объект итератора.

Примеры

Итерация с использованием цикла for...of

Обратите внимание, что вам редко нужно вызывать этот метод напрямую. Наличие метода [Symbol.iterator]() делает встроенные итераторы итерируемыми, а синтаксисы итерации, такие как цикл for...of, автоматически вызывают этот метод для получения итератора для обхода.

const arrIterator = [1, 2, 3].values();
for (const value of arrIterator) {
  console.log(value);
}
// Logs: 1, 2, 3

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

Спецификация
Спецификация языка ECMAScript® 2027
# sec-iterator.prototype-%symbol.iterator%

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

Настольные компьютеры Мобильные Сервер
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
@@iterator
38
12
36
27–36Используется свойство-заполнитель с именем @@iterator.
17–27Используется свойство-заполнитель с именем iterator.
25
10
38
36
27–36Используется свойство-заполнитель с именем @@iterator.
17–27Используется свойство-заполнитель с именем iterator.
25
10
3.0
38
10
1.0.0
1.0
0.12.0

См. также

  • Iterator
  • Symbol.iterator
  • Протоколы итерации

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator/Symbol.iterator

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API