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

CKTIS / JavaScript

Map.prototype.entries: итератор на двойки ключ–стойност

Методът entries връща жив итератор на двойки [key, value] по реда на вмъкване и е стандартната итерация на Map.

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

Синтаксис

map.entries()

map.entries() създава нов обект итератор на Map. Всяко успешно next() връща нов двуелементен масив [key, value]; промяната му не изменя записа в Map, макар съдържаните обекти да остават същите препратки. map[Symbol.iterator] е същата функция като map.entries, затова for...of и spread получават двойки по подразбиране.

Итераторът е ленив, не е моментна снимка. Той пази реда на вмъкване, прескача записи, изтрити преди посещението, и може да види записи, добавени преди края; промяна на още непосетен ключ дава новата стойност. След като next() върне done: true, по-късни добавяния не възобновяват итератора.

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

Примери

const map = new Map([["a", 1], ["b", 2]]);
const entries = map.entries();
const first = entries.next().value;
console.log(JSON.stringify(first));
first[1] = 99;
console.log(map.get("a"));

map.delete("b");
map.set("c", 3);
const second = entries.next();
console.log(JSON.stringify(second.value), second.done);
console.log(entries.next().done);

map.set("d", 4);
console.log(entries.next().done);
console.log(map[Symbol.iterator] === map.entries);

Резултат

["a",1]
1
["c",3] false
true
true
true

Източници