CKTIS / HTML
onstorage — spracovanie zmien Web Storage
Atribút onstorage na body nastavuje obslužnú funkciu udalosti storage objektu Window. Umožňuje reagovať na zmeny zdieľaného localStorage alebo sessionStorage vykonané v inom dokumente, nie v dokumente, ktorý zapisuje.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onstorage="handleStorage(event)">…</body>
window.onstorage = handleStorage;onstorage je atribút obsluhy udalosti na prvku body, nie globálny atribút. Jeho hodnota obsahuje kód JavaScriptu s dostupným parametrom event. Obsluhuje udalosť storage objektu Window, nie udalosť smerovanú na samotný body. Jeho náprotivkom v JavaScripte je window.onstorage; priradenie novej funkcie nahradí existujúcu obslužnú funkciu a priradenie null ju odstráni.
Skutočná zmena úložiska asynchrónne upozorní iné dokumenty zdieľajúce túto oblasť úložiska, nie dokument, ktorý zapisuje. Pri localStorage to môžu byť iné karty rovnakého pôvodu. Pri sessionStorage musia navyše patriť do rovnakého kontextu prehliadania najvyššej úrovne, napríklad rámy v tej istej karte. Zápis rovnakej hodnoty upozornenie nevyvolá.
StorageEvent sprístupňuje key, oldValue, newValue, url dokumentu, ktorý zmenu vykonal, a storageArea. Pri novom kľúči je oldValue rovné null, pri odstránenom kľúči je newValue rovné null a clear() nastaví všetky tri dátové polia na null. Operácia, ktorá nič nezmení, neodošle žiadne upozornenie.
Príklad vyvolá syntetickú udalosť bez zmeny úložiska, aby deterministicky ukázal fungovanie atribútu. Netestuje komunikáciu medzi dokumentmi. Spustenie vyžaduje zapnutý JavaScript a povolené inline obslužné funkcie udalostí.
Prí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ýsledok
theme: light -> dark
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.