80 lines
2.4 KiB
JavaScript
80 lines
2.4 KiB
JavaScript
|
|
// 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;
|