Update jquery to 1.9.1

build.py

@@ -263,7 +263,7 @@ def examples_star_json(name, match):
               "externs/closure-compiler.js",
               "externs/example.js",
               "externs/geojson.js",
-              "externs/jquery-1.7.js",
+              "externs/jquery-1.9.js",
               "externs/oli.js",
               "externs/olx.js",
               "externs/proj4js.js",

config/examples-all.json

@@ -8,7 +8,7 @@
       "externs/closure-compiler.js",
       "externs/example.js",
       "externs/geojson.js",
-      "externs/jquery-1.7.js",
+      "externs/jquery-1.9.js",
       "externs/oli.js",
       "externs/olx.js",
       "externs/proj4js.js",

externs/jquery-1.9.js

@@ -15,7 +15,7 @@
  */
 
 /**
- * @fileoverview Externs for jQuery 1.7.2
+ * @fileoverview Externs for jQuery 1.9.1
  *
  * Note that some functions use different return types depending on the number
  * of parameters passed in. In these cases, you may need to annotate the type
@@ -65,6 +65,13 @@ function $(arg1, arg2) {}
  */
 jQuery.prototype.add = function(arg1, context) {};
 
+/**
+ * @param {(jQuerySelector|Array.<Element>|string|jQuery)=} arg1
+ * @return {!jQuery}
+ * @nosideeffects
+ */
+jQuery.prototype.addBack = function(arg1) {};
+
 /**
  * @param {(string|function(number,String))} arg1
  * @return {!jQuery}
@@ -239,6 +246,7 @@ jQuery.prototype.ajaxStop = function(handler) {};
 jQuery.prototype.ajaxSuccess = function(handler) {};
 
 /**
+ * @deprecated Please use .addBack(selector) instead.
  * @return {!jQuery}
  * @nosideeffects
  */
@@ -254,8 +262,8 @@ jQuery.prototype.andSelf = function() {};
 jQuery.prototype.animate = function(properties, arg2, easing, complete) {};
 
 /**
- * @param {(string|Element|jQuery|function(number,string))} arg1
+ * @param {(string|Element|Array.<Element>|jQuery|function(number,string))} arg1
- * @param {(string|Element|Array.<Element>|jQuery)=} content
+ * @param {...(string|Element|Array.<Element>|jQuery)} content
  * @return {!jQuery}
  */
 jQuery.prototype.append = function(arg1, content) {};
@@ -295,86 +303,6 @@ jQuery.prototype.bind = function(arg1, eventData, arg3) {};
  */
 jQuery.prototype.blur = function(arg1, handler) {};
 
-/** @type {boolean} */
-jQuery.boxModel;
-
-/** @type {boolean} */
-$.boxModel;
-
-/** @type {Object.<string,*>} */
-jQuery.browser;
-
-/** @type {Object.<string,*>} */
-$.browser;
-
-/**
- * @type {boolean}
- * @const
- */
-jQuery.browser.mozilla;
-
-/**
- * @type {boolean}
- * @const
- */
-$.browser.mozilla;
-
-/**
- * @type {boolean}
- * @const
- */
-jQuery.browser.msie;
-
-/**
- * @type {boolean}
- * @const
- */
-$.browser.msie;
-
-/**
- * @type {boolean}
- * @const
- */
-jQuery.browser.opera;
-
-/**
- * @type {boolean}
- * @const
- */
-$.browser.opera;
-
-/**
- * @deprecated
- * @type {boolean}
- * @const
- */
-jQuery.browser.safari;
-
-/**
- * @deprecated
- * @type {boolean}
- * @const
- */
-$.browser.safari;
-
-/** @type {string} */
-jQuery.browser.version;
-
-/** @type {string} */
-$.browser.version;
-
-/**
- * @type {boolean}
- * @const
- */
-jQuery.browser.webkit;
-
-/**
- * @type {boolean}
- * @const
- */
-$.browser.webkit;
-
 /**
  * @constructor
  * @private
@@ -457,9 +385,9 @@ jQuery.prototype.click = function(arg1, handler) {};
 jQuery.prototype.clone = function(withDataAndEvents, deepWithDataAndEvents) {};
 
 /**
- * @param {(jQuerySelector|jQuery|Element|string|Array.<string>)} arg1
+ * @param {(jQuerySelector|jQuery|Element|string)} arg1
  * @param {Element=} context
- * @return {(!jQuery|Array.<Element>)}
+ * @return {!jQuery}
  * @nosideeffects
  */
 jQuery.prototype.closest = function(arg1, context) {};
