CKTIS / HTML
onstorage — obravnava sprememb Web Storage
Atribut onstorage na body nastavi obravnavo dogodka storage na objektu Window. Omogoča odziv na spremembe v skupni rabi localStorage ali sessionStorage, ki so bile izvedene v drugem dokumentu, ne pa v dokumentu, ki izvaja zapis.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onstorage="handleStorage(event)">…</body>
window.onstorage = handleStorage;onstorage je atribut za obravnavo dogodkov na elementu body, ne globalni atribut. Njegova vrednost vsebuje kodo JavaScript z razpoložljivim parametrom event. Obravnava dogodek storage objekta Window, ne dogodka, usmerjenega na sam body. Njegov ustreznik v JavaScriptu je window.onstorage; dodelitev nove funkcije zamenja obstoječo obravnavo, dodelitev null pa jo odstrani.
Dejanska sprememba shrambe asinhrono obvesti druge dokumente, ki si delijo to območje shrambe, ne pa dokumenta, ki izvaja zapis. Pri localStorage so to lahko drugi zavihki istega izvora. Pri sessionStorage morajo pripadati tudi istemu vrhnjemu kontekstu brskanja, na primer biti okvirji v istem zavihku. Zapis enake vrednosti ne sproži obvestila.
StorageEvent razkriva key, oldValue, newValue, url dokumenta, ki je izvedel spremembo, in storageArea. Pri novem ključu je oldValue enak null, pri odstranjenem ključu je newValue enak null, clear() pa nastavi vsa tri podatkovna polja na null. Operacija, ki ničesar ne spremeni, ne pošlje obvestila.
Primer sproži sintetični dogodek brez spreminjanja shrambe, da deterministično prikaže delovanje atributa. Ne preizkuša komunikacije med dokumenti. Za zagon morata biti omogočena JavaScript in vstavljena obravnava dogodkov.
Primeri
<!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>Rezultat
theme: light -> dark
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.