vnfmarket/src/main/webapp/vnfmarket/node_modules/method-override/node_modules/vary/index.js

   1 /*!
   2  * vary
   3  * Copyright(c) 2014-2015 Douglas Christopher Wilson
   4  * MIT Licensed
   5  */
   6
   7 'use strict';
   8
   9 /**
  10  * Module exports.
  11  */
  12
  13 module.exports = vary;
  14 module.exports.append = append;
  15
  16 /**
  17  * RegExp to match field-name in RFC 7230 sec 3.2
  18  *
  19  * field-name    = token
  20  * token         = 1*tchar
  21  * tchar         = "!" / "#" / "$" / "%" / "&" / "'" / "*"
  22  *               / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~"
  23  *               / DIGIT / ALPHA
  24  *               ; any VCHAR, except delimiters
  25  */
  26
  27 var fieldNameRegExp = /^[!#$%&'\*\+\-\.\^_`\|~0-9A-Za-z]+$/
  28
  29 /**
  30  * Append a field to a vary header.
  31  *
  32  * @param {String} header
  33  * @param {String|Array} field
  34  * @return {String}
  35  * @api public
  36  */
  37
  38 function append(header, field) {
  39   if (typeof header !== 'string') {
  40     throw new TypeError('header argument is required');
  41   }
  42
  43   if (!field) {
  44     throw new TypeError('field argument is required');
  45   }
  46
  47   // get fields array
  48   var fields = !Array.isArray(field)
  49     ? parse(String(field))
  50     : field;
  51
  52   // assert on invalid field names
  53   for (var i = 0; i < fields.length; i++) {
  54     if (!fieldNameRegExp.test(fields[i])) {
  55       throw new TypeError('field argument contains an invalid header name');
  56     }
  57   }
  58
  59   // existing, unspecified vary
  60   if (header === '*') {
  61     return header;
  62   }
  63
  64   // enumerate current values
  65   var val = header;
  66   var vals = parse(header.toLowerCase());
  67
  68   // unspecified vary
  69   if (fields.indexOf('*') !== -1 || vals.indexOf('*') !== -1) {
  70     return '*';
  71   }
  72
  73   for (var i = 0; i < fields.length; i++) {
  74     var fld = fields[i].toLowerCase();
  75
  76     // append value (case-preserving)
  77     if (vals.indexOf(fld) === -1) {
  78       vals.push(fld);
  79       val = val
  80         ? val + ', ' + fields[i]
  81         : fields[i];
  82     }
  83   }
  84
  85   return val;
  86 }
  87
  88 /**
  89  * Parse a vary header into an array.
  90  *
  91  * @param {String} header
  92  * @return {Array}
  93  * @api private
  94  */
  95
  96 function parse(header) {
  97   return header.trim().split(/ *, */);
  98 }
  99
 100 /**
 101  * Mark that a request is varied on a header field.
 102  *
 103  * @param {Object} res
 104  * @param {String|Array} field
 105  * @api public
 106  */
 107
 108 function vary(res, field) {
 109   if (!res || !res.getHeader || !res.setHeader) {
 110     // quack quack
 111     throw new TypeError('res argument is required');
 112   }
 113
 114   // get existing header
 115   var val = res.getHeader('Vary') || ''
 116   var header = Array.isArray(val)
 117     ? val.join(', ')
 118     : String(val);
 119
 120   // set new header
 121   if ((val = append(header, field))) {
 122     res.setHeader('Vary', val);
 123   }
 124 }