Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

onstorage — obrada promjena Web Storagea

Atribut onstorage na body postavlja rukovatelj događajem storage na objektu Window. Omogućuje reakciju na promjene dijeljenog localStoragea ili sessionStoragea napravljene u drugom dokumentu, a ne u dokumentu koji izvršava zapis.

Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<body onstorage="handleStorage(event)">…</body>
window.onstorage = handleStorage;

onstorage je atribut za rukovanje događajima na elementu body, a ne globalni atribut. Njegova vrijednost sadrži JavaScript kod s dostupnim parametrom event. Rukuje događajem storage objekta Window, a ne događajem usmjerenim na sam body. Njegov je JavaScript ekvivalent window.onstorage; dodjela nove funkcije zamjenjuje postojeći rukovatelj, a dodjela vrijednosti null uklanja ga.

Stvarna promjena pohrane asinkrono obavještava druge dokumente koji dijele to područje pohrane, ali ne i dokument koji izvršava zapis. Za localStorage to mogu biti druge kartice istog podrijetla. Za sessionStorage moraju pripadati i istom kontekstu pregledavanja najviše razine, primjerice biti okviri unutar iste kartice. Zapis istovjetne vrijednosti ne pokreće obavijest.

StorageEvent izlaže key, oldValue, newValue, url dokumenta koji je napravio promjenu i storageArea. Za novi ključ oldValue je null, za uklonjeni ključ newValue je null, a clear() postavlja sva tri podatkovna polja na null. Operacija koja ništa ne promijeni ne šalje obavijest.

Primjer pokreće sintetički događaj bez mijenjanja pohrane kako bi deterministički prikazao rad atributa. Ne testira komunikaciju između dokumenata. Za izvođenje moraju biti omogućeni JavaScript i inline rukovatelji događajima.

Primjeri

<!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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori