diff options
Diffstat (limited to 'addon-sdk/source/lib/sdk/system/xul-app.jsm')
-rw-r--r-- | addon-sdk/source/lib/sdk/system/xul-app.jsm | 242 |
1 files changed, 0 insertions, 242 deletions
diff --git a/addon-sdk/source/lib/sdk/system/xul-app.jsm b/addon-sdk/source/lib/sdk/system/xul-app.jsm deleted file mode 100644 index 90681bb1b..000000000 --- a/addon-sdk/source/lib/sdk/system/xul-app.jsm +++ /dev/null @@ -1,242 +0,0 @@ -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ -"use strict"; - -this.EXPORTED_SYMBOLS = [ "XulApp" ]; - -var { classes: Cc, interfaces: Ci } = Components; - -var exports = {}; -this.XulApp = exports; - -var appInfo; - -// NOTE: below is required to avoid failing xpcshell tests, -// which do not implement nsIXULAppInfo -// See Bug 1114752 https://bugzilla.mozilla.org/show_bug.cgi?id=1114752 -try { - appInfo = Cc["@mozilla.org/xre/app-info;1"] - .getService(Ci.nsIXULAppInfo); -} -catch (e) { - // xpcshell test case - appInfo = {}; -} -var vc = Cc["@mozilla.org/xpcom/version-comparator;1"] - .getService(Ci.nsIVersionComparator); - -var ID = exports.ID = appInfo.ID; -var name = exports.name = appInfo.name; -var version = exports.version = appInfo.version; -var platformVersion = exports.platformVersion = appInfo.platformVersion; - -// The following mapping of application names to GUIDs was taken from: -// -// https://addons.mozilla.org/en-US/firefox/pages/appversions -// -// Using the GUID instead of the app's name is preferable because sometimes -// re-branded versions of a product have different names: for instance, -// Firefox, Minefield, Iceweasel, and Shiretoko all have the same -// GUID. - -var ids = exports.ids = { - Firefox: "{ec8030f7-c20a-464f-9b0e-13a3a9e97384}", - Mozilla: "{86c18b42-e466-45a9-ae7a-9b95ba6f5640}", - SeaMonkey: "{92650c4d-4b8e-4d2a-b7eb-24ecf4f6b63a}", - Fennec: "{aa3c5121-dab2-40e2-81ca-7ea25febc110}", - Thunderbird: "{3550f703-e582-4d05-9a08-453d09bdfdc6}", - Instantbird: "{33cb9019-c295-46dd-be21-8c4936574bee}" -}; - -function is(name) { - if (!(name in ids)) - throw new Error("Unkown Mozilla Application: " + name); - return ID == ids[name]; -}; -exports.is = is; - -function isOneOf(names) { - for (var i = 0; i < names.length; i++) - if (is(names[i])) - return true; - return false; -}; -exports.isOneOf = isOneOf; - -/** - * Use this to check whether the given version (e.g. xulApp.platformVersion) - * is in the given range. Versions must be in version comparator-compatible - * format. See MDC for details: - * https://developer.mozilla.org/en/XPCOM_Interface_Reference/nsIVersionComparator - */ -var versionInRange = exports.versionInRange = -function versionInRange(version, lowInclusive, highExclusive) { - return (vc.compare(version, lowInclusive) >= 0) && - (vc.compare(version, highExclusive) < 0); -} - -const reVersionRange = /^((?:<|>)?=?)?\s*((?:\d+[\S]*)|\*)(?:\s+((?:<|>)=?)?(\d+[\S]+))?$/; -const reOnlyInifinity = /^[<>]?=?\s*[*x]$/; -const reSubInfinity = /\.[*x]/g; -const reHyphenRange = /^(\d+.*?)\s*-\s*(\d+.*?)$/; -const reRangeSeparator = /\s*\|\|\s*/; - -const compares = { - "=": function (c) { return c === 0 }, - ">=": function (c) { return c >= 0 }, - "<=": function (c) { return c <= 0}, - "<": function (c) { return c < 0 }, - ">": function (c) { return c > 0 } -} - -function normalizeRange(range) { - return range - .replace(reOnlyInifinity, "") - .replace(reSubInfinity, ".*") - .replace(reHyphenRange, ">=$1 <=$2") -} - -/** - * Compare the versions given, using the comparison operator provided. - * Internal use only. - * - * @example - * compareVersion("1.2", "<=", "1.*") // true - * - * @param {String} version - * A version to compare - * - * @param {String} comparison - * The comparison operator - * - * @param {String} compareVersion - * A version to compare - */ -function compareVersion(version, comparison, compareVersion) { - let hasWildcard = compareVersion.indexOf("*") !== -1; - - comparison = comparison || "="; - - if (hasWildcard) { - switch (comparison) { - case "=": - let zeroVersion = compareVersion.replace(reSubInfinity, ".0"); - return versionInRange(version, zeroVersion, compareVersion); - case ">=": - compareVersion = compareVersion.replace(reSubInfinity, ".0"); - break; - } - } - - let compare = compares[comparison]; - - return typeof compare === "function" && compare(vc.compare(version, compareVersion)); -} - -/** - * Returns `true` if `version` satisfies the `versionRange` given. - * If only an argument is passed, is used as `versionRange` and compared against - * `xulApp.platformVersion`. - * - * `versionRange` is either a string which has one or more space-separated - * descriptors, or a range like "fromVersion - toVersion". - * Version range descriptors may be any of the following styles: - * - * - "version" Must match `version` exactly - * - "=version" Same as just `version` - * - ">version" Must be greater than `version` - * - ">=version" Must be greater or equal than `version` - * - "<version" Must be less than `version` - * - "<=version" Must be less or equal than `version` - * - "1.2.x" or "1.2.*" See 'X version ranges' below - * - "*" or "" (just an empty string) Matches any version - * - "version1 - version2" Same as ">=version1 <=version2" - * - "range1 || range2" Passes if either `range1` or `range2` are satisfied - * - * For example, these are all valid: - * - "1.0.0 - 2.9999.9999" - * - ">=1.0.2 <2.1.2" - * - ">1.0.2 <=2.3.4" - * - "2.0.1" - * - "<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0" - * - "2.x" (equivalent to "2.*") - * - "1.2.x" (equivalent to "1.2.*" and ">=1.2.0 <1.3.0") - */ -function satisfiesVersion(version, versionRange) { - if (arguments.length === 1) { - versionRange = version; - version = appInfo.version; - } - - let ranges = versionRange.trim().split(reRangeSeparator); - - return ranges.some(function(range) { - range = normalizeRange(range); - - // No versions' range specified means that any version satisfies the - // requirements. - if (range === "") - return true; - - let matches = range.match(reVersionRange); - - if (!matches) - return false; - - let [, lowMod, lowVer, highMod, highVer] = matches; - - return compareVersion(version, lowMod, lowVer) && (highVer !== undefined - ? compareVersion(version, highMod, highVer) - : true); - }); -} -exports.satisfiesVersion = satisfiesVersion; - -/** - * Ensure the current application satisfied the requirements specified in the - * module given. If not, an exception related to the incompatibility is - * returned; `null` otherwise. - * - * @param {Object} module - * The module to check - * @returns {Error} - */ -function incompatibility(module) { - let { metadata, id } = module; - - // if metadata or engines are not specified we assume compatibility is not - // an issue. - if (!metadata || !("engines" in metadata)) - return null; - - let { engines } = metadata; - - if (engines === null || typeof(engines) !== "object") - return new Error("Malformed engines' property in metadata"); - - let applications = Object.keys(engines); - - let versionRange; - applications.forEach(function(name) { - if (is(name)) { - versionRange = engines[name]; - // Continue iteration. We want to ensure the module doesn't - // contain a typo in the applications' name or some unknown - // application - `is` function throws an exception in that case. - } - }); - - if (typeof(versionRange) === "string") { - if (satisfiesVersion(versionRange)) - return null; - - return new Error("Unsupported Application version: The module " + id + - " currently supports only version " + versionRange + " of " + - name + "."); - } - - return new Error("Unsupported Application: The module " + id + - " currently supports only " + applications.join(", ") + ".") -} -exports.incompatibility = incompatibility; |