CKTIS / HTML
onstorage — wijzigingen in Web Storage afhandelen
Het attribuut onstorage op body stelt de Window-handler voor het storage-event in. Hiermee reageer je op wijzigingen in gedeelde localStorage of sessionStorage die in een ander document zijn gemaakt, niet in het document dat de schrijfopdracht uitvoert.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onstorage="handleStorage(event)">…</body>
window.onstorage = handleStorage;onstorage is een eventhandlerattribuut op body, geen globaal attribuut. De waarde bevat JavaScript-code met de beschikbare parameter event. Het handelt het storage-event van het Window-object af, niet een event dat op body zelf is gericht. De JavaScript-tegenhanger is window.onstorage: een nieuwe functie toewijzen vervangt de bestaande handler, en null toewijzen verwijdert deze.
Een echte opslagwijziging stelt andere documenten die hetzelfde opslaggebied delen asynchroon op de hoogte, maar niet het document dat de schrijfopdracht uitvoert. Bij localStorage kunnen dit andere tabbladen van dezelfde origin zijn. Bij sessionStorage moeten ze bovendien tot dezelfde browsingcontext op het hoogste niveau behoren, zoals frames binnen hetzelfde tabblad. Een identieke waarde schrijven veroorzaakt geen melding.
StorageEvent biedt key, oldValue, newValue, de url van het document dat de wijziging uitvoert en storageArea. Bij een nieuwe sleutel is oldValue gelijk aan null; bij een verwijderde sleutel is newValue gelijk aan null; en clear() zet alle drie gegevensvelden op null. Een bewerking die niets verandert, verstuurt geen melding.
Het voorbeeld verstuurt een synthetisch event zonder de opslag te wijzigen, zodat de werking van het attribuut deterministisch wordt getoond. Het test geen communicatie tussen documenten. Voor uitvoering moet JavaScript zijn ingeschakeld en moeten inline eventhandlers zijn toegestaan.
Voorbeelden
<!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>Resultaat
theme: light -> dark
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.