Bokal › export cookies playwright

How to export a site's cookies as Playwright storageState

Log in once by hand in your browser, export the session, and drop it straight into your Playwright or Puppeteer suite — instead of scripting the login flow.

Last updated 26 August 2026. Competitor details below were verified against published manifests and repositories on that date.

Steps

1. Log in normally

   In Chrome, sign in to the site as you usually would. Complete any MFA. You want the browser holding a valid session.

2. Open Bokal on that tab

   Click the Bokal toolbar icon. Grant access to that one site when prompted — Bokal asks only for the origin you are on.

3. Export for automation

   In the toolbar, open the Export for… dropdown and choose Playwright storageState. Save the file as storageState.json next to your tests. The same dropdown also offers Playwright addCookies and Puppeteer setCookie.

4. Point Playwright at it

   Load it per-context, or globally in your config.

Per test context

const context = await browser.newContext({
  storageState: 'storageState.json',
});
const page = await context.newPage();
await page.goto('https://example.com/dashboard'); // already signed in

For the whole project

// playwright.config.ts
export default defineConfig({
  use: { storageState: 'storageState.json' },
});

Puppeteer

Choose Puppeteer setCookie in the same dropdown, then:

const cookies = JSON.parse(fs.readFileSync('cookies.json', 'utf8'));
await page.setCookie(...cookies);
await page.goto('https://example.com/dashboard');

What the file looks like

Playwright's storageState format is an object with a cookies array and an origins array:

{
  "cookies": [
    {
      "name": "session",
      "value": "…",
      "domain": ".example.com",
      "path": "/",
      "expires": 1788000000,
      "httpOnly": true,
      "secure": true,
      "sameSite": "Lax"
    }
  ],
  "origins": []
}

Because Bokal can read and write HttpOnly cookies, session cookies that a document.cookie-based tool cannot see are included.

Other formats

• Playwright addCookies — a bare array for context.addCookies(...) when you would rather not use a storage-state file.
• Cookie header string — copies a name=value; name=value string to the clipboard, for curl or an HTTP client.
• Netscape cookies.txt — for curl's --cookie-jar, wget, yt-dlp and similar. Export only; Bokal does not import this format.
• JSON — Bokal's own format, and it also reads Cookie-Editor and EditThisCookie exports.

Going the other way

Import works too: feed Bokal a storageState.json or a Playwright/Puppeteer cookie array and it will write those cookies into the live browser session. That is useful for debugging what your test framework actually produced, in a real browser, with real rendering.

Frequently asked