CKTIS / HTML
onstorage — обработване на промени в Web Storage
Атрибутът onstorage на body задава обработчика на Window за събитието storage. Той позволява реакция на промени в споделен localStorage или sessionStorage, направени в друг документ, а не в документа, който извършва записа.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<body onstorage="handleStorage(event)">…</body>
window.onstorage = handleStorage;onstorage е атрибут за обработчик на събития върху body, а не глобален атрибут. Стойността му съдържа JavaScript код с наличен параметър event. Той обработва събитието storage на обекта Window, а не събитие, насочено към самия body. Съответствието му в JavaScript е window.onstorage; присвояването на нова функция заменя съществуващия обработчик, а присвояването на null го премахва.
Реална промяна в хранилището асинхронно уведомява другите документи, които споделят тази област на хранилището, но не и документа, извършващ записа. При localStorage това може да са други раздели от същия произход. При sessionStorage те трябва допълнително да принадлежат към същия контекст на сърфиране от най-високо ниво, например рамки в същия раздел. Записването на идентична стойност не предизвиква уведомление.
StorageEvent предоставя key, oldValue, newValue, url на документа, извършил промяната, и storageArea. При нов ключ oldValue е null, при премахнат ключ newValue е null, а clear() задава и трите полета с данни на null. Операция, която не променя нищо, не изпраща уведомление.
Примерът задейства синтетично събитие, без да променя хранилището, за да покаже работата на атрибута по детерминиран начин. Той не тества комуникация между документи. За изпълнението му трябва JavaScript да е включен и inline обработчиците на събития да са разрешени.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onstorage demo</title>
<body onstorage="document.getElementById('result').textContent = event.key + ': ' + event.oldValue + ' -> ' + event.newValue">
<pre id="result">Waiting</pre>
<script>
window.dispatchEvent(new StorageEvent('storage', {
key: 'theme',
oldValue: 'light',
newValue: 'dark'
}));
</script>
</body>
</html>Резултат
theme: light -> dark
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.