cdpfleet Docs Sign up free

Launch options

profile

Restore a saved browser profile and save it again when the session ends.

Use it for: Staying logged in between sessions: log in once, then every later launch starts with the same cookies and storage (and, on Camoufox, the same device).

Browsers: Google Chrome, Microsoft Edge, Brave, Opera, Yandex Browser, Chromium, Patchright, Camoufox, Firefox, WebKit.

Details

A name ("shop-login", up to 64 letters, digits, -, _) or { "id": "shop-login", "mode": "readonly" }. The first launch with a new name creates the profile; later launches restore its cookies, localStorage and IndexedDB, and the profile is saved when the session ends. Session cookies are kept too; sessionStorage (per tab) is not. Work in browser.contexts()[0] — a context made with newContext() is not saved. "mode": "readonly" restores without saving and can run in parallel; a second normal session gets 409 profile_in_use. On Camoufox the device fingerprint is kept with the profile. See Persistent profiles.

Every browser except Whale and Rebrowser. Keeps cookies (session cookies too), localStorage and IndexedDB; not sessionStorage. 20 profiles per shared thread and 30 per dedicated thread (at least 100), 50 MB each; list and delete with /v1/me/profiles.

Used in

1 more in cases and recipes.

All options: launch options.