| /* -*- Mode: js; js-indent-level: 2; -*- */ |
| /* |
| * Copyright 2011 Mozilla Foundation and contributors |
| * Licensed under the New BSD license. See LICENSE or: |
| * http://opensource.org/licenses/BSD-3-Clause |
| */ |
| |
| /** |
| * This is a helper function for getting values from parameter/options |
| * objects. |
| * |
| * @param args The object we are extracting values from |
| * @param name The name of the property we are getting. |
| * @param defaultValue An optional value to return if the property is missing |
| * from the object. If this is not specified and the property is missing, an |
| * error will be thrown. |
| */ |
| function getArg(aArgs, aName, aDefaultValue) { |
| if (aName in aArgs) { |
| return aArgs[aName]; |
| } else if (arguments.length === 3) { |
| return aDefaultValue; |
| } else { |
| throw new Error('"' + aName + '" is a required argument.'); |
| } |
| } |
| exports.getArg = getArg; |
| |
| var urlRegexp = /^(?:([\w+\-.]+):)?\/\/(?:(\w+:\w+)@)?([\w.-]*)(?::(\d+))?(.*)$/; |
| var dataUrlRegexp = /^data:.+\,.+$/; |
| |
| function urlParse(aUrl) { |
| var match = aUrl.match(urlRegexp); |
| if (!match) { |
| return null; |
| } |
| return { |
| scheme: match[1], |
| auth: match[2], |
| host: match[3], |
| port: match[4], |
| path: match[5] |
| }; |
| } |
| exports.urlParse = urlParse; |
| |
| function urlGenerate(aParsedUrl) { |
| var url = ''; |
| if (aParsedUrl.scheme) { |
| url += aParsedUrl.scheme + ':'; |
| } |
| url += '//'; |
| if (aParsedUrl.auth) { |
| url += aParsedUrl.auth + '@'; |
| } |
| if (aParsedUrl.host) { |
| url += aParsedUrl.host; |
| } |
| if (aParsedUrl.port) { |
| url += ":" + aParsedUrl.port |
| } |
| if (aParsedUrl.path) { |
| url += aParsedUrl.path; |
| } |
| return url; |
| } |
| exports.urlGenerate = urlGenerate; |
| |
| /** |
| * Normalizes a path, or the path portion of a URL: |
| * |
| * - Replaces consecutive slashes with one slash. |
| * - Removes unnecessary '.' parts. |
| * - Removes unnecessary '<dir>/..' parts. |
| * |
| * Based on code in the Node.js 'path' core module. |
| * |
| * @param aPath The path or url to normalize. |
| */ |
| function normalize(aPath) { |
| var path = aPath; |
| var url = urlParse(aPath); |
| if (url) { |
| if (!url.path) { |
| return aPath; |
| } |
| path = url.path; |
| } |
| var isAbsolute = exports.isAbsolute(path); |
| |
| var parts = path.split(/\/+/); |
| for (var part, up = 0, i = parts.length - 1; i >= 0; i--) { |
| part = parts[i]; |
| if (part === '.') { |
| parts.splice(i, 1); |
| } else if (part === '..') { |
| up++; |
| } else if (up > 0) { |
| if (part === '') { |
| // The first part is blank if the path is absolute. Trying to go |
| // above the root is a no-op. Therefore we can remove all '..' parts |
| // directly after the root. |
| parts.splice(i + 1, up); |
| up = 0; |
| } else { |
| parts.splice(i, 2); |
| up--; |
| } |
| } |
| } |
| path = parts.join('/'); |
| |
| if (path === '') { |
| path = isAbsolute ? '/' : '.'; |
| } |
| |
| if (url) { |
| url.path = path; |
| return urlGenerate(url); |
| } |
| return path; |
| } |
| exports.normalize = normalize; |
| |
| /** |
| * Joins two paths/URLs. |
| * |
| * @param aRoot The root path or URL. |
| * @param aPath The path or URL to be joined with the root. |
| * |
| * - If aPath is a URL or a data URI, aPath is returned, unless aPath is a |
| * scheme-relative URL: Then the scheme of aRoot, if any, is prepended |
| * first. |
| * - Otherwise aPath is a path. If aRoot is a URL, then its path portion |
| * is updated with the result and aRoot is returned. Otherwise the result |
| * is returned. |
| * - If aPath is absolute, the result is aPath. |
| * - Otherwise the two paths are joined with a slash. |
| * - Joining for example 'http://' and 'www.example.com' is also supported. |
| */ |
| function join(aRoot, aPath) { |
| if (aRoot === "") { |
| aRoot = "."; |
| } |
| if (aPath === "") { |
| aPath = "."; |
| } |
| var aPathUrl = urlParse(aPath); |
| var aRootUrl = urlParse(aRoot); |
| if (aRootUrl) { |
| aRoot = aRootUrl.path || '/'; |
| } |
| |
| // `join(foo, '//www.example.org')` |
| if (aPathUrl && !aPathUrl.scheme) { |
| if (aRootUrl) { |
| aPathUrl.scheme = aRootUrl.scheme; |
| } |
| return urlGenerate(aPathUrl); |
| } |
| |
| if (aPathUrl || aPath.match(dataUrlRegexp)) { |
| return aPath; |
| } |
| |
| // `join('http://', 'www.example.com')` |
| if (aRootUrl && !aRootUrl.host && !aRootUrl.path) { |
| aRootUrl.host = aPath; |
| return urlGenerate(aRootUrl); |
| } |
| |
| var joined = aPath.charAt(0) === '/' |
| ? aPath |
| : normalize(aRoot.replace(/\/+$/, '') + '/' + aPath); |
| |
| if (aRootUrl) { |
| aRootUrl.path = joined; |
| return urlGenerate(aRootUrl); |
| } |
| return joined; |
| } |
| exports.join = join; |
| |
| exports.isAbsolute = function (aPath) { |
| return aPath.charAt(0) === '/' || urlRegexp.test(aPath); |
| }; |
| |
| /** |
| * Make a path relative to a URL or another path. |
| * |
| * @param aRoot The root path or URL. |
| * @param aPath The path or URL to be made relative to aRoot. |
| */ |
| function relative(aRoot, aPath) { |
| if (aRoot === "") { |
| aRoot = "."; |
| } |
| |
| aRoot = aRoot.replace(/\/$/, ''); |
| |
| // It is possible for the path to be above the root. In this case, simply |
| // checking whether the root is a prefix of the path won't work. Instead, we |
| // need to remove components from the root one by one, until either we find |
| // a prefix that fits, or we run out of components to remove. |
| var level = 0; |
| while (aPath.indexOf(aRoot + '/') !== 0) { |
| var index = aRoot.lastIndexOf("/"); |
| if (index < 0) { |
| return aPath; |
| } |
| |
| // If the only part of the root that is left is the scheme (i.e. http://, |
| // file:///, etc.), one or more slashes (/), or simply nothing at all, we |
| // have exhausted all components, so the path is not relative to the root. |
| aRoot = aRoot.slice(0, index); |
| if (aRoot.match(/^([^\/]+:\/)?\/*$/)) { |
| return aPath; |
| } |
| |
| ++level; |
| } |
| |
| // Make sure we add a "../" for each component we removed from the root. |
| return Array(level + 1).join("../") + aPath.substr(aRoot.length + 1); |
| } |
| exports.relative = relative; |
| |
| var supportsNullProto = (function () { |
| var obj = Object.create(null); |
| return !('__proto__' in obj); |
| }()); |
| |
| function identity (s) { |
| return s; |
| } |
| |
| /** |
| * Because behavior goes wacky when you set `__proto__` on objects, we |
| * have to prefix all the strings in our set with an arbitrary character. |
| * |
| * See https://github.com/mozilla/source-map/pull/31 and |
| * https://github.com/mozilla/source-map/issues/30 |
| * |
| * @param String aStr |
| */ |
| function toSetString(aStr) { |
| if (isProtoString(aStr)) { |
| return '$' + aStr; |
| } |
| |
| return aStr; |
| } |
| exports.toSetString = supportsNullProto ? identity : toSetString; |
| |
| function fromSetString(aStr) { |
| if (isProtoString(aStr)) { |
| return aStr.slice(1); |
| } |
| |
| return aStr; |
| } |
| exports.fromSetString = supportsNullProto ? identity : fromSetString; |
| |
| function isProtoString(s) { |
| if (!s) { |
| return false; |
| } |
| |
| var length = s.length; |
| |
| if (length < 9 /* "__proto__".length */) { |
| return false; |
| } |
| |
| if (s.charCodeAt(length - 1) !== 95 /* '_' */ || |
| s.charCodeAt(length - 2) !== 95 /* '_' */ || |
| s.charCodeAt(length - 3) !== 111 /* 'o' */ || |
| s.charCodeAt(length - 4) !== 116 /* 't' */ || |
| s.charCodeAt(length - 5) !== 111 /* 'o' */ || |
| s.charCodeAt(length - 6) !== 114 /* 'r' */ || |
| s.charCodeAt(length - 7) !== 112 /* 'p' */ || |
| s.charCodeAt(length - 8) !== 95 /* '_' */ || |
| s.charCodeAt(length - 9) !== 95 /* '_' */) { |
| return false; |
| } |
| |
| for (var i = length - 10; i >= 0; i--) { |
| if (s.charCodeAt(i) !== 36 /* '$' */) { |
| return false; |
| } |
| } |
| |
| return true; |
| } |
| |
| /** |
| * Comparator between two mappings where the original positions are compared. |
| * |
| * Optionally pass in `true` as `onlyCompareGenerated` to consider two |
| * mappings with the same original source/line/column, but different generated |
| * line and column the same. Useful when searching for a mapping with a |
| * stubbed out mapping. |
| */ |
| function compareByOriginalPositions(mappingA, mappingB, onlyCompareOriginal) { |
| var cmp = strcmp(mappingA.source, mappingB.source); |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.originalLine - mappingB.originalLine; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.originalColumn - mappingB.originalColumn; |
| if (cmp !== 0 || onlyCompareOriginal) { |
| return cmp; |
| } |
| |
| cmp = mappingA.generatedColumn - mappingB.generatedColumn; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.generatedLine - mappingB.generatedLine; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| return strcmp(mappingA.name, mappingB.name); |
| } |
| exports.compareByOriginalPositions = compareByOriginalPositions; |
| |
| /** |
| * Comparator between two mappings with deflated source and name indices where |
| * the generated positions are compared. |
| * |
| * Optionally pass in `true` as `onlyCompareGenerated` to consider two |
| * mappings with the same generated line and column, but different |
| * source/name/original line and column the same. Useful when searching for a |
| * mapping with a stubbed out mapping. |
| */ |
| function compareByGeneratedPositionsDeflated(mappingA, mappingB, onlyCompareGenerated) { |
| var cmp = mappingA.generatedLine - mappingB.generatedLine; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.generatedColumn - mappingB.generatedColumn; |
| if (cmp !== 0 || onlyCompareGenerated) { |
| return cmp; |
| } |
| |
| cmp = strcmp(mappingA.source, mappingB.source); |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.originalLine - mappingB.originalLine; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.originalColumn - mappingB.originalColumn; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| return strcmp(mappingA.name, mappingB.name); |
| } |
| exports.compareByGeneratedPositionsDeflated = compareByGeneratedPositionsDeflated; |
| |
| function strcmp(aStr1, aStr2) { |
| if (aStr1 === aStr2) { |
| return 0; |
| } |
| |
| if (aStr1 === null) { |
| return 1; // aStr2 !== null |
| } |
| |
| if (aStr2 === null) { |
| return -1; // aStr1 !== null |
| } |
| |
| if (aStr1 > aStr2) { |
| return 1; |
| } |
| |
| return -1; |
| } |
| |
| /** |
| * Comparator between two mappings with inflated source and name strings where |
| * the generated positions are compared. |
| */ |
| function compareByGeneratedPositionsInflated(mappingA, mappingB) { |
| var cmp = mappingA.generatedLine - mappingB.generatedLine; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.generatedColumn - mappingB.generatedColumn; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = strcmp(mappingA.source, mappingB.source); |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.originalLine - mappingB.originalLine; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| cmp = mappingA.originalColumn - mappingB.originalColumn; |
| if (cmp !== 0) { |
| return cmp; |
| } |
| |
| return strcmp(mappingA.name, mappingB.name); |
| } |
| exports.compareByGeneratedPositionsInflated = compareByGeneratedPositionsInflated; |
| |
| /** |
| * Strip any JSON XSSI avoidance prefix from the string (as documented |
| * in the source maps specification), and then parse the string as |
| * JSON. |
| */ |
| function parseSourceMapInput(str) { |
| return JSON.parse(str.replace(/^\)]}'[^\n]*\n/, '')); |
| } |
| exports.parseSourceMapInput = parseSourceMapInput; |
| |
| /** |
| * Compute the URL of a source given the the source root, the source's |
| * URL, and the source map's URL. |
| */ |
| function computeSourceURL(sourceRoot, sourceURL, sourceMapURL) { |
| sourceURL = sourceURL || ''; |
| |
| if (sourceRoot) { |
| // This follows what Chrome does. |
| if (sourceRoot[sourceRoot.length - 1] !== '/' && sourceURL[0] !== '/') { |
| sourceRoot += '/'; |
| } |
| // The spec says: |
| // Line 4: An optional source root, useful for relocating source |
| // files on a server or removing repeated values in the |
| // “sources” entry. This value is prepended to the individual |
| // entries in the “source” field. |
| sourceURL = sourceRoot + sourceURL; |
| } |
| |
| // Historically, SourceMapConsumer did not take the sourceMapURL as |
| // a parameter. This mode is still somewhat supported, which is why |
| // this code block is conditional. However, it's preferable to pass |
| // the source map URL to SourceMapConsumer, so that this function |
| // can implement the source URL resolution algorithm as outlined in |
| // the spec. This block is basically the equivalent of: |
| // new URL(sourceURL, sourceMapURL).toString() |
| // ... except it avoids using URL, which wasn't available in the |
| // older releases of node still supported by this library. |
| // |
| // The spec says: |
| // If the sources are not absolute URLs after prepending of the |
| // “sourceRoot”, the sources are resolved relative to the |
| // SourceMap (like resolving script src in a html document). |
| if (sourceMapURL) { |
| var parsed = urlParse(sourceMapURL); |
| if (!parsed) { |
| throw new Error("sourceMapURL could not be parsed"); |
| } |
| if (parsed.path) { |
| // Strip the last path component, but keep the "/". |
| var index = parsed.path.lastIndexOf('/'); |
| if (index >= 0) { |
| parsed.path = parsed.path.substring(0, index + 1); |
| } |
| } |
| sourceURL = join(urlGenerate(parsed), sourceURL); |
| } |
| |
| return normalize(sourceURL); |
| } |
| exports.computeSourceURL = computeSourceURL; |