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

CKTIS / JavaScript

Set.prototype.size — número de elementos de um conjunto

A propriedade size indica o número atual de valores distintos num Set. Leia-a como set.size, sem parênteses. Um conjunto vazio tem tamanho 0 e adicionar novamente o mesmo valor não aumenta o seu tamanho.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

set.size

Set.prototype.size é uma propriedade acessora: o getter herdado pelas instâncias de Set devolve o número atual de elementos armazenados como Number. Utilize set.size, não set.size() nem set.length. Para um conjunto vazio, o resultado é 0.

Um conjunto armazena cada valor distinto apenas uma vez. Adicionar um valor que já existe não aumenta size; eliminar um valor presente reduz o tamanho, e clear() remove todos os elementos. Cada leitura reflete o estado atual do conjunto. Um número guardado anteriormente numa variável não é atualizado automaticamente.

A propriedade integrada não tem setter. Atribuir um valor a set.size não altera o número de elementos: no modo estrito, gera um TypeError; fora dele, a atribuição é ignorada, desde que a propriedade não tenha sido ocultada. Altere o conteúdo do conjunto em vez de lhe atribuir um tamanho.

O getter requer um recetor com o slot interno [[SetData]]; não funciona num objeto simples que apenas finge ser um conjunto. Ler diretamente Set.prototype.size também gera um TypeError, porque o próprio protótipo não tem esse slot. Isto faz parte da biblioteca padrão ECMAScript, não de uma API Web separada; a especificação da linguagem não é uma tabela de compatibilidade dos navegadores.

Exemplos

const values = new Set(["a", "b", "a"]);
console.log(values.size);
values.add("b");
console.log(values.size);
values.delete("a");
console.log(values.size);
values.clear();
console.log(values.size);

Resultado

2
2
1
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes