[Feature]: Save Session Storage when extracting the browser Storage State

[AbdelrahmanFahd]

🚀 Feature Request

Extend the storageState() method to capture and restore sessionStorage alongside cookies and localStorage.
This would allow us to save and reload the complete browser storage state, including session-specific data.

Example

`// Save storage state including sessionStorage
await page.context().storageState({ path: 'auth-state.json', sessionStorage: true })

// Restore all storage types from saved state
const browser = await chromium.launch();
const context = await browser.newContext({
storageState: 'auth-state.json' // Automatically restores cookies, localStorage, and sessionStorage
});`

Motivation

Many modern web applications store critical authentication tokens, temporary user preferences, or application state in sessionStorage rather than localStorage. Currently, Playwright's storageState() doesn't capture sessionStorage, forcing us to:

• Manually extract and restore sessionStorage using page.evaluate()
• Write custom helper functions to work around this limitation

Adding sessionStorage support would:

• Improve test reliability: Preserve complete browser state between test runs
• Reduce test setup time: Eliminate redundant authentication/initialization steps
• Enhance API consistency: Make storageState() comprehensive for all Web Storage APIs
• Simplify test code: Remove boilerplate for manual sessionStorage management

This feature would be particularly valuable for applications using OAuth flows, SPAs with session-based state management, or any system relying on sessionStorage for functionality.

[dgozman]

@AbdelrahmanFahd Please take a look at our docs about session storage, and let me know whether that helps.

Unfortunately, making it work in a generic manner is a tricky API problem. Session storage is not persistent but rather bound to a particular page, so it should be restored to a specific page that's not even created yet at the time you specify the storage state option.

[AbdelrahmanFahd]

@dgozman , Thank you a lot. The docs were very helpful, and I’ve successfully implemented the approach.
But for reducing boilerplate, could we consider a small convenience API that loads sessionStorage from a file for the current page’s origin

await page.setSessionStorage(sessionFilePath)
This keeps sessionStorage page-scoped and non‑persistent, but saves us from repeating inline

[dgozman]

@AbdelrahmanFahd Your suggestion is nice, but we think it's not worth it have a dedicated API for such a niche case. You can easily implement this helper in your own test harness, while Playwright library focuses on providing enabling primitives and convenience APIs that are widely used. Thank you for the suggestion!

I'll close this issue, since there is no action item here. Thank you for filing!