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

CKTIS / JavaScript

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

Методът values връща жив итератор на стойностите на Map по реда на вмъкване на съответните ключове.

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

Синтаксис

map.values()

map.values() създава нов итератор на Map. Всяко успешно next() връща стойността на следващия запис. Обектите остават същите препратки, а равни стойности под различни ключове се връщат отделно; няма премахване на дубликати.

Итераторът е ленив, не е снимка. Прескача запис, изтрит преди посещението, предишно обновяване дава новата стойност, а добавяне преди края може да се види. Обновяване на посетен ключ не го повтаря. След done: true добавянията не го възобновяват.

Методът няма значими аргументи и изисква вътрешни данни на Map; обект, Set или необработен Proxy хвърля TypeError. Стандартен от ECMAScript 2015. За връзката с ключовете използвайте entries().

Примери

const shared = {};
const map = new Map([["a", shared], ["b", 2], ["c", 2]]);
const values = map.values();
console.log(values.next().value === shared);
map.set("b", 20);
map.delete("c");
map.set("d", 4);
console.log(values.next().value);
console.log(values.next().value);
console.log(values.next().done);
map.set("e", 5);
console.log(values.next().done);
console.log([...new Map([["x", 1], ["y", 1]]).values()].join(","));
try { Map.prototype.values.call({}); } catch (error) { console.log(error instanceof TypeError); }

Резултат

true
20
4
true
true
1,1
true

Източници