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

CKTIS / JavaScript

WeakSet: verificar, adicionar e remover elementos

Usa `has()` para verificar se um valor pertence ao conjunto, `add()` para o adicionar e `delete()` para o remover. Os métodos diferem no valor devolvido e no tratamento de valores inválidos.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

weakSet.has(value)    // boolean
weakSet.add(value)    // the same WeakSet instance
weakSet.delete(value) // boolean

WeakSet.prototype.has/add/delete é uma forma abreviada de referir três métodos de WeakSet.prototype, não o nome de um único método. Invoca-os numa instância, como em seen.has(value). Invocar um destes métodos sem uma instância de WeakSet como this lança um TypeError, inclusive se separares o método da instância e o invocares como uma função normal.

has(value) devolve true se o valor estiver presente e false caso contrário, sem alterar o conjunto. add(value) insere o valor apenas se estiver ausente e, se a chamada for bem-sucedida, devolve a mesma instância, pelo que podes encadear chamadas. delete(value) só devolve true se tiver removido um elemento; caso contrário, devolve false. A pertença depende da identidade, não do conteúdo: dois objetos { id: 1 } criados separadamente são elementos distintos.

O ECMAScript 2024 aceita objetos (incluindo funções) e símbolos não registados, como Symbol(). Os símbolos do registo global devolvidos por Symbol.for() e os restantes valores primitivos, como 1 e null, não são aceites. Para um valor inválido, add() lança um TypeError, enquanto has() e delete() devolvem false. Ambientes de execução mais antigos podem aceitar apenas objetos; verifica se o ambiente de destino suporta símbolos.

Uma entrada num WeakSet não mantém, por si só, um valor vivo. Se o valor deixar de ser alcançável através de referências fortes, o mecanismo de recolha de lixo pode libertar a memória; não dependas do momento em que isso acontece. Um WeakSet não é iterável e não tem a propriedade size. Usa-o para marcar objetos já processados; se precisares de percorrer ou contar elementos, usa Set, que mantém referências fortes para os seus elementos.

Exemplos

{
  const seen = new WeakSet();
  const task = { id: 1 };
  const lookalike = { id: 1 };

  console.log(seen.add(task).add(task) === seen);
  console.log(seen.has(task));
  console.log(seen.has(lookalike));
  console.log(seen.delete(task));
  console.log(seen.delete(task));
  console.log(seen.has(task));
  console.log(seen.has(1));
  console.log(seen.delete(1));

  try {
    seen.add(1);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Resultado

true
true
false
true
false
false
false
false
true

Adicionar `task` duas vezes continua a devolver `seen`. `lookalike` tem o mesmo conteúdo, mas não pertence ao conjunto. Só a primeira remoção de `task` devolve `true`. O último `true` confirma o tipo de erro de `add(1)`; o resultado apresentado não depende da recolha de lixo.

Lições relacionadas

  • JavaScript · Lição 30 · Intermédio · Versão: 3

Fontes