← 返回首页
Symbol.iterator - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Веб-технологии для разработчиков
  2. JavaScript
  3. Справочник по JavaScript
  4. Стандартные встроенные объекты
  5. Symbol
  6. Symbol.iterator
Theme
  • OS default
  • Light
  • Dark
Русский
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Symbol.iterator

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since сентябрь 2016 г..

Symbol.iterator — известный символ, задающий итератор объекта, используемый по умолчанию. Применяется в конструкции for...of.

Атрибуты свойства Symbol.iterator
Записываемоенет
Перечисляемоенет
Настраиваемоенет

In this article

Описание

Каждый раз, когда объект должен быть проитерирован (как, например, в начале цикла for..of), метод @@iterator вызывается без аргументов, а возвращённый итератор используется непосредственно для получения значений.

Некоторые встроенные типы имеют стандартное итерационное поведение, в то время как другие типы (как Object) таким свойством не обладают. Метод @@iterator имеют следующие встроенные типы:

Смотрите также Протоколы перебора для получения дополнительных сведений.

Примеры

Пользовательские итерируемые объекты

Мы можем создавать собственные итерируемые объекты, подобно следующему коду:

js
var myIterable = {}; myIterable[Symbol.iterator] = function* () { yield 1; yield 2; yield 3; }; [...myIterable]; // [1, 2, 3]

Плохо оформленные итераторы

Если метод @@iterator объекта не возвращает итератор, то это плохо оформленный итерируемый объект, его использование, скорее всего, приведёт к возникновению исключений или неправильному поведению:

js
var nonWellFormedIterable = {} nonWellFormedIterable[Symbol.iterator] = () => 1 [...nonWellFormedIterable] // TypeError: [] is not a function

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

Specification
ECMAScript® 2027 Language Specification
# sec-symbol.iterator

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

Enable JavaScript to view this browser compatibility table.

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

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 4 мая 2024 г. by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Стандартные встроенные объекты
  2. Symbol
  3. Конструктор
    1. Symbol()
  4. Статические методы
    1. Symbol.for()
    2. Symbol.keyFor()
  5. Статические свойства
    1. asyncDispose
    2. asyncIterator
    3. dispose
    4. Symbol.hasInstance
    5. Symbol.isConcatSpreadable
    6. Symbol.iterator
    7. Symbol.match
    8. matchAll
    9. Symbol.replace
    10. Symbol.search
    11. Symbol.species
    12. Symbol.split
    13. Symbol.toPrimitive
    14. Symbol.toStringTag
    15. Symbol.unscopables
  6. Методы экземпляра
    1. toString()
    2. Symbol.prototype.valueOf()
    3. Symbol.prototype[@@toPrimitive]
  7. Свойства экземпляра
    1. description
  8. Наследование
  9. Object/Function
  10. Статические методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  11. Статические свойства
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  12. Методы экземпляра
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. Свойства экземпляра
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.