Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onstorage — gestionar cambios de Web Storage

El atributo onstorage de body establece el controlador de Window para el evento storage. Permite responder a cambios en localStorage o sessionStorage compartidos que se realizan en otro documento, no en el documento que efectúa la escritura.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

onstorage es un atributo de controlador de eventos en body, no un atributo global. Su valor contiene código JavaScript con el parámetro event disponible. Gestiona el evento storage del objeto Window, no un evento dirigido al propio body. Su equivalente en JavaScript es window.onstorage: asignar una función nueva sustituye al controlador existente, y asignar null lo elimina.

Un cambio real en el almacenamiento notifica de forma asíncrona a otros documentos que comparten esa área de almacenamiento, pero no al documento que realiza la escritura. En el caso de localStorage, pueden ser otras pestañas del mismo origen. En el de sessionStorage, también deben pertenecer al mismo contexto de navegación de nivel superior, como los marcos de una misma pestaña. Escribir un valor idéntico no genera ninguna notificación.

StorageEvent expone key, oldValue, newValue, la url del documento que realiza el cambio y storageArea. Para una clave nueva, oldValue es null; para una clave eliminada, newValue es null; y clear() establece los tres campos de datos en null. Una operación que no cambia nada no envía ninguna notificación.

El ejemplo dispara un evento sintético sin modificar el almacenamiento para mostrar el funcionamiento del atributo de forma determinista. No comprueba la comunicación entre documentos. Para ejecutarlo, JavaScript debe estar habilitado y los controladores de eventos inline deben estar permitidos.

Ejemplos

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

Resultado

theme: light -> dark

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes