0.2.10 • Published 2 months ago

@analytics/cookie-utils v0.2.10

Weekly downloads
50,647
License
MIT
Repository
github
Last release
2 months ago

Cookie Utilities

A tiny cookie utility library with fallbacks in 472 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)

deleteCookie

Delete a cookie.

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

deleteCookie('cookie-key')