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

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

Fontes