CKTIS / HTML
onstorage — zpracování změn Web Storage
Atribut onstorage na body nastavuje obslužnou rutinu události storage objektu Window. Umožňuje reagovat na změny sdíleného localStorage nebo sessionStorage provedené v jiném dokumentu, nikoli v dokumentu, který zápis provádí.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onstorage="handleStorage(event)">…</body>
window.onstorage = handleStorage;onstorage je atribut obsluhy události na prvku body, nikoli globální atribut. Jeho hodnota obsahuje kód JavaScriptu s dostupným parametrem event. Obsluhuje událost storage objektu Window, nikoli událost cílenou na samotný body. Odpovídá mu JavaScriptové window.onstorage; přiřazení nové funkce nahradí dosavadní obslužnou rutinu a přiřazení null ji odstraní.
Skutečná změna úložiště asynchronně upozorní ostatní dokumenty sdílející danou oblast úložiště, nikoli dokument, který zápis provádí. U localStorage může jít o jiné karty stejného původu. U sessionStorage navíc musí patřit do stejného kontextu prohlížení nejvyšší úrovně, například o rámce v téže kartě. Zápis stejné hodnoty upozornění nevyvolá.
StorageEvent zpřístupňuje key, oldValue, newValue, url dokumentu, který změnu provedl, a storageArea. U nového klíče je oldValue rovno null, u odstraněného klíče je newValue rovno null a clear() nastaví všechna tři datová pole na null. Operace, která nic nezmění, žádné upozornění neodešle.
Příklad vyvolá syntetickou událost, aniž by změnil úložiště, a deterministicky tak ukazuje fungování atributu. Netestuje komunikaci mezi dokumenty. Spuštění vyžaduje zapnutý JavaScript a povolené vložené obslužné rutiny událostí.
Příklady
<!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>Výsledek
theme: light -> dark
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.