@@ -484,7 +412,7 @@ $.contains = function(container, contained) {};
  */
 jQuery.prototype.contents = function() {};
 
-/** @type {Element} */
+/** @type {Element|Document} */
 jQuery.prototype.context;
 
 /**
@@ -587,22 +515,6 @@ jQuery.deferred.prototype.done = function(doneCallbacks, doneCallbacks2) {};
  */
 jQuery.deferred.prototype.fail = function(failCallbacks, failCallbacks2) {};
 
-/**
- * @deprecated
- * @override
- * @return {boolean}
- * @nosideeffects
- */
-jQuery.deferred.prototype.isRejected = function() {};
-
-/**
- * @deprecated
- * @override
- * @return {boolean}
- * @nosideeffects
- */
-jQuery.deferred.prototype.isResolved = function() {};
-
 /**
  * @param {...*} var_args
  * @return {jQuery.deferred}
@@ -617,17 +529,18 @@ jQuery.deferred.prototype.notify = function(var_args) {};
 jQuery.deferred.prototype.notifyWith = function(context, var_args) {};
 
 /**
+ * @deprecated Please use deferred.then() instead.
  * @override
  * @param {function()=} doneFilter
  * @param {function()=} failFilter
  * @param {function()=} progressFilter
  * @return {jQuery.Promise}
  */
-jQuery.deferred.prototype.pipe
+jQuery.deferred.prototype.pipe =
-    = function(doneFilter, failFilter, progressFilter) {};
+    function(doneFilter, failFilter, progressFilter) {};
 
 /**
- * @param {function()} progressCallbacks
+ * @param {jQueryCallback} progressCallbacks
  * @return {jQuery.deferred}
  */
 jQuery.deferred.prototype.progress = function(progressCallbacks) {};
@@ -717,17 +630,9 @@ $.dequeue = function(elem, queueName) {};
  */
 jQuery.prototype.detach = function(selector) {};
 
-/**
- * @deprecated
- * @param {(string|Object.<string,*>)=} arg1
- * @param {string=} handler
- * @return {!jQuery}
- */
-jQuery.prototype.die = function(arg1, handler) {};
-
 /**
  * @param {Object} collection
- * @param {function((number|string),?)} callback
+ * @param {function(number,?)} callback
  * @return {Object}
  */
 jQuery.each = function(collection, callback) {};
@@ -740,7 +645,7 @@ jQuery.prototype.each = function(fnc) {};
 
 /**
  * @param {Object} collection
- * @param {function((number|string),?)} callback
+ * @param {function(number,?)} callback
  * @return {Object}
  */
 $.each = function(collection, callback) {};
@@ -764,6 +669,7 @@ jQuery.prototype.eq = function(arg1) {};
 jQuery.error = function(message) {};
 
 /**
+ * @deprecated Please use .on( "error", handler ) instead.
  * @param {(function(!jQuery.event=)|Object.<string, *>)} arg1
  * @param {function(!jQuery.event=)=} handler
  * @return {!jQuery}
@@ -944,10 +850,10 @@ jQuery.prototype.find = function(arg1) {};
 jQuery.prototype.first = function() {};
 
 /** @see http://docs.jquery.com/Plugins/Authoring */
-jQuery.fn;
+jQuery.fn = jQuery.prototype;
 
 /** @see http://docs.jquery.com/Plugins/Authoring */
-$.fn;
+$.fn = $.prototype;
 
 /**
  * @param {(function(!jQuery.event=)|Object.<string, *>)=} arg1
@@ -1243,14 +1149,14 @@ jQuery.isNumeric = function(value) {};
 $.isNumeric = function(value) {};
 
 /**
- * @param {Object} obj
+ * @param {*} obj
  * @return {boolean}
  * @nosideeffects
  */
 jQuery.isPlainObject = function(obj) {};
 
 /**
- * @param {Object} obj
+ * @param {*} obj
  * @return {boolean}
  * @nosideeffects
  */
