CKTIS / JavaScript
Storage.getItem — четене на стойност от Web Storage
Storage.getItem(key) синхронно прочита текст от localStorage или sessionStorage. Връща null, когато ключът не съществува; празният низ е съществуваща стойност, а не липсващ запис.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
storage.getItem(key)Storage.getItem е метод на екземпляр на Storage, който се използва от localStorage и sessionStorage. Приема текстов ключ и връща съхранения текст или null, ако записът не съществува. Четенето е синхронно и не премахва записа.
Разграничавайте null, "" и "null". Проверявайте за липса чрез value === null, а не чрез !value, което съвпада и с празен низ. Съхранените числа и обекти не възстановяват автоматично първоначалните си типове.
Това е уеб API, дефиниран в HTML Living Standard, а не функция на конкретно издание на ECMAScript. Съвременните браузъри го поддържат широко; версията на Node в хранилището не доказва поддръжка от браузъри. Самият достъп до window.localStorage или window.sessionStorage може да доведе до SecurityError заради непрозрачен произход или правила на браузъра.
Примерът разграничава празен низ, низа "42" и липсващ запис. Избира неизползван ключ и премахва временния запис, за да провери дали прочитането връща null. Блокът finally повтаря премахването, за да не остане временният запис дори при грешка, без да изчиства цялото хранилище.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.getItem: empty and missing values</title>
</head>
<body>
<h1>Reading a storage value</h1>
<p id="source"></p>
<script>
function readValues(storage) {
let key = 'cktis:getItem';
while (storage.getItem(key) !== null) key += ':';
try {
storage.setItem(key, '');
const empty = storage.getItem(key);
storage.setItem(key, '42');
const text = storage.getItem(key);
storage.removeItem(key);
return [JSON.stringify(empty), JSON.stringify(text), storage.getItem(key) === null];
} finally {
storage.removeItem(key);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = readValues(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = error.name === 'QuotaExceededError'
? 'Could not write the demo value to sessionStorage. Existing entries may still be readable. Using an in-memory fixture, not Web Storage.'
: 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
const entries = new Map();
lines = readValues({
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>Резултат
"" "42" true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.