CKTIS / JavaScript
Storage.setItem — ukladanie a nahrádzanie hodnoty
Storage.setItem ukladá text pod kľúčom do localStorage alebo sessionStorage a nahrádza predchádzajúcu hodnotu. Zápis môže zlyhať, preto treba počítať s výnimkami a obmedzeniami prístupu k úložisku.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
storage.setItem(key, value)Zavolajte Storage.setItem na objekte localStorage alebo sessionStorage: storage.setItem(key, value). Metóda vytvorí položku alebo nahradí hodnotu existujúceho kľúča a vráti undefined. Toto API je súčasťou štandardu HTML, nie vlastnosťou konkrétnej edície ECMAScriptu. Moderné prehliadačové enginy ho podporujú; prítomnosť Node 24 v repozitári nedokazuje dostupnosť prehliadačového API.
Kľúče a hodnoty sa konvertujú na reťazce. Ak chcete uložiť objekt, explicitne ho serializujte do reťazca. Pri čítaní uloženej hodnoty úložisko vráti reťazec, ktorý musí aplikácia dekódovať podľa formátu použitého pri zápise. Ak údaje zapisujete vo formáte JSON pomocou JSON.stringify, na dekódovanie tohto reťazca použite JSON.parse. localStorage uchováva údaje pre origin naprieč reláciami, zatiaľ čo sessionStorage sa navyše oddeľuje podľa kontextu prehliadania najvyššej úrovne, zvyčajne podľa karty. Údaje možno odstrániť.
Neúspešný zápis môže vyvolať QuotaExceededError; samotný prístup k úložisku môže vyvolať SecurityError. Ak má aplikácia fungovať aj bez úložiska, oba úkony, prístup aj zápis, ošetrite pomocou try/catch. Zápis rovnakého textu nič nemení. Oznámenie storage sa týka iných oprávnených dokumentov, nie okna, ktoré vykonáva zápis.
Príklady
<!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>Výsledok
first second
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.