@@ -1333,22 +1239,6 @@ jQuery.jqXHR.prototype.error = function (callback) {};
  */
 jQuery.jqXHR.prototype.fail = function(failCallbacks) {};
 
-/**
- * @deprecated
- * @override
- * @return {boolean}
- * @nosideeffects
- */
-jQuery.jqXHR.prototype.isRejected = function() {};
-
-/**
- * @deprecated
- * @override
- * @return {boolean}
- * @nosideeffects
- */
-jQuery.jqXHR.prototype.isResolved = function() {};
-
 /**
  * @deprecated
  * @override
@@ -1356,6 +1246,7 @@ jQuery.jqXHR.prototype.isResolved = function() {};
 jQuery.jqXHR.prototype.onreadystatechange = function (callback) {};
 
 /**
+ * @override
  * @param {function()=} doneFilter
  * @param {function()=} failFilter
  * @param {function()=} progressFilter
@@ -1409,15 +1300,9 @@ jQuery.prototype.last = function() {};
 jQuery.prototype.length;
 
 /**
- * @deprecated
+ * @deprecated Please avoid the document loading Event invocation of
- * @param {(string|Object)} arg1
+ *     .load() and use .on( "load", handler ) instead. (The AJAX
- * @param {(function(!jQuery.event=)|Object)=} arg2
+ *     module invocation signature is OK.)
- * @param {function(!jQuery.event=)=} handler
- * @return {!jQuery}
- */
-jQuery.prototype.live = function(arg1, arg2, handler) {};
-
-/**
  * @param {(function(!jQuery.event=)|Object.<string, *>|string)} arg1
  * @param {(function(!jQuery.event=)|Object.<string,*>|string)=} arg2
  * @param {function(string,string,XMLHttpRequest)=} complete
@@ -1673,6 +1558,22 @@ jQuery.prototype.parents = function(selector) {};
  */
 jQuery.prototype.parentsUntil = function(arg1, filter) {};
 
+/**
+ * @param {string} data
+ * @param {(Element|boolean)=} context
+ * @param {boolean=} keepScripts
+ * @return {Array.<Element>}
+ */
+jQuery.parseHTML = function(data, context, keepScripts) {};
+
+/**
+ * @param {string} data
+ * @param {(Element|boolean)=} context
+ * @param {boolean=} keepScripts
+ * @return {Array.<Element>}
+ */
+$.parseHTML = function(data, context, keepScripts) {};
+
 /**
  * @param {string} json
  * @return {Object.<string, *>}
@@ -1792,20 +1693,6 @@ jQuery.Promise.prototype.done = function(doneCallbacks) {};
  */
 jQuery.Promise.prototype.fail = function(failCallbacks) {};
 
-/**
- * @deprecated
- * @return {boolean}
- * @nosideeffects
- */
-jQuery.Promise.prototype.isRejected = function() {};
-
-/**
- * @deprecated
- * @return {boolean}
- * @nosideeffects
- */
-jQuery.Promise.prototype.isResolved = function() {};
-
 /**
  * @param {function()=} doneFilter
  * @param {function()=} failFilter
@@ -1997,6 +1884,7 @@ jQuery.prototype.show = function(duration, arg2, callback) {};
 jQuery.prototype.siblings = function(selector) {};
 
 /**
+ * @deprecated Please use the .length property instead.
  * @return {number}
  * @nosideeffects
  */
@@ -2044,20 +1932,6 @@ jQuery.prototype.slideUp =
  */
 jQuery.prototype.stop = function(arg1, arg2, jumpToEnd) {};
 
-/**
- * @deprecated
- * @return {!jQuery}
- * @nosideeffects
- */
-jQuery.sub = function() {};
-
-/**
- * @deprecated
- * @return {!jQuery}
- * @nosideeffects
- */
-$.sub = function() {};
-
 /**
  * @param {(function(!jQuery.event=)|Object.<string, *>)=} arg1
  * @param {function(!jQuery.event=)=} handler
@@ -2071,10 +1945,16 @@ jQuery.support;
 /** @type {Object.<string, *>} */
 $.support;
 
-/** @type {boolean} */
+/**
+ * @deprecated Please try to use feature detection instead.
+ * @type {boolean}
+ */
 jQuery.support.boxModel;
 
-/** @type {boolean} */
+/**
+ * @deprecated Please try to use feature detection instead.
+ * @type {boolean}
+ */
 $.support.boxModel;
 
 /** @type {boolean} */
@@ -2083,18 +1963,18 @@ jQuery.support.changeBubbles;
 /** @type {boolean} */
 $.support.changeBubbles;
 
+/** @type {boolean} */
+jQuery.support.cors;
+
+/** @type {boolean} */
+$.support.cors;
+
 /** @type {boolean} */
 jQuery.support.cssFloat;
 
 /** @type {boolean} */
 $.support.cssFloat;
 
-/** @type {boolean} */
-jQuery.support.fixedPosition;
-
-/** @type {boolean} */
-$.support.fixedPosition;
-
 /** @type {boolean} */
 jQuery.support.hrefNormalized;
 
@@ -2125,12 +2005,6 @@ jQuery.support.opacity;
 /** @type {boolean} */
 $.support.opacity;
 
-/** @type {boolean} */
-jQuery.support.scriptEval;
-
-/** @type {boolean} */
-$.support.scriptEval;
-
 /** @type {boolean} */
 jQuery.support.style;
 
@@ -2162,9 +2036,11 @@ jQuery.prototype.text = function(arg1) {};
 jQuery.prototype.toArray = function() {};
 
 /**
- * @param {(function(!jQuery.event=)|string|number|function()|boolean)=} arg1
+ * Refers to the method from the Effects category. There used to be a toggle
- * @param {(function(!jQuery.event=)|function()|string)=} arg2
+ * method on the Events category which was removed starting version 1.9.
- * @param {(function(!jQuery.event=)|function())=} arg3
+ * @param {(number|string|Object.<string,*>|boolean)=} arg1
+ * @param {(function()|string)=} arg2
+ * @param {function()=} arg3
  * @return {!jQuery}
  */
 jQuery.prototype.toggle = function(arg1, arg2, arg3) {};
@@ -2246,6 +2122,7 @@ jQuery.unique = function(arr) {};
 $.unique = function(arr) {};
 
 /**
+ * @deprecated Please use .on( "unload", handler ) instead.
  * @param {(function(!jQuery.event=)|Object.<string, *>)} arg1
  * @param {function(!jQuery.event=)=} handler
  * @return {!jQuery}
@@ -2262,15 +2139,23 @@ jQuery.prototype.unwrap = function() {};
 jQuery.prototype.val = function(arg1) {};
 
 /**
- * @param {jQuery.deferred} deferred
+ * Note: The official documentation (https://api.jquery.com/jQuery.when/) says
- * @param {...jQuery.deferred} deferreds
+ * jQuery.when accepts deferreds, but it actually accepts any type, e.g.:
+ *
+ * jQuery.when(jQuery.ready, jQuery.ajax(''), jQuery('#my-element'), 1)
+ *
+ * If an argument is not an "observable" (a promise-like object) it is wrapped
+ * into a promise.
+ * @param {*} deferred
+ * @param {...*} deferreds
  * @return {jQuery.Promise}
  */
 jQuery.when = function(deferred, deferreds) {};
 
 /**
- * @param {jQuery.deferred} deferred
+ * Note: See jQuery.when().
- * @param {...jQuery.deferred} deferreds
+ * @param {*} deferred
+ * @param {...*} deferreds
  * @return {jQuery.Promise}
  */
 $.when = function(deferred, deferreds) {};
@@ -2294,7 +2179,8 @@ jQuery.prototype.wrap = function(arg1) {};
 jQuery.prototype.wrapAll = function(wrappingElement) {};
 
 /**
- * @param {(string|function(number))} arg1
+ * @param {(string|jQuerySelector|Element|jQuery|function(number))} arg1
  * @return {!jQuery}
  */
 jQuery.prototype.wrapInner = function(arg1) {};
+