CKTIS / JavaScript
Storage.setItem — zapis i zastępowanie wartości
Storage.setItem zapisuje tekst pod kluczem w localStorage lub sessionStorage, zastępując poprzednią wartość. Zapis może się nie udać, dlatego należy uwzględnić wyjątki i ograniczenia dostępu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
storage.setItem(key, value)Storage.setItem wywołujesz na obiekcie localStorage lub sessionStorage: storage.setItem(key, value). Metoda tworzy wpis albo zastępuje wartość istniejącego klucza; zwraca undefined. To API standardu HTML, nie funkcja konkretnej edycji ECMAScript. Współczesne silniki przeglądarek je obsługują; obecność Node 24 w repozytorium nie dowodzi dostępności API przeglądarki.
Klucz i wartość są konwertowane na tekst. Aby zapisać obiekt, jawnie zserializuj go do postaci tekstowej. Przy odczycie zapisanej wartości magazyn zwraca tekst, który aplikacja musi zdekodować zgodnie z formatem użytym przy zapisie. Jeśli zapisujesz dane jako JSON za pomocą JSON.stringify, do odczytania danych z tego tekstu użyj JSON.parse. localStorage przechowuje dane dla originu między sesjami, natomiast sessionStorage jest dodatkowo rozdzielone według kontekstu najwyższego poziomu, zwykle karty. Dane mogą zostać usunięte.
Nieudany zapis może zgłosić QuotaExceededError; sam dostęp do magazynu może zgłosić SecurityError. Obejmij dostęp i zapis blokiem try/catch, jeśli aplikacja ma działać bez magazynu. Zapis identycznego tekstu niczego nie zmienia. Powiadomienie storage dotyczy innych uprawnionych dokumentów, nie okna wykonującego zapis.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.setItem: writing and replacing text</title>
</head>
<body>
<h1>Replacing a storage value</h1>
<p id="source"></p>
<script>
function writeValues(storage) {
let key = 'cktis:setItem';
while (storage.getItem(key) !== null) key += ':';
try {
storage.setItem(key, 'first');
const before = storage.getItem(key);
storage.setItem(key, 'second');
return [before, storage.getItem(key)];
} finally {
storage.removeItem(key);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = writeValues(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
const entries = new Map();
lines = writeValues({
getItem(key) { return entries.has(key) ? entries.get(key) : null; },
setItem(key, value) { entries.set(key, String(value)); },
removeItem(key) { entries.delete(key); }
});
}
document.getElementById('source').textContent = source;
for (const line of lines) console.log(line);
</script>
</body>
</html>Wynik
first second
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.