База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.keys: итератор на индекси

keys връща итератор на последователни индекси от нула, включително за дупките.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

array.keys()

array.keys() връща нов итератор на индексите 0, 1, …. Не чете стойности и не проверява дали индексираното свойство съществува, затова дупка получава нормален индекс. Итераторът е еднократен, самият е итерируем и не променя получателя.

Текущата дължина се проверява при всяко next() и не се замразява при създаването. Елемент, добавен преди края, може да добави индекс; съкращаването може да приключи по-рано. Методът е общ за array-like получатели, но null/undefined хвърля TypeError. Примерът показва индекси на дупки и индекс, добавен по време на итерация.

Примери

console.log([...new Array(3).keys()].join(","));
const values = ["A"];
const iterator = values.keys();
console.log(iterator.next().value);
values.push("B");
const appended = iterator.next();
console.log(appended.value, appended.done);

Резултат

0,1,2
0
1 false

Източници