12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879 |
-
- // Simple cookie handling implementation based on the standard RFC 6265.
- //
- // This module just has two functionalities:
- // - Parse a set-cookie-header as a key value object
- // - Write a cookie-string from a key value object
- //
- // All cookie attributes are ignored.
-
- var unescape = require('querystring').unescape;
-
- var COOKIE_PAIR = /^([^=\s]+)\s*=\s*("?)\s*(.*)\s*\2\s*$/;
- var EXCLUDED_CHARS = /[\x00-\x1F\x7F\x3B\x3B\s\"\,\\"%]/g;
- var TRAILING_SEMICOLON = /\x3B+$/;
- var SEP_SEMICOLON = /\s*\x3B\s*/;
-
- // i know these should be 'const', but I'd like to keep
- // supporting earlier node.js versions as long as I can. :)
-
- var KEY_INDEX = 1; // index of key from COOKIE_PAIR match
- var VALUE_INDEX = 3; // index of value from COOKIE_PAIR match
-
- // Returns a copy str trimmed and without trainling semicolon.
- function cleanCookieString(str) {
- return str.trim().replace(/\x3B+$/, '');
- }
-
- function getFirstPair(str) {
- var index = str.indexOf('\x3B');
- return index === -1 ? str : str.substr(0, index);
- }
-
- // Returns a encoded copy of str based on RFC6265 S4.1.1.
- function encodeCookieComponent(str) {
- return str.toString().replace(EXCLUDED_CHARS, encodeURIComponent);
- }
-
- // Parses a set-cookie-string based on the standard defined in RFC6265 S4.1.1.
- function parseSetCookieString(str) {
- str = cleanCookieString(str);
- str = getFirstPair(str);
-
- var res = COOKIE_PAIR.exec(str);
- if (!res || !res[VALUE_INDEX]) return null;
-
- return {
- name : unescape(res[KEY_INDEX]),
- value : unescape(res[VALUE_INDEX])
- };
- }
-
- // Parses a set-cookie-header and returns a key/value object.
- // Each key represents the name of a cookie.
- function parseSetCookieHeader(header) {
- if (!header) return {};
- header = Array.isArray(header) ? header : [header];
-
- return header.reduce(function(res, str) {
- var cookie = parseSetCookieString(str);
- if (cookie) res[cookie.name] = cookie.value;
- return res;
- }, {});
- }
-
- // Writes a set-cookie-string based on the standard definded in RFC6265 S4.1.1.
- function writeCookieString(obj) {
- return Object.keys(obj).reduce(function(str, name) {
- var encodedName = encodeCookieComponent(name);
- var encodedValue = encodeCookieComponent(obj[name]);
- str += (str ? '; ' : '') + encodedName + '=' + encodedValue;
- return str;
- }, '');
- }
-
- // returns a key/val object from an array of cookie strings
- exports.read = parseSetCookieHeader;
-
- // writes a cookie string header
- exports.write = writeCookieString;
|