Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.size

map.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

Źródła