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) // booleanWeakSet.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