Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje