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

CKTIS / JavaScript

WeakMap.set(): adicionar ou substituir um valor

O método `set()` guarda um valor associado a uma chave num `WeakMap`. Se a chave já existir, substitui o valor anterior. Devolve o mesmo mapa, permitindo encadear chamadas.

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

Sintaxe

weakMap.set(key, value)

WeakMap.set refere-se ao método de instância WeakMap.prototype.set, não a um método estático do construtor WeakMap. weakMap.set(key, value) adiciona uma entrada se a chave for nova ou substitui o valor se a chave já existir. Devolve o mesmo WeakMap, pelo que podes encadear outra chamada a .set(). O valor pode ser qualquer um; se omitires value, fica guardado undefined.

As chaves que são objetos são comparadas pela sua identidade: dois objetos {} criados separadamente são chaves diferentes. O ECMAScript 2024 também aceita símbolos não registados, como Symbol(). Os ambientes de execução mais antigos podem aceitar apenas objetos como chaves. Usar uma cadeia de caracteres, um número, null ou um símbolo registado com Symbol.for() como chave provoca um TypeError. O mesmo acontece se chamares o método com um this que não seja uma instância de WeakMap.

Uma entrada não mantém a chave viva por si só. Quando a chave deixa de estar acessível fora desta associação fraca, pode ser recolhida pelo coletor de lixo, mas não há garantias quanto ao momento da recolha. Isto permite guardar dados adicionais sobre um objeto sem prolongar o seu tempo de vida. Usa Map se precisares de chaves de texto ou de percorrer as entradas.

Exemplos

{
  const statuses = new WeakMap();
  const task = {};
  const otherTask = {};

  const result = statuses.set(task, "pending").set(otherTask, false);
  statuses.set(task, "ready");

  console.log(result === statuses);
  console.log(statuses.get(task));
  console.log(statuses.get(otherTask));
  console.log(statuses.has({}));

  try {
    statuses.set("task", "ready");
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Resultado

true
ready
false
false
true

O primeiro `true` mostra que as chamadas encadeadas devolvem o mesmo mapa. `ready` substitui `pending`. O primeiro `false` é o valor guardado para `otherTask`; o segundo indica que o novo `{}` não é uma chave do mapa. O último `true` confirma que a chave de texto provocou um `TypeError`.

Lições relacionadas

  • JavaScript · Lição 18 · Básico · Versão: 4

Fontes