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

CKTIS / JavaScript

Storage.clear() — eliminar todas las entradas

Storage.clear() elimina de forma síncrona todos los pares clave-valor del área de Web Storage seleccionada. No acepta argumentos y devuelve undefined. Ten cuidado: también elimina entradas que no están relacionadas con tu código.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

storage.clear()

Storage.clear opera sobre un objeto Storage: localStorage.clear() vacía el área local del origen correspondiente, mientras que sessionStorage.clear() vacía el área de sesión de ese origen y pestaña. No vacía ambas a la vez. Es una API del estándar HTML, no de ECMAScript.

El método es síncrono, no acepta argumentos y devuelve undefined. Si el área está vacía, seguirá vacía. Para eliminar una sola entrada, usa removeItem(key); clear() no filtra las claves por prefijo.

Al eliminar entradas, se pone en cola un evento storage para otros documentos autorizados que compartan el área, pero no para el documento que realiza la llamada. Sus campos key, oldValue y newValue tienen el valor null. Un área vacía no genera ningún evento.

El acceso a window.localStorage o window.sessionStorage puede generar una SecurityError, por ejemplo, debido a la política del navegador. En el ejemplo, el aislamiento del iframe mediante sandbox le da un origen opaco. typeof Storage.prototype.clear devuelve "function", pero al leer window.sessionStorage se lanza una SecurityError antes de que el código llame a clear(). No se elimina ninguna entrada. Para probar una llamada a sessionStorage.clear() que se complete correctamente, usa solo una pestaña y un origen reservados para pruebas: la llamada elimina todas las entradas del área de almacenamiento de sesión, incluidas las anteriores.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Storage.clear() and storage access</title>
</head>
<body>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Isolated Storage.clear test';
    frame.setAttribute('sandbox', 'allow-scripts');
    frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Storage clear test</title></head>
<body>
  <p role="status"></p>
  <script>
    const methodType = typeof Storage.prototype.clear;
    const methodStatus = 'typeof Storage.prototype.clear: ' + methodType;
    let resultStatus;
    try {
      const storage = window.sessionStorage;
      storage.setItem('demo:color', 'blue');
      storage.setItem('demo:count', '2');
      const result = storage.clear();
      resultStatus = 'Remaining entries: ' + storage.length + '; return value: ' + String(result);
    } catch (error) {
      resultStatus = 'Clear not completed: ' + error.name;
    }
    document.querySelector('[role="status"]').textContent = methodStatus + '. ' + resultStatus;
    console.log(methodStatus);
    console.log(resultStatus);
  <\/script>
</body>
</html>`;
    document.body.append(frame);
  </script>
</body>
</html>

Resultado

typeof Storage.prototype.clear: function
Clear not completed: SecurityError

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