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

CKTIS / JavaScript

WeakSet — um conjunto com referências fracas

WeakSet contém objetos únicos e símbolos não registados sem os manter vivos apenas por pertencerem ao conjunto. Disponibiliza add, has e delete, mas não permite iterar pelos elementos nem consultar a sua quantidade.

Versão: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).

Sintaxe

new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)

WeakSet serve para acompanhar valores, como objetos que já foram processados. Os objetos são distinguidos pela identidade, não pelo conteúdo: dois objetos distintos { id: 1 } são elementos diferentes. new WeakSet(iterable) adiciona os valores do iterável fornecido; o construtor requer new.

WeakSet.prototype.add(value) adiciona um elemento, ignora duplicados e devolve o mesmo conjunto, permitindo encadear chamadas. WeakSet.prototype.has(value) devolve a pertença como boolean. WeakSet.prototype.delete(value) devolve true se tiver removido um elemento existente ou, caso contrário, false.

São permitidos objetos, incluindo funções, e símbolos que não estejam registados através de Symbol.for. Para valores não suportados, como números, cadeias de caracteres, null ou um resultado de Symbol.for, add lança um TypeError, enquanto has e delete devolvem false. O suporte para símbolos foi acrescentado no ECMAScript 2023; motores mais antigos poderão aceitar apenas objetos. A especificação da linguagem não é uma tabela de compatibilidade de navegadores: verifica o suporte desta funcionalidade no ambiente de destino.

Ao contrário de Set, WeakSet não mantém os elementos vivos apenas por pertencerem ao conjunto. Não há um momento garantido para a recolha de lixo. Não existe size, iteração, forEach nem clear; para verificar a pertença, tens de ter o valor que pretendes verificar. Escolhe Set se precisares de enumerar os elementos ou saber quantos existem.

Exemplos

const first = { id: 1 };
const second = { id: 1 };
const seen = new WeakSet([first]);

console.log(seen.has(first));
console.log(seen.has(second));
console.log(seen.add(second) === seen);
console.log(seen.has(second));
console.log(seen.delete(first));
console.log(seen.delete(first));
console.log(seen.has(first));

Resultado

true
false
true
true
true
false
false

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