Skip to Content
Cookies

Cookies

Cookie stores mirror the async Cookie Store API , and work in every browser:

import { createCookieStore, oneOf } from 'parsistent'; export const appCookies = createCookieStore( { theme: oneOf(['light', 'dark'], 'light') }, { maxAge: 60 * 60 * 24 * 365, sameSite: 'lax' } // default attributes ); await appCookies.get('theme'); // 'light' | 'dark' await appCookies.set('theme', 'dark', { secure: true }); await appCookies.delete('theme'); appCookies.addEventListener('change', (event) => {});
 

Attributes

AttributeDescription
pathURL path the cookie is sent for (default: /)
domainDomain the cookie is sent to, e.g. to include subdomains
maxAgeLifetime in seconds
expiresExpiry date, or a timestamp in milliseconds
sameSite'strict', 'lax' or 'none' (which requires secure)
secureOnly send the cookie over HTTPS
partitionedPartition the cookie per top-level site (CHIPS)

Without maxAge or expires, the cookie lasts for the browser session. Set default attributes when creating the store, and override them per call.

change events cover the current tab in every browser, and other tabs (and cookies set by the server) in browsers with the native Cookie Store API.

On the server

// Route handlers, middleware… const theme = appCookies.fromHeader(request).get('theme'); // Set a cookie in a response response.headers.append('Set-Cookie', appCookies.serialize('theme', 'dark'));

fromHeader accepts a Cookie header string, a Request, Headers, a record, or anything with getAll() such as Next.js cookies(). serialize returns a deletion header when the value is null or equals the default.

Last updated on