WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Map.prototype.size: Anzahl der Einträge

Die Eigenschaft size liest die aktuelle Anzahl der Schlüssel-Wert-Einträge einer Map als nichtnegative Ganzzahl.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

map.size

map.size ruft einen von Map.prototype geerbten Getter auf und zählt nicht gelöschte Einträge, auch mit Wert undefined. Aktualisieren ändert die Zahl nicht; neues set erhöht, erfolgreiches delete vermindert und clear setzt sie auf 0.

size ist eine Zugriffseigenschaft, keine Methode: nicht map.size() aufrufen. Ihr Prototypdeskriptor ist nicht aufzählbar und hat keinen Setter. Reflect.set(map, "size", n) liefert daher false, sofern keine eigene Eigenschaft eingreift; strikte Zuweisung an den geerbten Zugriff ohne Setter löst TypeError aus.

Der Getter verlangt interne Map-Daten; Objekt, Set oder unbehandelter Proxy löst TypeError aus. Seit ECMAScript 2015 Standard. Die Spezifikation garantiert das Ergebnis, nicht eine bestimmte Zugriffskomplexität.

Beispiele

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); }

Ergebnis

2
2
1
function true false
false 1
true

Quellen