Storage state en Playwright CLI: guardar sesiones de login, leer cookies y local storage

Tue, 14 Apr 2026 22:19:55 +0800

Si usas Playwright CLI para automatización de navegador, storage state es una de las funciones más útiles. Su tarea es simple: guardar la sesión de login actual y el estado local del navegador para reutilizarlos después en lugar de iniciar sesión cada vez.

01 Guardar el storage state actual

El flujo más común es iniciar sesión una vez y luego exportar el estado actual a un archivo.

`1`	`playwright-cli storage-state save auth.json`

Este comando guarda el estado del contexto de navegador actual en auth.json. Si quieres reutilizar una sesión iniciada más tarde, este suele ser el primer paso.

02 Cargar un storage state existente

Cuando ya tienes un archivo de estado, puedes cargarlo directamente al arrancar.

`1`	`playwright-cli --storage-state auth.json`

Inicia el contexto de navegador con el estado guardado en auth.json. El propósito habitual es evitar logins repetidos y entrar directamente en un entorno autenticado.

03 Ver cookies actuales

Si solo quieres revisar qué cookies existen en la sesión actual, puedes inspeccionarlas directamente.

`1`	`playwright-cli cookies`

Este comando lista las cookies del contexto actual. Es útil para comprobar si existe el estado de login o si las cookies se escribieron correctamente.

04 Configurar cookies

Si ya tienes datos de cookies, también puedes inyectarlos directamente.

`1`	`playwright-cli cookies set '[{"name":"session","value":"abc","domain":"example.com","path":"/"}]'`

Esto es útil para depuración de autenticación, reproducir una sesión específica o inyectar condiciones de cookies antes de ejecutar un script.

05 Leer localStorage

Algunos sitios guardan estado relacionado con login o frontend no solo en cookies, sino también en localStorage.

`1`	`playwright-cli local-storage`

Este comando muestra el contenido de localStorage de la página actual. Es especialmente útil cuando una página parece estar autenticada, pero sigue comportándose mal.

06 Escribir localStorage

Si necesitas simular un estado frontend específico, puedes configurarlo directamente.

`1`	`playwright-cli local-storage set token abc123`

Escribe la clave y el valor indicados en localStorage. Usos comunes incluyen inyectar un token, una preferencia o una bandera de frontend.

07 Leer sessionStorage

sessionStorage sirve para revisar estado temporal ligado a la sesión actual.

`1`	`playwright-cli session-storage`

Este comando muestra el sessionStorage de la página actual. Si un flujo depende de datos de sesión de un solo uso, este es un buen lugar para inspeccionarlo.

08 Escribir sessionStorage

Cuando haga falta, también puedes configurar sessionStorage manualmente.

`1`	`playwright-cli session-storage set key value`

Es útil para reproducir comportamiento de página que depende de estado temporal, o para completar campos requeridos por un paso de inicialización.

09 Ver IndexedDB

En aplicaciones web más pesadas, los datos locales más importantes pueden vivir realmente en IndexedDB.

`1`	`playwright-cli indexed-db`

Este comando permite inspeccionar los datos IndexedDB de la página actual. Conviene revisarlo primero cuando trabajas con SPAs complejas, caché offline o bases de datos locales tipo aplicación.

10 Un flujo práctico

Si tu objetivo es simplemente reutilizar de forma fiable una sesión de login, el flujo más práctico suele ser este:

Abre el sitio y completa el login manualmente.
Guarda el estado con este comando:

`1`	`playwright-cli storage-state save auth.json`

Cárgalo directamente en ejecuciones posteriores:

`1`	`playwright-cli --storage-state auth.json`

Si la página sigue comportándose mal después de cargarlo, continúa revisando:

playwright-cli cookies
playwright-cli local-storage
playwright-cli session-storage
playwright-cli indexed-db

Esa secuencia cubre la mayoría de casos donde el estado restaurado está incompleto.

11 Qué tener en cuenta

Tres puntos importan especialmente:

Un archivo de storage state contiene datos sensibles. Puede incluir cookies o tokens de login, así que no lo commitees casualmente.
Restaurar solo cookies puede no bastar. Muchos sitios modernos también dependen de localStorage, sessionStorage o IndexedDB.
Los archivos de estado no son válidos para siempre. Tras expiración de cookies, cambios de cuenta o cambios de entorno, normalmente hay que generarlos de nuevo.

12 Resumen rápido

Si solo recuerdas una frase:

storage state en Playwright CLI significa guardar el estado actual del navegador y reutilizarlo en tareas posteriores.

En la práctica, los comandos más útiles son:

playwright-cli storage-state save auth.json
playwright-cli --storage-state auth.json
playwright-cli cookies
playwright-cli local-storage
playwright-cli session-storage
playwright-cli indexed-db

Primero guarda y luego carga; si algo sigue viéndose mal, inspecciona cookies y las distintas capas de almacenamiento local una por una. Esa es la parte más práctica de esta referencia.

Referencias

Referencia storage-state de Playwright CLI: https://github.com/microsoft/playwright-cli/blob/main/skills/playwright-cli/references/storage-state.md
Página del proyecto Playwright CLI: https://github.com/microsoft/playwright-cli

Storage State on KnightLi Blog