summaryrefslogtreecommitdiffstats
path: root/common/src/main/webapp/usageguide/appserver/node_modules/express/node_modules/vary/index.js
diff options
context:
space:
mode:
Diffstat (limited to 'common/src/main/webapp/usageguide/appserver/node_modules/express/node_modules/vary/index.js')
-rw-r--r--common/src/main/webapp/usageguide/appserver/node_modules/express/node_modules/vary/index.js124
1 files changed, 124 insertions, 0 deletions
diff --git a/common/src/main/webapp/usageguide/appserver/node_modules/express/node_modules/vary/index.js b/common/src/main/webapp/usageguide/appserver/node_modules/express/node_modules/vary/index.js
new file mode 100644
index 0000000..21dbaf1
--- /dev/null
+++ b/common/src/main/webapp/usageguide/appserver/node_modules/express/node_modules/vary/index.js
@@ -0,0 +1,124 @@
+/*!
+ * vary
+ * Copyright(c) 2014-2015 Douglas Christopher Wilson
+ * MIT Licensed
+ */
+
+'use strict';
+
+/**
+ * Module exports.
+ */
+
+module.exports = vary;
+module.exports.append = append;
+
+/**
+ * RegExp to match field-name in RFC 7230 sec 3.2
+ *
+ * field-name = token
+ * token = 1*tchar
+ * tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*"
+ * / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~"
+ * / DIGIT / ALPHA
+ * ; any VCHAR, except delimiters
+ */
+
+var fieldNameRegExp = /^[!#$%&'\*\+\-\.\^_`\|~0-9A-Za-z]+$/
+
+/**
+ * Append a field to a vary header.
+ *
+ * @param {String} header
+ * @param {String|Array} field
+ * @return {String}
+ * @api public
+ */
+
+function append(header, field) {
+ if (typeof header !== 'string') {
+ throw new TypeError('header argument is required');
+ }
+
+ if (!field) {
+ throw new TypeError('field argument is required');
+ }
+
+ // get fields array
+ var fields = !Array.isArray(field)
+ ? parse(String(field))
+ : field;
+
+ // assert on invalid field names
+ for (var i = 0; i < fields.length; i++) {
+ if (!fieldNameRegExp.test(fields[i])) {
+ throw new TypeError('field argument contains an invalid header name');
+ }
+ }
+
+ // existing, unspecified vary
+ if (header === '*') {
+ return header;
+ }
+
+ // enumerate current values
+ var val = header;
+ var vals = parse(header.toLowerCase());
+
+ // unspecified vary
+ if (fields.indexOf('*') !== -1 || vals.indexOf('*') !== -1) {
+ return '*';
+ }
+
+ for (var i = 0; i < fields.length; i++) {
+ var fld = fields[i].toLowerCase();
+
+ // append value (case-preserving)
+ if (vals.indexOf(fld) === -1) {
+ vals.push(fld);
+ val = val
+ ? val + ', ' + fields[i]
+ : fields[i];
+ }
+ }
+
+ return val;
+}
+
+/**
+ * Parse a vary header into an array.
+ *
+ * @param {String} header
+ * @return {Array}
+ * @api private
+ */
+
+function parse(header) {
+ return header.trim().split(/ *, */);
+}
+
+/**
+ * Mark that a request is varied on a header field.
+ *
+ * @param {Object} res
+ * @param {String|Array} field
+ * @api public
+ */
+
+function vary(res, field) {
+ if (!res || !res.getHeader || !res.setHeader) {
+ // quack quack
+ throw new TypeError('res argument is required');
+ }
+
+ // get existing header
+ var val = res.getHeader('Vary') || ''
+ var header = Array.isArray(val)
+ ? val.join(', ')
+ : String(val);
+
+ // set new header
+ if ((val = append(header, field))) {
+ res.setHeader('Vary', val);
+ }
+}