Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onstorage — gestire le modifiche a Web Storage

L’attributo onstorage su body imposta il gestore Window per l’evento storage. Consente di reagire alle modifiche a localStorage o sessionStorage condivisi effettuate in un altro documento, non in quello che esegue la scrittura.

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

Sintassi

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

onstorage è un attributo gestore di eventi su body, non un attributo globale. Il suo valore contiene codice JavaScript con il parametro event disponibile. Gestisce l’evento storage dell’oggetto Window, non un evento destinato a body stesso. Il corrispondente JavaScript è window.onstorage: assegnando una nuova funzione si sostituisce il gestore esistente, mentre assegnando null lo si rimuove.

Una modifica effettiva dello storage notifica in modo asincrono gli altri documenti che condividono quell’area di storage, ma non il documento che esegue la scrittura. Per localStorage, possono essere altre schede della stessa origine. Per sessionStorage, devono anche appartenere allo stesso contesto di navigazione di primo livello, per esempio frame nella stessa scheda. La scrittura di un valore identico non attiva alcuna notifica.

StorageEvent espone key, oldValue, newValue, la url del documento che effettua la modifica e storageArea. Per una nuova chiave, oldValue è null; per una chiave rimossa, newValue è null; e clear() imposta su null tutti e tre i campi dei dati. Un’operazione che non modifica nulla non invia notifiche.

L’esempio invia un evento sintetico senza modificare lo storage, per mostrare il funzionamento dell’attributo in modo deterministico. Non verifica la comunicazione tra documenti. Per eseguirlo, JavaScript deve essere attivo e i gestori di eventi inline devono essere consentiti.

Esempi

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

Risultato

theme: light -> dark

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti