arguments[Symbol.iterator]()

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

Начальное значение этого свойства совпадает с начальным значением свойства Array.prototype.values (а также совпадает с Array.prototype[Symbol.iterator]()).

Синтаксис

arguments[Symbol.iterator]()

Параметры

Нет.

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

То же, что и возвращаемое значение Array.prototype.values(): новый итератор, который выдает значение каждого индекса в объекте arguments.

Примеры

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

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

function f() {
  for (const letter of arguments) {
    console.log(letter);
  }
}
f("w", "y", "k", "o", "p");

Ручное создание итератора

Вы по-прежнему можете вручную вызвать метод next() возвращаемого объекта итератора для достижения максимального контроля над процессом итерации.

function f() {
  const argsIter = arguments[Symbol.iterator]();
  console.log(argsIter.next().value); // w
  console.log(argsIter.next().value); // y
  console.log(argsIter.next().value); // k
  console.log(argsIter.next().value); // o
  console.log(argsIter.next().value); // p
}
f("w", "y", "k", "o", "p");

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

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

См. также

• Руководство по функциям
• Функции
• arguments
• Array.prototype.values()
• Symbol.iterator
• Протоколы итерации