CKTIS / JavaScript
Storage.setItem — spremanje i zamjena vrijednosti
Storage.setItem sprema tekst pod ključem u localStorage ili sessionStorage i pritom zamjenjuje prethodnu vrijednost. Zapis može zakazati, pa treba uzeti u obzir iznimke i ograničenja pristupa pohrani.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
storage.setItem(key, value)Pozovite Storage.setItem na objektu localStorage ili sessionStorage: storage.setItem(key, value). Metoda stvara unos ili zamjenjuje vrijednost postojećeg ključa i vraća undefined. Ovo je API iz standarda HTML, a ne značajka određenog izdanja ECMAScripta. Suvremeni preglednički pogoni ga podržavaju; prisutnost Node 24 u repozitoriju ne dokazuje dostupnost API-ja preglednika.
Ključevi i vrijednosti pretvaraju se u nizove znakova. Da biste spremili objekt, izričito ga serijalizirajte u niz znakova. Pri čitanju spremljene vrijednosti pohrana vraća niz znakova koji aplikacija mora dekodirati prema formatu korištenom pri zapisivanju. Ako podatke zapisujete u formatu JSON pomoću JSON.stringify, za dekodiranje tog niza upotrijebite JSON.parse. localStorage čuva podatke za origin između sesija, dok je sessionStorage dodatno odvojen prema kontekstu pregledavanja najviše razine, obično kartici. Podaci se mogu izbrisati.
Neuspjeli zapis može izazvati QuotaExceededError; sam pristup pohrani može izazvati SecurityError. Ako aplikacija mora raditi i bez pohrane, pristup i zapis obuhvatite s try/catch. Zapisivanje istog teksta ništa ne mijenja. Obavijest storage namijenjena je drugim odgovarajućim dokumentima, a ne prozoru koji obavlja zapis.
Primjeri
<!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>Rezultat
first second
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.