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

CKTIS / JavaScript

Array.prototype.values: итератор на стойности

values връща жив итератор, който чете последователни индексирани стойности, включително undefined от дупки.

Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2

Синтаксис

array.values()

array.values() създава итератор на стойности без копиране на елементите. Всяко next() прочита текущия индекс и проверява length отново, затова промени на получателя преди посещението на позиция могат да се видят. Резултатът от стъпка съдържа value и done; след изчерпване итераторът остава изчерпан.

Дупките не се пропускат: нормално прочитане на липсващ индекс дава undefined. Итераторът сам е итерируем, а Array.prototype[Symbol.iterator] първоначално сочи към същата функция като values. Методът не променя и е общ за array-like стойности.

Създаването изисква получател, различен от null и undefined, иначе хвърля TypeError. Преобразуването на length, индексираните getter и proxy trap се изпълняват при итерация, затова грешките им излизат от next(). API е стандартизиран в ECMAScript 2015.

Примери

const sparse = ["build", , "deploy"];
const iterator = sparse.values();
for (let step = iterator.next(); !step.done; step = iterator.next()) {
  console.log(String(step.value), step.done);
}
console.log(iterator.next().done);

const tasks = ["test"];
const live = tasks.values();
console.log(live.next().value);
tasks.push("release");
console.log(live.next().value, live.next().done);

Резултат

build false
undefined false
deploy false
true
test
release true

Източници