CKTIS / HTML
onstorage — obsługa zmian Web Storage
Atrybut onstorage elementu body ustawia procedurę obsługi zdarzenia storage na Window. Pozwala reagować na zmiany współdzielonego localStorage lub sessionStorage dokonane w innym dokumencie, a nie w dokumencie wykonującym zapis.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onstorage="handleStorage(event)">…</body>
window.onstorage = handleStorage;onstorage to atrybut obsługi zdarzenia na elemencie body, a nie atrybut globalny. Jego wartość zawiera kod JavaScript z dostępnym parametrem event. Obsługuje zdarzenie storage obiektu Window, nie samego elementu body. W JavaScript odpowiada mu window.onstorage; przypisanie nowej funkcji zastępuje dotychczasową procedurę, a przypisanie null ją usuwa.
Rzeczywista zmiana magazynu powoduje asynchroniczne powiadomienie innych dokumentów współdzielących ten magazyn, nie dokumentu wykonującego zapis. Dla localStorage mogą to być inne karty tego samego pochodzenia. Dla sessionStorage muszą one dodatkowo należeć do tego samego kontekstu najwyższego poziomu, np. ramki w tej samej karcie. Zapis identycznej wartości nie wywołuje powiadomienia.
Obiekt StorageEvent udostępnia key, oldValue, newValue, url dokumentu dokonującego zmiany oraz storageArea. Nowy klucz ma oldValue równe null, usunięty klucz ma newValue równe null, a clear() ustawia wszystkie trzy pola danych na null. Operacja, która niczego nie zmienia, nie wysyła powiadomienia.
Przykład wysyła syntetyczne zdarzenie bez modyfikowania magazynu, aby deterministycznie pokazać działanie atrybutu. Nie sprawdza komunikacji między dokumentami. Uruchomienie wymaga włączonego JavaScript i zezwolenia na obsługę zdarzeń zapisaną bezpośrednio w HTML.
Przykłady
<!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>Wynik
theme: light -> dark
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.