Contexts

Browser cookies are stored in the user data directory. By default, Browserbase creates a new user data directory for each session.

For some use cases, such as authentication or caching, it can be helpful to preserve the user data directory and reuse it across sessions. With contexts, it’s easy.

​

Sharing Contexts across Sessions

One benefit of using contexts is that all the data generated during one session can be used in the next. This is especially useful to improve load times, as the network cache is also preserved.

Contexts are configured by creating a context via the Contexts API. Then, pass the context’s ID to every Create Sessions API call.

Make sure to set context.persist to true when creating a session if you want the context to be updated with the session’s state.

Here’s the steps:

To share contexts across sessions, follow these steps:

1. Use the Contexts API to create a new context. You’ll need the context ID for the next step.
2. Use the Sessions API to create a new session. You’ll need to add "browserSettings": { "context": { "id": YOUR_CONTEXT_ID, "persist": true } } to the body.

context.persist isn’t required for each session. A workflow might involve enabling it for the first session (to fill the cache) and then disabling it on subsequent ones.

​

Uploading your own custom user data directory

In some scenarios, it may make sense to upload a custom user data directory. That’s why the Create Contexts API returns an authenticated uploadUrl that enables this. The uploaded file must follow a specific pattern in order to work with sessions.

1. The uploaded context must have a filename of ${context.id}.zip
2. The ZIP must be encrypted using details from the Context API response

Below are code examples showing how to compress and encrypt a user data directory: