diff options
Diffstat (limited to 'lib')
| -rw-r--r-- | lib/utils.coffee | 134 | ||||
| -rw-r--r-- | lib/utils.js | 187 |
2 files changed, 134 insertions, 187 deletions
diff --git a/lib/utils.coffee b/lib/utils.coffee new file mode 100644 index 00000000..e9409826 --- /dev/null +++ b/lib/utils.coffee @@ -0,0 +1,134 @@ +Utils = + getCurrentVersion: -> + # Chromium #15242 will make this XHR request to access the manifest unnecessary. + manifestRequest = new XMLHttpRequest() + manifestRequest.open("GET", chrome.extension.getURL("manifest.json"), false) + manifestRequest.send(null) + JSON.parse(manifestRequest.responseText).version + + # Takes a dot-notation object string and call the function + # that it points to with the correct value for 'this'. + invokeCommandString: (str, argArray) -> + components = str.split('.') + obj = window + for component in components[0...-1] + obj = obj[component] + func = obj[components.pop()] + func.apply(obj, argArray) + + # Creates a single DOM element from :html + createElementFromHtml: (html) -> + tmp = document.createElement("div") + tmp.innerHTML = html + tmp.firstChild + + escapeHtml: (string) -> string.replace(/</g, "<").replace(/>/g, ">") + + # Generates a unique ID + createUniqueId: (-> + id = 0 + return -> id += 1 + )() + + # Completes a partial URL (without scheme) + createFullUrl: (partialUrl) -> + if (!/^[a-z]{3,}:\/\//.test(partialUrl)) + partialUrl = "http://" + partialUrl + partialUrl + + # Tries to detect, whether :str is a valid URL. + isUrl: (str) -> + # more or less RFC compliant URL host part parsing. This should be sufficient + # for our needs + urlRegex = new RegExp( + '^(?:([^:]+)(?::([^:]+))?@)?' + # user:password (optional) => \1, \2 + '([^:]+|\\[[^\\]]+\\])' + # host name (IPv6 addresses in square brackets allowed) => \3 + '(?::(\\d+))?$' # port number (optional) => \4 + ) + + # these are all official ASCII TLDs that are longer than 3 characters + # (including the inofficial .onion TLD used by TOR) + longTlds = [ 'arpa', 'asia', 'coop', 'info', 'jobs', 'local', 'mobi', 'museum', 'name', 'onion' ] + + # are there more? + specialHostNames = [ 'localhost' ] + + # it starts with a scheme, so it's definitely an URL + if (/^[a-z]{3,}:\/\//.test(str)) + return true + + # spaces => definitely not a valid URL + if (str.indexOf(' ') >= 0) + return false + + # assuming that this is an URL, try to parse it into its meaningful parts. If matching fails, we're + # pretty sure that we don't have some kind of URL here. + match = urlRegex.exec(str.split('/')[0]) + if (!match) + return false + hostname = match[3] + + # allow known special host names + if (specialHostNames.indexOf(hostname) >= 0) + return true + + # allow IPv6 addresses (need to be wrapped in brackets, as required by RFC). It is sufficient to check + # for a colon here, as the regex wouldn't match colons in the host name unless it's an v6 address + if (hostname.indexOf(':') >= 0) + return true + + # at this point we have to make a decision. As a heuristic, we check if the input has dots in it. If + # yes, and if the last part could be a TLD, treat it as an URL. + dottedParts = hostname.split('.') + lastPart = dottedParts[dottedParts.length-1] + if (dottedParts.length > 1 && ((lastPart.length >= 2 && lastPart.length <= 3) || + longTlds.indexOf(lastPart) >= 0)) + return true + + # also allow IPv4 addresses + if (/^(\d{1,3}\.){3}\d{1,3}$/.test(hostname)) + return true + + # fallback: no URL + return false + + # Creates a search URL from the given :query. + createSearchUrl: (query) -> + # we need to escape explictely to encode characters like "+" correctly + "http://www.google.com/search?q=" + encodeURIComponent(query) + + # Converts :string into a google search if it's not already a URL. + # We don't bother with escaping characters as Chrome will do that for us. + convertToUrl: (string) -> + string = string.trim() + if (Utils.isUrl(string)) then Utils.createFullUrl(string) else Utils.createSearchUrl(string) + +# Execute a function with the given value for "this". Equivalent to jQuery.proxy(). */ +Function.prototype.proxy = (self) -> + fn = this + return -> fn.apply(self, arguments) + +# This creates a new function out of an existing function, where the new function takes fewer arguments. +# This allows us to pass around functions instead of functions + a partial list of arguments. +Function.prototype.curry = -> + fixedArguments = Array.copy(arguments) + fn = this + -> fn.apply(this, fixedArguments.concat(Array.copy(arguments))) + +Array.copy = (array) -> Array.prototype.slice.call(array, 0) + +# A very simple method for defining a new class (constructor and methods) using a single hash. +# No support for inheritance is included because we really shouldn't need it. +# TODO(philc): remove this. +Class = + extend: (properties) -> + newClass = -> + this.init.apply(this, arguments) if (this.init) + null + newClass.prototype = properties + newClass.constructor = newClass + newClass + +root = exports ? window +root.Utils = Utils +root.Class = Class diff --git a/lib/utils.js b/lib/utils.js deleted file mode 100644 index 5bb3a6cc..00000000 --- a/lib/utils.js +++ /dev/null @@ -1,187 +0,0 @@ -root = (typeof(exports) === "undefined") ? window : exports - -root.utils = { - getCurrentVersion: function() { - // Chromium #15242 will make this XHR request to access the manifest unnecessary. - var manifestRequest = new XMLHttpRequest(); - manifestRequest.open("GET", chrome.extension.getURL("manifest.json"), false); - manifestRequest.send(null); - return JSON.parse(manifestRequest.responseText).version; - }, - - /* - * Takes a dot-notation object string and call the function - * that it points to with the correct value for 'this'. - */ - invokeCommandString: function(str, argArray) { - var components = str.split('.'); - var obj = window; - for (var i = 0; i < components.length - 1; i++) - obj = obj[components[i]]; - var func = obj[components.pop()]; - return func.apply(obj, argArray); - }, - - /* - * Takes an array of XPath selectors, adds the necessary namespaces (currently only XHTML), and applies them - * to the document root. The namespaceResolver in evaluateXPath should be kept in sync with the namespaces - * here. - */ - makeXPath: function(elementArray) { - var xpath = []; - for (var i in elementArray) - xpath.push("//" + elementArray[i], "//xhtml:" + elementArray[i]); - return xpath.join(" | "); - }, - - evaluateXPath: function(xpath, resultType) { - function namespaceResolver(namespace) { - return namespace == "xhtml" ? "http://www.w3.org/1999/xhtml" : null; - } - return document.evaluate(xpath, document.documentElement, namespaceResolver, resultType, null); - }, - - /** Sets up prototype inheritance */ - extend: function(base, sub) { - function surrogateCtor() { } - surrogateCtor.prototype = base.prototype; - sub.prototype = new surrogateCtor(); - sub.prototype.constructor = sub; - }, - - /** Creates a single DOM element from :html */ - createElementFromHtml: function(html) { - var tmp = document.createElement("div"); - tmp.innerHTML = html; - return tmp.firstChild; - }, - - escapeHtml: function(string) { return string.replace(/</g, "<").replace(/>/g, ">"); }, - - /** - * Generates a unique ID - */ - createUniqueId: (function() { - id = 0; - return function() { return ++id; }; - })(), - - /** - * Completes a partial URL (without scheme) - */ - createFullUrl: function(partialUrl) { - if (!/^[a-z]{3,}:\/\//.test(partialUrl)) - partialUrl = 'http://' + partialUrl; - return partialUrl - }, - - /** - * Tries to detect, whether :str is a valid URL. - */ - isUrl: function(str) { - // more or less RFC compliant URL host part parsing. This should be sufficient - // for our needs - var urlRegex = new RegExp( - '^(?:([^:]+)(?::([^:]+))?@)?' + // user:password (optional) => \1, \2 - '([^:]+|\\[[^\\]]+\\])' + // host name (IPv6 addresses in square brackets allowed) => \3 - '(?::(\\d+))?$' // port number (optional) => \4 - ); - - // these are all official ASCII TLDs that are longer than 3 characters - // (including the inofficial .onion TLD used by TOR) - var longTlds = [ 'arpa', 'asia', 'coop', 'info', 'jobs', 'local', 'mobi', 'museum', 'name', 'onion' ]; - - // are there more? - var specialHostNames = [ 'localhost' ]; - - // it starts with a scheme, so it's definitely an URL - if (/^[a-z]{3,}:\/\//.test(str)) - return true; - - // spaces => definitely not a valid URL - if (str.indexOf(' ') >= 0) - return false; - - // assuming that this is an URL, try to parse it into its meaningful parts. If matching fails, we're - // pretty sure that we don't have some kind of URL here. - var match = urlRegex.exec(str.split('/')[0]); - if (!match) - return false; - var hostname = match[3]; - - // allow known special host names - if (specialHostNames.indexOf(hostname) >= 0) - return true; - - // allow IPv6 addresses (need to be wrapped in brackets, as required by RFC). It is sufficient to check - // for a colon here, as the regex wouldn't match colons in the host name unless it's an v6 address - if (hostname.indexOf(':') >= 0) - return true; - - // at this point we have to make a decision. As a heuristic, we check if the input has dots in it. If - // yes, and if the last part could be a TLD, treat it as an URL. - var dottedParts = hostname.split('.'); - var lastPart = dottedParts[dottedParts.length-1]; - if (dottedParts.length > 1 && ((lastPart.length >= 2 && lastPart.length <= 3) - || longTlds.indexOf(lastPart) >= 0)) - return true; - - // also allow IPv4 addresses - if (/^(\d{1,3}\.){3}\d{1,3}$/.test(hostname)) - return true; - - // fallback: no URL - return false - }, - - /** - * Creates a search URL from the given :query. - */ - createSearchUrl: function(query) { - // we need to escape explictely to encode characters like "+" correctly - return "http://www.google.com/search?q=" + encodeURIComponent(query); - }, - - /** - * Converts :string into a google search if it's not already a URL. - * We don't bother with escaping characters as Chrome will do that for us. - */ - convertToUrl: function(string) { - string = string.trim(); - if (utils.isUrl(string)) - return utils.createFullUrl(string); - else - return utils.createSearchUrl(string); - } -}; - -/* Execute a function with the given value for "this". Equivalent to jQuery.proxy(). */ -Function.prototype.proxy = function(self) { - var fn = this; - return function() { return fn.apply(self, arguments); }; -}; - -/* - * This creates a new function out of an existing function, where the new function takes fewer arguments. - * This allows us to pass around functions instead of functions + a partial list of arguments. - */ -Function.prototype.curry = function() { - var fixedArguments = Array.copy(arguments); - var fn = this; - return function() { return fn.apply(this, fixedArguments.concat(Array.copy(arguments))); }; -}; - -Array.copy = function(array) { return Array.prototype.slice.call(array, 0); }; - -/* - * A very simple method for defining a new class (constructor and methods) using a single hash. - * No support for inheritance is included because we really shouldn't need it. - */ -Class = { - extend: function(properties) { - var newClass = function() { if (this.init) this.init.apply(this, arguments); }; - newClass.prototype = properties; - newClass.constructor = newClass; - return newClass; - } -};
\ No newline at end of file |