Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Map.prototype.size: número de entradas

A propriedade size lê o número atual de pares chave–valor de um Map como inteiro não negativo.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

map.size

map.size chama um getter herdado de Map.prototype e conta entradas não eliminadas, incluindo valor undefined. Atualizar uma chave não altera a contagem; novo set aumenta-a, delete bem-sucedido reduz e clear põe 0.

size é um acessor, não método: não chame map.size(). O descritor não é enumerável e não tem setter. Reflect.set(map, "size", n) devolve false salvo propriedade própria; atribuição strict ao acessor herdado lança TypeError.

O getter exige dados internos de Map; objeto, Set ou Proxy não tratado lança TypeError. Padrão desde ECMAScript 2015. A especificação define o resultado, não uma complexidade concreta.

Exemplos

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

Resultado

2
2
1
function true false
false 1
true

Fontes