File Explorer

1'use strict'2 3const { parseSetCookie } = require('./parse')4const { stringify } = require('./util')5const { webidl } = require('../webidl')6const { Headers } = require('../fetch/headers')7 8const brandChecks = webidl.brandCheckMultiple([Headers, globalThis.Headers].filter(Boolean))9 10/**11 * @typedef {Object} Cookie12 * @property {string} name13 * @property {string} value14 * @property {Date|number} [expires]15 * @property {number} [maxAge]16 * @property {string} [domain]17 * @property {string} [path]18 * @property {boolean} [secure]19 * @property {boolean} [httpOnly]20 * @property {'Strict'|'Lax'|'None'} [sameSite]21 * @property {string[]} [unparsed]22 */23 24/**25 * @param {Headers} headers26 * @returns {Record<string, string>}27 */28function getCookies (headers) {29  webidl.argumentLengthCheck(arguments, 1, 'getCookies')30 31  brandChecks(headers)32 33  const cookie = headers.get('cookie')34 35  /** @type {Record<string, string>} */36  const out = {}37 38  if (!cookie) {39    return out40  }41 42  for (const piece of cookie.split(';')) {43    const [name, ...value] = piece.split('=')44 45    out[name.trim()] = value.join('=')46  }47 48  return out49}50 51/**52 * @param {Headers} headers53 * @param {string} name54 * @param {{ path?: string, domain?: string }|undefined} attributes55 * @returns {void}56 */57function deleteCookie (headers, name, attributes) {58  brandChecks(headers)59 60  const prefix = 'deleteCookie'61  webidl.argumentLengthCheck(arguments, 2, prefix)62 63  name = webidl.converters.DOMString(name, prefix, 'name')64  attributes = webidl.converters.DeleteCookieAttributes(attributes)65 66  // Matches behavior of67  // https://github.com/denoland/deno_std/blob/63827b16330b82489a04614027c33b7904e08be5/http/cookie.ts#L27868  setCookie(headers, {69    name,70    value: '',71    expires: new Date(0),72    ...attributes73  })74}75 76/**77 * @param {Headers} headers78 * @returns {Cookie[]}79 */80function getSetCookies (headers) {81  webidl.argumentLengthCheck(arguments, 1, 'getSetCookies')82 83  brandChecks(headers)84 85  const cookies = headers.getSetCookie()86 87  if (!cookies) {88    return []89  }90 91  return cookies.map((pair) => parseSetCookie(pair))92}93 94/**95 * Parses a cookie string96 * @param {string} cookie97 */98function parseCookie (cookie) {99  cookie = webidl.converters.DOMString(cookie)100 101  return parseSetCookie(cookie)102}103 104/**105 * @param {Headers} headers106 * @param {Cookie} cookie107 * @returns {void}108 */109function setCookie (headers, cookie) {110  webidl.argumentLengthCheck(arguments, 2, 'setCookie')111 112  brandChecks(headers)113 114  cookie = webidl.converters.Cookie(cookie)115 116  const str = stringify(cookie)117 118  if (str) {119    headers.append('set-cookie', str, true)120  }121}122 123webidl.converters.DeleteCookieAttributes = webidl.dictionaryConverter([124  {125    converter: webidl.nullableConverter(webidl.converters.DOMString),126    key: 'path',127    defaultValue: () => null128  },129  {130    converter: webidl.nullableConverter(webidl.converters.DOMString),131    key: 'domain',132    defaultValue: () => null133  }134])135 136webidl.converters.Cookie = webidl.dictionaryConverter([137  {138    converter: webidl.converters.DOMString,139    key: 'name'140  },141  {142    converter: webidl.converters.DOMString,143    key: 'value'144  },145  {146    converter: webidl.nullableConverter((value) => {147      if (typeof value === 'number') {148        return webidl.converters['unsigned long long'](value)149      }150 151      return new Date(value)152    }),153    key: 'expires',154    defaultValue: () => null155  },156  {157    converter: webidl.nullableConverter(webidl.converters['long long']),158    key: 'maxAge',159    defaultValue: () => null160  },161  {162    converter: webidl.nullableConverter(webidl.converters.DOMString),163    key: 'domain',164    defaultValue: () => null165  },166  {167    converter: webidl.nullableConverter(webidl.converters.DOMString),168    key: 'path',169    defaultValue: () => null170  },171  {172    converter: webidl.nullableConverter(webidl.converters.boolean),173    key: 'secure',174    defaultValue: () => null175  },176  {177    converter: webidl.nullableConverter(webidl.converters.boolean),178    key: 'httpOnly',179    defaultValue: () => null180  },181  {182    converter: webidl.converters.USVString,183    key: 'sameSite',184    allowedValues: ['Strict', 'Lax', 'None']185  },186  {187    converter: webidl.sequenceConverter(webidl.converters.DOMString),188    key: 'unparsed',189    defaultValue: () => []190  }191])192 193module.exports = {194  getCookies,195  deleteCookie,196  getSetCookies,197  setCookie,198  parseCookie199}200