@analytics/cookie-utils — Tiny cookie utility library. One of the small, focused utility packages that power the analytics library, usable standalone.

Legacy package name: analytics-util-cookie.

Full documentation, synced from the package README:

A tiny cookie utility library with fallbacks in 476 bytes.

This module will automatically fail back to global window storage if cookies are not available.

Exposes hasCookies, getCookie, setCookie, & removeCookie functions.

See live demo.

How to install

Install @analytics/cookie-utils from npm.

npm install @analytics/cookie-utils

API

Below is the api for @analytics/cookie-utils. These utilities are tree-shakable.

hasCookies

Check if cookies are supported. Will verify browser will accept cookies

import { hasCookies } from '@analytics/cookie-utils'

if (hasCookies()) {
  // Use them 🍪
}

getCookie

Get a cookie value.

import { getCookie } from '@analytics/cookie-utils'

const value = getCookie('cookie-key')

setCookie

Set a cookie value.

import { setCookie } from '@analytics/cookie-utils'

/* simple set */
setCookie('test', 'a')

/* complex set - cookie(name, value, ttl, path, domain, secure) */
setCookie('test', 'a', 60*60*24, '/api', '*.example.com', true)

removeCookie

Remove a cookie.

import { removeCookie } from '@analytics/cookie-utils'

removeCookie('cookie-key')