Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WeakMap.prototype.set(): zapisywanie wartości pod kluczem

Metoda `set()` dodaje wpis do `WeakMap` lub zastępuje wartość istniejącego wpisu. Zwraca tę samą mapę, więc wywołania można łączyć w łańcuch.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

weakMap.set(key, value)

WeakMap.prototype.set to metoda prototypu wywoływana na instancji: weakMap.set(key, value). Dodaje wpis dla nowego klucza albo zastępuje wartość dla tego samego klucza. Zwraca tę samą instancję, a nie zapisaną wartość, więc można wywołać kolejne .set(). Wartością może być dowolna wartość JavaScript, w tym undefined.

Klucze będące obiektami są porównywane według tożsamości: dwa odrębne obiekty o identycznych właściwościach to różne klucze. ECMAScript 2024 dopuszcza też niezarejestrowane symbole, np. Symbol("id"). Symbole z Symbol.for("id") oraz inne wartości proste, takie jak ciągi znaków, są niedozwolone. Starsze środowiska mogą nie obsługiwać kluczy symbolicznych; sprawdź zgodność z docelowym środowiskiem.

Nieprawidłowy klucz powoduje TypeError. Ten sam typ błędu wystąpi po wywołaniu odłączonej metody bez właściwego this: odbiorcą musi być instancja WeakMap.

Sam wpis nie utrzymuje klucza przy życiu. Jeśli klucz przestanie być osiągalny w inny sposób, mechanizm odzyskiwania pamięci może go usunąć; nie należy polegać na momencie, w którym to nastąpi. Kluczy WeakMap nie można wyliczać. Gdy potrzebujesz iterować po kluczach lub używać ciągów znaków jako kluczy, wybierz Map.

Przykłady

{
  const metadata = new WeakMap();
  const item = { id: 1 };

  metadata.set(item, 10);
  console.log(metadata.get(item));

  const returned = metadata.set(item, 20);
  console.log(returned === metadata);
  console.log(metadata.get(item));
  console.log(metadata.has({ id: 1 }));

  try {
    metadata.set("id", 30);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Wynik

10
true
20
false
true

Najpierw odczyt zwraca `10`, a po aktualizacji — `20`. Porównanie `returned === metadata` daje `true`. Nowy obiekt z takim samym `id` nie jest zapisanym kluczem, więc `has()` zwraca `false`. Próba użycia ciągu znaków jako klucza kończy się przechwyconym `TypeError`.

Powiązane lekcje

  • JavaScript · Lekcja 35 · Podstawowy · Wersja: 4
  • JavaScript · Lekcja 37 · Podstawowy · Wersja: 4
  • JavaScript · Lekcja 4 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 10 · Średniozaawansowany · Wersja: 3

Źródła