File Explorer

1'use strict'2 3const { parseSetCookie } = require('./parse')4const { stringify } = require('./util')5const { webidl } = require('../fetch/webidl')6const { Headers } = require('../fetch/headers')7 8/**9 * @typedef {Object} Cookie10 * @property {string} name11 * @property {string} value12 * @property {Date|number|undefined} expires13 * @property {number|undefined} maxAge14 * @property {string|undefined} domain15 * @property {string|undefined} path16 * @property {boolean|undefined} secure17 * @property {boolean|undefined} httpOnly18 * @property {'Strict'|'Lax'|'None'} sameSite19 * @property {string[]} unparsed20 */21 22/**23 * @param {Headers} headers24 * @returns {Record<string, string>}25 */26function getCookies (headers) {27  webidl.argumentLengthCheck(arguments, 1, 'getCookies')28 29  webidl.brandCheck(headers, Headers, { strict: false })30 31  const cookie = headers.get('cookie')32  const out = {}33 34  if (!cookie) {35    return out36  }37 38  for (const piece of cookie.split(';')) {39    const [name, ...value] = piece.split('=')40 41    out[name.trim()] = value.join('=')42  }43 44  return out45}46 47/**48 * @param {Headers} headers49 * @param {string} name50 * @param {{ path?: string, domain?: string }|undefined} attributes51 * @returns {void}52 */53function deleteCookie (headers, name, attributes) {54  webidl.brandCheck(headers, Headers, { strict: false })55 56  const prefix = 'deleteCookie'57  webidl.argumentLengthCheck(arguments, 2, prefix)58 59  name = webidl.converters.DOMString(name, prefix, 'name')60  attributes = webidl.converters.DeleteCookieAttributes(attributes)61 62  // Matches behavior of63  // https://github.com/denoland/deno_std/blob/63827b16330b82489a04614027c33b7904e08be5/http/cookie.ts#L27864  setCookie(headers, {65    name,66    value: '',67    expires: new Date(0),68    ...attributes69  })70}71 72/**73 * @param {Headers} headers74 * @returns {Cookie[]}75 */76function getSetCookies (headers) {77  webidl.argumentLengthCheck(arguments, 1, 'getSetCookies')78 79  webidl.brandCheck(headers, Headers, { strict: false })80 81  const cookies = headers.getSetCookie()82 83  if (!cookies) {84    return []85  }86 87  return cookies.map((pair) => parseSetCookie(pair))88}89 90/**91 * @param {Headers} headers92 * @param {Cookie} cookie93 * @returns {void}94 */95function setCookie (headers, cookie) {96  webidl.argumentLengthCheck(arguments, 2, 'setCookie')97 98  webidl.brandCheck(headers, Headers, { strict: false })99 100  cookie = webidl.converters.Cookie(cookie)101 102  const str = stringify(cookie)103 104  if (str) {105    headers.append('Set-Cookie', str)106  }107}108 109webidl.converters.DeleteCookieAttributes = webidl.dictionaryConverter([110  {111    converter: webidl.nullableConverter(webidl.converters.DOMString),112    key: 'path',113    defaultValue: () => null114  },115  {116    converter: webidl.nullableConverter(webidl.converters.DOMString),117    key: 'domain',118    defaultValue: () => null119  }120])121 122webidl.converters.Cookie = webidl.dictionaryConverter([123  {124    converter: webidl.converters.DOMString,125    key: 'name'126  },127  {128    converter: webidl.converters.DOMString,129    key: 'value'130  },131  {132    converter: webidl.nullableConverter((value) => {133      if (typeof value === 'number') {134        return webidl.converters['unsigned long long'](value)135      }136 137      return new Date(value)138    }),139    key: 'expires',140    defaultValue: () => null141  },142  {143    converter: webidl.nullableConverter(webidl.converters['long long']),144    key: 'maxAge',145    defaultValue: () => null146  },147  {148    converter: webidl.nullableConverter(webidl.converters.DOMString),149    key: 'domain',150    defaultValue: () => null151  },152  {153    converter: webidl.nullableConverter(webidl.converters.DOMString),154    key: 'path',155    defaultValue: () => null156  },157  {158    converter: webidl.nullableConverter(webidl.converters.boolean),159    key: 'secure',160    defaultValue: () => null161  },162  {163    converter: webidl.nullableConverter(webidl.converters.boolean),164    key: 'httpOnly',165    defaultValue: () => null166  },167  {168    converter: webidl.converters.USVString,169    key: 'sameSite',170    allowedValues: ['Strict', 'Lax', 'None']171  },172  {173    converter: webidl.sequenceConverter(webidl.converters.DOMString),174    key: 'unparsed',175    defaultValue: () => new Array(0)176  }177])178 179module.exports = {180  getCookies,181  deleteCookie,182  getSetCookies,183  setCookie184}185