cookie.js: document.cookie for human

Breaking Changes in v7.0.0

The samesite option has been renamed to sameSite to align with the camelCase convention.

Usage

$3

``js
import cookie from 'cookie.js';
`

You can use the default cookie instance to set, get, and remove cookies. The default instance is created with empty options.

$3

`js
import { Cookie } from 'cookie.js';

const cookieInstance = new Cookie({
domain: 'example.com',
path: '/',
secure: true,
// ...other options
});
`

You can create a new instance of the Cookie class optionally passing an Options object to set default properties for the cookies it manages:

$3

To set a cookie, you can use the set method, passing the name and value of the cookie, along with an optional Options object to set specific properties for that cookie:

`js
cookie.set('name', 'value', {
maxAge: 3600,
sameSite: 'lax',
// ...other options
});
`

$3

To retrieve the value of a cookie, you can use the get method, passing the name of the cookie:

`js
const value = cookie.get('name');
console.log(value);
`

$3

To remove a cookie, you can use the remove method, passing the name of the cookie and optionally, an Options object to specify removal conditions:

`js
cookie.remove('name');
`




API Reference

$3

- constructor(options?: Options): Creates a new Cookie instance with the specified options.

- set(name: string, value: string, options?: Options): void: Sets a cookie with the specified name, value, and options. value will be encoded using encodeURIComponent().

- get(name: string): string | undefined: Retrieves the value of the cookie with the specified name. value will be decoded using decodeURIComponent(). If the cookie does not exist, undefined will be returned.

- remove(name: string, options?: Options): void: Removes the cookie with the specified name, using the specified options.

$3

Please refer to the MDN documentation for more information on the options that can be set for a cookie.

- domain: A string representing the domain for the cookie.
- expires: A number, string, or Date object representing when the cookie should expire. If specified as a number, it is interpreted as a timestamp (the number of milliseconds since midnight at the beginning of January 1, 1970, UTC — a.k.a. the epoch). If specified as a string, it should adhere to the format returned by the Date.toUTCString() method.

- maxAge: A number representing the maximum age of the cookie in seconds.
- partitioned: A boolean indicating whether the cookie should be stored using partitioned storage. See Cookies Having Independent Partitioned State (CHIPS) for more details.
- path: A string representing the path for the cookie.
- sameSite: A string representing the SameSite attribute for the cookie. The possible values for this attribute are Lax, Strict, or None.
- secure: A boolean` indicating whether the cookie should be transmitted over secure channels only.

License

MIT