CKTIS / JavaScript
WeakSet: verificar e adicionar elementos com has() e add()
Usa `has()` para verificar se um valor pertence a um `WeakSet` e `add()` para o adicionar. A pertença depende da identidade do valor, e a coleção não o mantém em memória por si só.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const seen = new WeakSet();
seen.has(value);
seen.add(value);WeakSet.prototype.has e WeakSet.prototype.add são dois métodos de instância. seen.has(value) devolve true se o valor estiver presente e false caso contrário. seen.add(value) insere o valor se este ainda não estiver presente e devolve a mesma instância de WeakSet. Voltar a adicionar o valor não cria duplicados, e o valor devolvido permite encadear chamadas a add().
A pertença é verificada pela identidade, não pelo conteúdo: duas referências ao mesmo objeto identificam o mesmo elemento, mas dois objetos distintos com propriedades idênticas não correspondem. O ECMAScript 2024 aceita objetos (incluindo funções) e símbolos não registados, como os criados com Symbol(). Para um símbolo obtido com Symbol.for(), um número, uma cadeia de caracteres ou null, has() devolve false e add() lança um TypeError. Ambos os métodos também lançam um TypeError se this não for uma instância de WeakSet, por exemplo quando se invoca um método extraído sem o vincular à instância.
A pertença, por si só, não impede que o coletor de lixo liberte a memória ocupada pelo valor. Não é possível prever quando isso acontece. Um WeakSet não tem size e não é iterável. Usa-o para assinalar objetos já processados quando não precisares de os listar mais tarde. Escolhe Set se precisares de iterar, de saber o tamanho ou de guardar valores como números e cadeias de caracteres.
O suporte para símbolos pode variar consoante o ambiente de execução. Se dependeres dele, testa add() com um valor criado por Symbol() no ambiente de destino; verificar que existe WeakSet não chega.
Exemplos
{
const seen = new WeakSet();
const item = { id: 1 };
const alias = item;
console.log(seen.has(item));
console.log(seen.add(item).add(item) === seen);
console.log(seen.has(alias));
console.log(seen.has({ id: 1 }));
console.log(seen.has(1));
try {
seen.add(1);
} catch (error) {
console.log(error.name);
}
}Resultado
false true true false false TypeError
A primeira chamada a `has()` devolve `false`. É possível encadear as duas chamadas a `add()` porque o método devolve a mesma instância. `alias` refere-se ao objeto inserido; um novo objeto com o mesmo `id` não corresponde. Para o número `1`, a verificação devolve `false` e a inserção lança o `TypeError` intercetado.
Lições relacionadas
- JavaScript · Lição 17 · Avançado · Versão: 4
- JavaScript · Lição 43 · Avançado · Versão: 4
- JavaScript · Lição 45 · Avançado · Versão: 4
- JavaScript · Lição 40 · Intermédio · Versão: 3