1# Storage Management
2 
3Manage cookies, localStorage, sessionStorage, and browser storage state.
4 
5## Storage State
6 
7Save and restore complete browser state including cookies and storage.
8 
9### Save Storage State
10 
11```bash
12# Save to auto-generated filename (storage-state-{timestamp}.json)
13playwright-cli state-save
14 
15# Save to specific filename
16playwright-cli state-save my-auth-state.json
17```
18 
19### Restore Storage State
20 
21```bash
22# Load storage state from file
23playwright-cli state-load my-auth-state.json
24 
25# Reload page to apply cookies
26playwright-cli open https://example.com
27```
28 
29### Storage State File Format
30 
31The saved file contains:
32 
33```json
34{
35  "cookies": [
36    {
37      "name": "session_id",
38      "value": "abc123",
39      "domain": "example.com",
40      "path": "/",
41      "expires": 1735689600,
42      "httpOnly": true,
43      "secure": true,
44      "sameSite": "Lax"
45    }
46  ],
47  "origins": [
48    {
49      "origin": "https://example.com",
50      "localStorage": [
51        { "name": "theme", "value": "dark" },
52        { "name": "user_id", "value": "12345" }
53      ]
54    }
55  ]
56}
57```
58 
59## Cookies
60 
61### List All Cookies
62 
63```bash
64playwright-cli cookie-list
65```
66 
67### Filter Cookies by Domain
68 
69```bash
70playwright-cli cookie-list --domain=example.com
71```
72 
73### Filter Cookies by Path
74 
75```bash
76playwright-cli cookie-list --path=/api
77```
78 
79### Get Specific Cookie
80 
81```bash
82playwright-cli cookie-get session_id
83```
84 
85### Set a Cookie
86 
87```bash
88# Basic cookie
89playwright-cli cookie-set session abc123
90 
91# Cookie with options
92playwright-cli cookie-set session abc123 --domain=example.com --path=/ --httpOnly --secure --sameSite=Lax
93 
94# Cookie with expiration (Unix timestamp)
95playwright-cli cookie-set remember_me token123 --expires=1735689600
96```
97 
98### Delete a Cookie
99 
100```bash
101playwright-cli cookie-delete session_id
102```
103 
104### Clear All Cookies
105 
106```bash
107playwright-cli cookie-clear
108```
109 
110### Advanced: Multiple Cookies or Custom Options
111 
112For complex scenarios like adding multiple cookies at once, use `run-code`:
113 
114```bash
115playwright-cli run-code "async page => {
116  await page.context().addCookies([
117    { name: 'session_id', value: 'sess_abc123', domain: 'example.com', path: '/', httpOnly: true },
118    { name: 'preferences', value: JSON.stringify({ theme: 'dark' }), domain: 'example.com', path: '/' }
119  ]);
120}"
121```
122 
123## Local Storage
124 
125### List All localStorage Items
126 
127```bash
128playwright-cli localstorage-list
129```
130 
131### Get Single Value
132 
133```bash
134playwright-cli localstorage-get token
135```
136 
137### Set Value
138 
139```bash
140playwright-cli localstorage-set theme dark
141```
142 
143### Set JSON Value
144 
145```bash
146playwright-cli localstorage-set user_settings '{"theme":"dark","language":"en"}'
147```
148 
149### Delete Single Item
150 
151```bash
152playwright-cli localstorage-delete token
153```
154 
155### Clear All localStorage
156 
157```bash
158playwright-cli localstorage-clear
159```
160 
161### Advanced: Multiple Operations
162 
163For complex scenarios like setting multiple values at once, use `run-code`:
164 
165```bash
166playwright-cli run-code "async page => {
167  await page.evaluate(() => {
168    localStorage.setItem('token', 'jwt_abc123');
169    localStorage.setItem('user_id', '12345');
170    localStorage.setItem('expires_at', Date.now() + 3600000);
171  });
172}"
173```
174 
175## Session Storage
176 
177### List All sessionStorage Items
178 
179```bash
180playwright-cli sessionstorage-list
181```
182 
183### Get Single Value
184 
185```bash
186playwright-cli sessionstorage-get form_data
187```
188 
189### Set Value
190 
191```bash
192playwright-cli sessionstorage-set step 3
193```
194 
195### Delete Single Item
196 
197```bash
198playwright-cli sessionstorage-delete step
199```
200 
201### Clear sessionStorage
202 
203```bash
204playwright-cli sessionstorage-clear
205```
206 
207## IndexedDB
208 
209### List Databases
210 
211```bash
212playwright-cli run-code "async page => {
213  return await page.evaluate(async () => {
214    const databases = await indexedDB.databases();
215    return databases;
216  });
217}"
218```
219 
220### Delete Database
221 
222```bash
223playwright-cli run-code "async page => {
224  await page.evaluate(() => {
225    indexedDB.deleteDatabase('myDatabase');
226  });
227}"
228```
229 
230## Common Patterns
231 
232### Authentication State Reuse
233 
234```bash
235# Step 1: Login and save state
236playwright-cli open https://app.example.com/login
237playwright-cli snapshot
238playwright-cli fill e1 "[email protected]"
239playwright-cli fill e2 "password123"
240playwright-cli click e3
241 
242# Save the authenticated state
243playwright-cli state-save auth.json
244 
245# Step 2: Later, restore state and skip login
246playwright-cli state-load auth.json
247playwright-cli open https://app.example.com/dashboard
248# Already logged in!
249```
250 
251### Save and Restore Roundtrip
252 
253```bash
254# Set up authentication state
255playwright-cli open https://example.com
256playwright-cli eval "() => { document.cookie = 'session=abc123'; localStorage.setItem('user', 'john'); }"
257 
258# Save state to file
259playwright-cli state-save my-session.json
260 
261# ... later, in a new session ...
262 
263# Restore state
264playwright-cli state-load my-session.json
265playwright-cli open https://example.com
266# Cookies and localStorage are restored!
267```
268 
269## Security Notes
270 
271- Never commit storage state files containing auth tokens
272- Add `*.auth-state.json` to `.gitignore`
273- Delete state files after automation completes
274- Use environment variables for sensitive data
275- By default, sessions run in-memory mode which is safer for sensitive operations
276