summaryrefslogtreecommitdiff
path: root/node_modules/needle/lib/cookies.js
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/needle/lib/cookies.js')
-rw-r--r--node_modules/needle/lib/cookies.js79
1 files changed, 79 insertions, 0 deletions
diff --git a/node_modules/needle/lib/cookies.js b/node_modules/needle/lib/cookies.js
new file mode 100644
index 0000000..0f48afc
--- /dev/null
+++ b/node_modules/needle/lib/cookies.js
@@ -0,0 +1,79 @@
+
+// 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;