CKTIS / JavaScript
Map.prototype.size: liczba wpisów
Właściwość size odczytuje bieżącą liczbę par klucz–wartość w Map jako nieujemną liczbę całkowitą.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
map.sizemap.size uruchamia getter odziedziczony z Map.prototype i zwraca liczbę nieusuniętych wpisów. Liczy każdy klucz niezależnie od wartości, również wpis z undefined. Aktualizacja istniejącego klucza nie zmienia rozmiaru; nowy set zwiększa go o jeden, udany delete zmniejsza, a clear ustawia na 0.
size jest właściwością akcesorową, a nie metodą: nie używa się map.size(). Deskryptor na prototypie jest niewyliczalny i nie ma settera. Dlatego Reflect.set(map, "size", n) zwraca false, o ile obiekt nie przesłoni właściwości własnym deskryptorem; zwykłe przypisanie do odziedziczonego akcesora bez settera w kodzie ścisłym powoduje TypeError.
Getter wymaga odbiorcy z wewnętrznymi danymi Map; wywołanie go z obiektem, Set lub nieobsłużonym Proxy powoduje TypeError. Właściwość jest standardowa od ECMAScript 2015. Specyfikacja opisuje wynik, nie gwarantuje konkretnej złożoności odczytu; nie opieraj przenośnego kodu na szczególe implementacji.
Przykłady
const map = new Map([["a", undefined], ["b", 2]]);
console.log(map.size);
map.set("a", 3);
console.log(map.size);
map.delete("b");
console.log(map.size);
const descriptor = Object.getOwnPropertyDescriptor(Map.prototype, "size");
console.log(typeof descriptor.get, descriptor.set === undefined, descriptor.enumerable);
console.log(Reflect.set(map, "size", 99), map.size);
try { descriptor.get.call({}); } catch (error) { console.log(error instanceof TypeError); }Wynik
2 2 1 function true false false 1 true