CKTIS / JavaScript
Итератори на Map: next(), value и done
Обхождай итератор на Map с `next()` и проверявай `done`, за да различиш записана стойност `undefined` от края на обхождането.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const iterator = map.entries(); // or map.keys(), map.values(), map[Symbol.iterator]()
const { value, done } = iterator.next();Извикай iterator.next(), за да направиш една стъпка. Методът принадлежи на итератора, а не на обекта Map, и връща обект с резултата и неговите свойства value и done. Четенето на result.value не придвижва итератора, но ново извикване на next() го придвижва. Запази резултата, ако ти трябват и двете свойства от една и съща стъпка. Извикването на отделения метод next без правилното this предизвиква TypeError.
map.keys() дава ключовете, а map.values() — записаните стойности. При всяка стъпка, която дава елемент, итераторите от map.entries() и map[Symbol.iterator]() връщат нов масив [key, value] с два елемента като result.value. И трите вида обхождат записите в реда на добавянето им. Проверявай done, а не value: done: false означава, че е получен елемент, дори когато value е undefined. Изчерпан итератор на Map връща { value: undefined, done: true }.
Итераторът не е моментна снимка: може да обхване записи, добавени преди изчерпването му, но след като върне done: true, не продължава. Създай нов итератор, за да започнеш отначало. Така работи вграденият Map в ECMAScript 2024; поддръжката зависи от средата за изпълнение.
Примери
{
const map = new Map([["a", undefined], ["b", 7]]);
const iterator = map.values();
function logStep({ value, done }) {
console.log(`done=${done}, value=${value}`);
}
logStep(iterator.next());
logStep(iterator.next());
logStep(iterator.next());
map.set("c", 9);
logStep(iterator.next());
console.log(JSON.stringify(map.entries().next().value));
}Резултат
done=false, value=undefined done=false, value=7 done=true, value=undefined done=true, value=undefined ["a",null]
Първата стъпка дава записаното `undefined`, а третата показва края. Добавянето на `"c"` не възобновява итератора. Нов итератор на записите започва от `"a"`; на последния ред `JSON.stringify()` представя елемента `undefined` в масива като `null`, без да променя Map.
Свързани уроци
- JavaScript · Урок 7 · Напреднало · Версия: 4
Източници
- ECMAScript 2024 Language Specification — Map Iterator Objects
- ECMAScript Language Specification — Properties of the Map Prototype Object
- ECMAScript Language Specification — Map Iterator Objects
- ECMAScript 2024 Language Specification — GeneratorResume
- ECMAScript 2024 Language Specification — GeneratorValidate