index.js (3328B)
1 /** 2 * Expose `pathtoRegexp`. 3 */ 4 5 module.exports = pathtoRegexp; 6 7 /** 8 * Match matching groups in a regular expression. 9 */ 10 var MATCHING_GROUP_REGEXP = /\((?!\?)/g; 11 12 /** 13 * Normalize the given path string, 14 * returning a regular expression. 15 * 16 * An empty array should be passed, 17 * which will contain the placeholder 18 * key names. For example "/user/:id" will 19 * then contain ["id"]. 20 * 21 * @param {String|RegExp|Array} path 22 * @param {Array} keys 23 * @param {Object} options 24 * @return {RegExp} 25 * @api private 26 */ 27 28 function pathtoRegexp(path, keys, options) { 29 options = options || {}; 30 keys = keys || []; 31 var strict = options.strict; 32 var end = options.end !== false; 33 var flags = options.sensitive ? '' : 'i'; 34 var extraOffset = 0; 35 var keysOffset = keys.length; 36 var i = 0; 37 var name = 0; 38 var m; 39 40 if (path instanceof RegExp) { 41 while (m = MATCHING_GROUP_REGEXP.exec(path.source)) { 42 keys.push({ 43 name: name++, 44 optional: false, 45 offset: m.index 46 }); 47 } 48 49 return path; 50 } 51 52 if (Array.isArray(path)) { 53 // Map array parts into regexps and return their source. We also pass 54 // the same keys and options instance into every generation to get 55 // consistent matching groups before we join the sources together. 56 path = path.map(function (value) { 57 return pathtoRegexp(value, keys, options).source; 58 }); 59 60 return new RegExp('(?:' + path.join('|') + ')', flags); 61 } 62 63 path = ('^' + path + (strict ? '' : path[path.length - 1] === '/' ? '?' : '/?')) 64 .replace(/\/\(/g, '/(?:') 65 .replace(/([\/\.])/g, '\\$1') 66 .replace(/(\\\/)?(\\\.)?:(\w+)(\(.*?\))?(\*)?(\?)?/g, function (match, slash, format, key, capture, star, optional, offset) { 67 slash = slash || ''; 68 format = format || ''; 69 capture = capture || '([^\\/' + format + ']+?)'; 70 optional = optional || ''; 71 72 keys.push({ 73 name: key, 74 optional: !!optional, 75 offset: offset + extraOffset 76 }); 77 78 var result = '' 79 + (optional ? '' : slash) 80 + '(?:' 81 + format + (optional ? slash : '') + capture 82 + (star ? '((?:[\\/' + format + '].+?)?)' : '') 83 + ')' 84 + optional; 85 86 extraOffset += result.length - match.length; 87 88 return result; 89 }) 90 .replace(/\*/g, function (star, index) { 91 var len = keys.length 92 93 while (len-- > keysOffset && keys[len].offset > index) { 94 keys[len].offset += 3; // Replacement length minus asterisk length. 95 } 96 97 return '(.*)'; 98 }); 99 100 // This is a workaround for handling unnamed matching groups. 101 while (m = MATCHING_GROUP_REGEXP.exec(path)) { 102 var escapeCount = 0; 103 var index = m.index; 104 105 while (path.charAt(--index) === '\\') { 106 escapeCount++; 107 } 108 109 // It's possible to escape the bracket. 110 if (escapeCount % 2 === 1) { 111 continue; 112 } 113 114 if (keysOffset + i === keys.length || keys[keysOffset + i].offset > m.index) { 115 keys.splice(keysOffset + i, 0, { 116 name: name++, // Unnamed matching groups must be consistently linear. 117 optional: false, 118 offset: m.index 119 }); 120 } 121 122 i++; 123 } 124 125 // If the path is non-ending, match until the end or a slash. 126 path += (end ? '$' : (path[path.length - 1] === '/' ? '' : '(?=\\/|$)')); 127 128 return new RegExp(path, flags); 129 };