CKTIS / JavaScript
Storage.setItem — съхраняване и замяна на стойност
Storage.setItem съхранява текст под ключ в localStorage или sessionStorage, като заменя предишната стойност. Записът може да се провали, затова имайте предвид изключенията и ограниченията за достъп до хранилището.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
storage.setItem(key, value)Извикайте Storage.setItem върху обект localStorage или sessionStorage: storage.setItem(key, value). Методът създава запис или заменя стойността на съществуващ ключ и връща undefined. Това API е част от стандарта HTML, а не функция на конкретно издание на ECMAScript. Съвременните браузърни енджини го поддържат; наличието на Node 24 в хранилище с код не доказва наличност на браузърно API.
Ключовете и стойностите се преобразуват в низове. За да запишете обект, изрично го сериализирайте до низ. При прочитане на записаната стойност хранилището връща низ, който приложението трябва да декодира според формата, използван при записа. Ако записвате данни във формат JSON с JSON.stringify, използвайте JSON.parse, за да декодирате този низ. localStorage съхранява данни за даден origin между сесиите, докато sessionStorage се разделя допълнително според контекста на сърфиране от най-високо ниво, обикновено раздела. Данните могат да бъдат изтрити.
Неуспешен запис може да предизвика QuotaExceededError; самият достъп до хранилището може да предизвика SecurityError. Обхванете достъпа и записа с try/catch, ако приложението трябва да работи и без хранилище. Записването на същия текст не променя нищо. Известието storage е предназначено за други допустими документи, а не за прозореца, който извършва записа.
Примери
<!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>Резултат
first second
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.