Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Storage.length i Storage.key(): liczenie i odczyt kluczy

`length` podaje liczbę zapisanych par, a `key(index)` zwraca nazwę klucza według indeksu. Kolejność kluczy nie jest gwarantowana.

Wersja: Current web platform; runtime support varies

Składnia

// Web Storage is defined by the HTML Living Standard, not ECMAScript 2024.
storage.length                 // number (read-only)
storage.key(index)             // string | null; zero-based index
storage.getItem(name)          // string | null; lookup by key name

Storage.length/key łączy dwa elementy obiektu Storage. Właściwość storage.length jest tylko do odczytu i podaje bieżącą liczbę par klucz–wartość, a nie rozmiar w bajtach ani limit miejsca. storage.key(index) zwraca nazwę klucza jako ciąg znaków, nie jego wartość. Numeracja zaczyna się od zera: podawaj nieujemne liczby całkowite z zakresu typu unsigned long (od 0 do 2 ** 32 - 1). Po konwersji do tego typu indeks równy bieżącemu length lub większy daje null.

Aby pobrać wartość, przekaż nazwę do storage.getItem(name). Ta metoda również może zwrócić null, ale oznacza to, że klucz nie istnieje. Wynik key() sprawdzaj przez name !== null, ponieważ pusty ciąg też może być nazwą klucza.

Kolejność zależy od implementacji i może się zmienić po modyfikacji zawartości. Nie zakładaj kolejności wstawiania ani nie zapisuj indeksu jako identyfikatora klucza. Jeśli potrzebujesz stałej kolejności wyświetlania, zbierz nazwy i posortuj je jawnie. Nawet zapamiętanie length nie tworzy migawki: zmiany w trakcie iteracji mogą spowodować pominięcie lub powtórzenie kluczy.

To interfejs Web Storage zdefiniowany w standardzie HTML, nie w ECMAScript 2024. window.localStorage jest przypisany do pochodzenia (origin) i może przetrwać ponowne uruchomienie przeglądarki. window.sessionStorage jest dodatkowo rozdzielony według kart lub okien najwyższego poziomu: przetrwa przeładowanie strony, ale jest związany z sesją strony. Nie zakładaj dostępności w każdym środowisku. Pobranie obiektu może zgłosić SecurityError z powodu nieprzezroczystego pochodzenia lub zasad przeglądarki, a zapis może zgłosić QuotaExceededError, np. po wyczerpaniu limitu.

Przykłady

(() => {
  function demonstrate(storage) {
    if (storage.length !== 0) {
      throw new Error("Use an empty sessionStorage area.");
    }

    try {
      console.log(storage.length);
      storage.setItem("theme", "dark");
      storage.setItem("lang", "en");

      const count = storage.length;
      const names = [];
      for (let index = 0; index < count; index++) {
        const name = storage.key(index);
        if (name !== null) names.push(name);
      }

      console.log(count);
      console.log(JSON.stringify(names.sort().map(name => [name, storage.getItem(name)])));
      console.log(storage.key(count));
    } finally {
      storage.removeItem("theme");
      storage.removeItem("lang");
    }
  }

  const storage = globalThis.sessionStorage;
  if (storage !== undefined) {
    demonstrate(storage);
  } else {
    // If Node.js 24 has not exposed Web Storage, enable it in a fresh process.
    const { execFileSync } = require("node:child_process");
    execFileSync(
      process.execPath,
      ["--experimental-webstorage", "-e", `(${demonstrate.toString()})(globalThis.sessionStorage);`],
      { stdio: "inherit" },
    );
  }
})();

Wynik

0
2
[["lang","en"],["theme","dark"]]
null

Uruchom kod w konsoli przeglądarki na stronie HTTP(S) w karcie testowej z pustym `sessionStorage`, dozwolonym dostępem i bez innego kodu zmieniającego ten obszar. Sortowanie uniezależnia wynik od kolejności kluczy w przeglądarce. `key(count)` zwraca `null`, a `finally` usuwa tylko dwa wpisy użyte przez przykład. W Node.js 24 zapisz kod jako `main.js` i uruchom `node main.js`; w razie potrzeby przykład włącza wbudowane Web Storage w procesie potomnym.

Powiązane lekcje

  • JavaScript · Lekcja 42 · Zaawansowany · Wersja: 4

Źródła