/** * jQuery Lint * --- * VERSION 1.01 * --- * jQuery lint creates a thin blanket over jQuery that'll * report any potentially erroneous activity to the console. * --- * Idea from: * http://markmail.org/message/wzkosk2s5jklpkv4 * http://groups.google.com/group/jquery-dev/browse_thread/thread/9a15cca62ceb2444 * --- * @author James Padolsey * @contributors Paul Irish, Zoran Zaric * --- * Dual licensed under the MIT and GPL licenses. * - http://www.opensource.org/licenses/mit-license.php * - http://www.gnu.org/copyleft/gpl.html */ (function(){ var _jQuery = window['jQuery']; // Change as needed if (!_jQuery) { return; } var glob = window, langs = { en: { incorrectCall: '%0(...) called incorrectly', specialCheckFailed: '%0(...) special check failed', moreInfo: 'More info:', youPassed: 'You passed: ', collection: 'Collection:', availableSigsInclude: 'Available signatures include: ', errorThrown: 'When I called %0(...) with your args, an error was thrown!', repeatSelector: "You've used the same selector more than once.", info: 'Info', selector: 'Selector: ', selectorAdvice: "You should only use the same selector more than once when you know the returned collection will be different. For example, if you've added more elements to the page that may comply with the selector", noElementsFound: 'No elements were found with the selector: "%0"', combineCalls: 'Why not combine these calls by passing an object? E.g. \n%0(%1)', methodTwice: "You've called %0(...) more than once on the same jQuery object", triggeredBy: 'Triggered by %0 event', event: 'Event:', handler: 'Handler:', location: 'Location:', invalidFilters: 'Selector: %0\nYou used invalid filters (aka Pseudo classes):\n%1', badReadyCall: "Don't use jQuery().ready() - use jQuery(document).ready() instead. The former is likely to be deprecated in the future.", browser: "Don't use jQuery.browser", browserSafari: "Don't use jQuery.browser.safari - it's deprecated. If you have to use browser detection, then use jQuery.browser.webkit.", featureDetection: 'The jQuery team recommends against using jQuery.browser, please try to use feature detection instead (see jQuery.support).', boxModel: "Don't use jQuery.boxModel.", boxModelDeprecated: 'Deprecated in jQuery 1.3 (see jQuery.support)' }, de: { incorrectCall: '%0(...) falsch aufgerufen', specialCheckFailed: '%0(...) Spezial-Check fehlgeschlagen', moreInfo: 'Mehr Informationen:', youPassed: 'Du hast übergeben: ', collection: 'Sammlung:', availableSigsInclude: 'Verfügbare Signaturen enthalten: ', errorThrown: 'Als ich %0(...) mit deinen Argumenten aufgerufen habe, wurde ein Fehler geworfen!', repeatSelector: "Du hast den selben Selektor mehrmals verwendet.", info: 'Info', selector: 'Selektor: ', selectorAdvice: "Du solltest den selben Selektor nur dann verwenden, wenn du weißt dass sich das Ergebnis ändert. Zum Beispiel, wenn du Elemente zu einer Seite hinzufügst, die den Selektor erfüllen", noElementsFound: 'Keine Elemente gefunden für den Selektor: "%0"', combineCalls: 'Warum kombinierst du diese Aufrufen nicht, indem du ein Objekt übergibst? z.B. \n%0(%1)', methodTwice: "Du hast %0(...) mehr als ein mal auf dem selben jQuery-Objekt aufgerufen", triggeredBy: 'Vom %0-Event getriggert', event: 'Event:', handler: 'Handler:', location: 'Location:', invalidFilters: 'Selektor: %0\nDu hast fehlerhafte Filter verwendet (aka Pseudo Klassen):\n%1', badReadyCall: "Verwende jQuery().ready() nicht - verwende stattdessen jQuery(document).ready(). Ersteres wird wahrscheinlich in der Zukunft deprecated.", browser: "Verwende jQuery.browser nicht", browserSafari: "Verwende jQuery.browser.safari nicht - es ist deprecated. Wenn du eine Browser-Erkennung verwenden musst, nimm jQuery.browser.webkit.", featureDetection: 'Das jQuery-Team empfiehlt jQuery.browser nicht zu verwenden. Verwende lieber Feature-Erkennung (siehe jQuery.support).', boxModel: "Verwende jQuery.boxModel nicht.", boxModelDeprecated: 'Deprecated in jQuery 1.3 (siehe jQuery.support)' } }, // Define console if not defined // Access it via jQuery.LINT.console emptyFn = function(){}, _console = { warn: glob.console && console.warn ? function(){ console.warn.apply(console, arguments); } : emptyFn, group: glob.console && console.group ? function(){ console.group.apply(console, arguments); } : emptyFn, groupEnd: glob.console && console.groupEnd ? function(){ console.groupEnd(); } : emptyFn, groupCollapsed: glob.console && console.groupCollapsed ? function(){ console.groupCollapsed.apply(console, arguments); } : emptyFn, log: glob.console && console.log ? function(){ console.log.apply(console, arguments); } : emptyFn }, // Add specific checks // This is the best place to bring up bad practices checks = [ {/* Level 0 */}, {/* Level 1 */}, {/* Level 2 */}, {/* Level 3 */} ], addCheck = function(methodName, level, check) { level = Math.min(3, ~~level); (checks[level][methodName] || (checks[level][methodName] = [])).push(check); return lint; }, lint = { version: '1.01', level: 3, checks: checks, special: checks, // Support decrecated API addCheck: addCheck, lang: 'en', langs: langs, console: _console, throwErrors: false, enabledReports: { // True to report, false to supress noElementsFound: true, repeatSelector: true, browserSniffing: true, invalidFilters: true }, api: {"jQuery.proxy":[{added:"1.4",arg:[{name:"function",type:"Function"},{name:"scope",type:"Object",optional:true}]},{added:"1.4",arg:[{name:"scope",type:"Object"},{name:"name",type:"String"}]}],focusout:[{added:"1.4",arg:[{name:"handler(eventObject)",type:"Function"}]}],focusin:[{added:"1.4",arg:[{name:"handler(eventObject)",type:"Function"}]}],has:[{added:"1.4",arg:[{name:"selector",type:"String"}]},{added:"1.4",arg:[{name:"contained",type:"Element"}]},{added:"1.1.4"}],"jQuery.contains":[{added:"1.4",arg:[{name:"container",type:"Element"},{name:"contained",type:"Element"}]}],"jQuery.noop":[{added:"1.4"}],delay:[{added:"1.4",arg:[{name:"duration",type:"Integer"},{name:"queueName",type:"String",optional:true}]}],parentsUntil:[{added:"1.4",arg:[{name:"selector",type:"Selector",optional:true}]}],prevUntil:[{added:"1.4",arg:[{name:"selector",type:"Selector",optional:true}]}],nextUntil:[{added:"1.4",arg:[{name:"selector",type:"Selector",optional:true}]}],"event.isImmediatePropagationStopped":[{added:"1.3"}],"event.stopImmediatePropagation":[{added:"1.3"}],"event.isPropagationStopped":[{added:"1.3"}],"event.stopPropagation":[{added:"1.0"}],"event.isDefaultPrevented":[{added:"1.3"}],"event.preventDefault":[{added:"1.0"}],"event.timeStamp":[{added:"1.2.6"}],"event.result":[{added:"1.3"}],"event.which":[{added:"1.1.3"}],"event.pageY":[{added:"1.0.4"}],"event.pageX":[{added:"1.0.4"}],"event.currentTarget":[{added:"1.3"}],"event.relatedTarget":[{added:"1.1.4"}],"event.data":[{added:"1.1"}],"event.target":[{added:"1.0"}],"event.type":[{added:"1.0"}],"jQuery.fx.off":[{added:"1.3"}],each:[{added:"1.0",arg:[{name:"function(index, Element)",type:"Function"},{name:'args',type:'Array',optional:true}]}],"jQuery.pushStack":[{added:"1.0",arg:[{name:"elements",type:"Array"}]},{added:"1.3",arg:[{name:"elements",type:"Array"},{name:"name",type:"String"},{name:"arguments",type:"Array"}]}],"jQuery.globalEval":[{added:"1.0.4",arg:[{name:"code",type:"String"}]}],"jQuery.isXMLDoc":[{added:"1.1.4",arg:[{name:"node",type:"Element"}]}],"jQuery.removeData":[{added:"1.2.3",arg:[{type:'Element',name:'elem'},{name:"name",type:"String",optional:true}]}],"jQuery.data":[{added:"1.2.3",arg:[{name:"element",type:"Element"},{name:"key",type:"String"},{name:"value",type:"*"}]},{added:"1.2.3",arg:[{name:"element",type:"Element"},{name:"key",type:"String"}]},{added:"1.4",arg:[{name:'element',type:'Element'}]}],"jQuery.dequeue":[{added:"1.3",arg:[{name:"queueName",type:"String",optional:true}]}],"jQuery.queue":[{added:"1.3",arg:[{type:'Element',name:'elem'},{name:"queueName",type:"String",optional:true}]},{added:"1.3",arg:[{type:'Element',name:'elem'},{name:"queueName",type:"String",optional:true},{name:"newQueue",type:"Array"}]},{added:"1.3",arg:[{type:'Element',name:'elem'},{name:"queueName",type:"String",optional:true},{name:"callback()",type:"Function"}]}],clearQueue:[{added:"1.4",arg:[{name:"queueName",type:"String",optional:true}]}],toArray:[{added:"1.4"}],"jQuery.isEmptyObject":[{added:"1.4",arg:[{name:"object",type:"Object"}]}],"jQuery.isPlainObject":[{added:"1.4",arg:[{name:"object",type:"Object"}]}],keydown:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],index:[{added:"1.4"},{added:"1.4",arg:[{name:"selector",type:"Selector"}]},{added:"1.0",arg:[{name:"element",type:"Element, jQuery"}]}],removeData:[{added:"1.2.3",arg:[{name:"name",type:"String",optional:true}]}],data:[{added:"1.2.3",arg:[{name:"key",type:"String"},{name:"value",type:"*"}]},{added:"1.4",arg:[{name:"obj",type:"Object"}]},{added:"1.2.3",arg:[{name:"key",type:"String"}]},{added:"1.4"}],get:[{added:"1.0",arg:[{name:"index",type:"Number",optional:true}]}],size:[{added:"1.0"}],"jQuery.noConflict":[{added:"1.0",arg:[{name:"removeAll",type:"Boolean",optional:true}]}],selected:[{added:"1.0"}],checked:[{added:"1.0"}],disabled:[{added:"1.0"}],enabled:[{added:"1.0"}],file:[{added:"1.0"}],button:[{added:"1.0"}],reset:[{added:"1.0"}],image:[{added:"1.0"}],submit:[{added:"1.0"},{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],checkbox:[{added:"1.0"}],radio:[{added:"1.0"}],password:[{added:"1.0"}],text:[{added:"1.0"},{added:"1.0"},{added:"1.0",arg:[{name:"textString",type:"String"}]},{added:"1.4",arg:[{name:"function(index, text)",type:"Function"}]}],input:[{added:"1.0"}],"only-child":[{added:"1.1.4"}],"last-child":[{added:"1.1.4"}],"first-child":[{added:"1.1.4"}],"nth-child":[{added:"1.1.4",arg:[{name:"index",type:"Number/String"}]}],attributeContainsPrefix:[{added:"1.0",arg:[{name:"attribute",type:"String"},{name:"value",type:"String"}]}],attributeContainsWord:[{added:"1.0",arg:[{name:"attribute",type:"String"},{name:"value",type:"String"}]}],attributeMultiple:[{added:"1.0",arg:[{name:"attributeFilter1",type:"Selector"},{name:"attributeFilter2",type:"Selector"},{name:"attributeFilterN",type:"Selector",optional:true}]}],attributeContains:[{added:"1.0",arg:[{name:"attribute",type:"String"},{name:"value",type:"String"}]}],attributeEndsWith:[{added:"1.0",arg:[{name:"attribute",type:"String"},{name:"value",type:"String"}]}],attributeStartsWith:[{added:"1.0",arg:[{name:"attribute",type:"String"},{name:"value",type:"String"}]}],attributeNotEqual:[{added:"1.0",arg:[{name:"attribute",type:"String"},{name:"value",type:"String"}]}],attributeEquals:[{added:"1.0",arg:[{name:"attribute",type:"String"},{name:"value",type:"String"}]}],attributeHas:[{added:"1.0",arg:[{name:"attribute",type:"String"}]}],visible:[{added:"1.0"}],hidden:[{added:"1.0"}],parent:[{added:"1.0"},{added:"1.0",arg:[{name:"selector",type:"Selector",optional:true}]}],empty:[{added:"1.0"},{added:"1.0"}],contains:[{added:"1.1.4"}],animated:[{added:"1.2"}],header:[{added:"1.2"}],lt:[{added:"1.0",arg:[{name:"index",type:"Number"}]}],gt:[{added:"1.0"}],eq:[{added:"1.0",arg:[{name:"index",type:"Number"}]},{added:"1.1.2",arg:[{name:"index",type:"Integer"}]}],odd:[{added:"1.0"}],even:[{added:"1.0"}],not:[{added:"1.0",arg:[{name:"selector",type:"Selector"}]},{added:"1.0",arg:[{name:"selector",type:"Selector"}]},{added:"1.0",arg:[{name:"elements",type:"Elements"}]},{added:"1.0",arg:[{name:"function(index)",type:"Function"}]}],last:[{added:"1.0"},{added:"1.2"}],first:[{added:"1.0"},{added:"1.2"}],"next siblings":[{added:"1.0",arg:[{name:"prev",type:"Selector"},{name:"siblings",type:"Selector"}]}],"next adjacent":[{added:"1.0",arg:[{name:"prev",type:"Selector"},{name:"next",type:"Selector"}]}],child:[{added:"1.0",arg:[{name:"parent",type:"Selector"},{name:"child",type:"Selector"}]}],descendant:[{added:"1.0",arg:[{name:"ancestor",type:"Selector"},{name:"descendant",type:"Selector"}]}],multiple:[{added:"1.0",arg:[{name:"selector1",type:"Selector"},{name:"selector2",type:"Selector"},{name:"selectorN",type:"Selector",optional:true}]}],all:[{added:"1.0"}],"class":[{added:"1.0",arg:[{name:"class",type:"String"}]}],element:[{added:"1.0",arg:[{name:"element",type:"String"}]}],id:[{added:"1.0",arg:[{name:"id",type:"String"}]}],scroll:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],resize:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],dequeue:[{added:"1.2",arg:[{name:"queueName",type:"String",optional:true}]}],queue:[{added:"1.2",arg:[{name:"queueName",type:"String",optional:true}]},{added:"1.2",arg:[{name:"queueName",type:"String",optional:true},{name:"newQueue",type:"Array"}]},{added:"1.2",arg:[{name:"queueName",type:"String",optional:true},{name:"callback( next )",type:"Function"}]}],keyup:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],keypress:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],select:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],change:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],blur:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],focus:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],mousemove:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],hover:[{added:"1.0",arg:[{name:"handlerIn(eventObject)",type:"Function"},{name:"handlerOut(eventObject)",type:"Function"}]},{added:'1.4',arg:[{name:'handlerInOut(eventObject)',type:'Function'}]}],mouseleave:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],mouseenter:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],mouseout:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],mouseover:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],dblclick:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],click:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],mouseup:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],mousedown:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0"}],error:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]}],unload:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]}],load:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"}]},{added:"1.0",arg:[{name:"url",type:"String"},{name:"data",type:"Map, String",optional:true},{name:"success(responseText, textStatus, XMLHttpRequest)",type:"Function",optional:true}]}],ready:[{added:"1.0",arg:[{name:"handler",type:"Function"}]}],die:[{added:"1.3",arg:[{name:"eventType",type:"String"},{name:"handler",type:"String",optional:true}]}],"jQuery.browser":[{added:"1.0"}],"jQuery.browser.version":[{added:"1.1.3"}],live:[{added:"1.3",arg:[{name:"eventType",type:"String"},{name:"handler",type:"Function"}]},{added:"1.4",arg:[{name:"eventType",type:"String"},{name:"eventData",type:"Object",optional:true},{name:"handler",type:"Function"}]}],triggerHandler:[{added:"1.2",arg:[{name:"eventType",type:"String"},{name:"extraParameters",type:"Array",optional:true}]}],trigger:[{added:"1.0",arg:[{name:"eventType",type:"String"},{name:"extraParameters",type:"Array",optional:true}]}],ajaxComplete:[{added:"1.0",arg:[{name:"handler(event, XMLHttpRequest, ajaxOptions)",type:"Function"}]}],one:[{added:"1.1",arg:[{name:"eventType",type:"String"},{name:"eventData",type:"notFunction",optional:true},{name:"handler(eventObject)",type:"Function"}]},{added:"1.4",arg:[{name:"events",type:"Object"}]}],serializeArray:[{added:"1.2"}],serialize:[{added:"1.0"}],"jQuery.ajaxSetup":[{added:"1.1",arg:[{name:"options",type:"Options"}]}],ajaxSuccess:[{added:"1.0",arg:[{name:"handler(event, XMLHttpRequest, ajaxOptions)",type:"Function"}]}],ajaxStop:[{added:"1.0",arg:[{name:"handler()",type:"Function"}]}],ajaxStart:[{added:"1.0",arg:[{name:"handler()",type:"Function"}]}],ajaxSend:[{added:"1.0",arg:[{name:"handler(event, XMLHttpRequest, ajaxOptions)",type:"Function"}]}],ajaxError:[{added:"1.0",arg:[{name:"handler(event, XMLHttpRequest, ajaxOptions, thrownError)",type:"Function"}]}],unbind:[{added:"1.0",arg:[{name:"eventType",type:"String"},{name:"handler(eventObject)",type:"Function",optional:true}]},{added:"1.4",arg:[{name:"events",type:"Object"}]}],bind:[{added:"1.0",arg:[{name:"eventType",type:"String"},{name:"eventData",type:"notFunction",optional:true},{name:"handler(eventObject)",type:"Function"}]},{added:"1.4",arg:[{name:"events",type:"Object"}]}],slice:[{added:"1.1.4",arg:[{name:"start",type:"Integer"},{name:'end',type:'Integer',optional:true}]},{added:"1.1.4",arg:[{name:"end",type:"Integer",optional:true}]}],jQuery:[{added:"1.0",arg:[{name:"selector",type:"selector"},{name:"context",type:"Element, jQuery",optional:true}]},{added:"1.0",arg:[{name:"element",type:"Element"}]},{added:"1.0",arg:[{name:"elementArray",type:"Array"}]},{added:"1.0",arg:[{name:"jQuery object",type:"Object"}]},{added:"1.4"},{added:"1.0",arg:[{name:"html",type:"String"},{name:"ownerDocument",type:"document",optional:true}]},{added:"1.4",arg:[{name:"html",type:"String"},{name:"props",type:"Object"}]},{added:"1.0",arg:[{name:"callback",type:"Function"}]}],stop:[{added:"1.2",arg:[{name:"clearQueue",type:"Boolean",optional:true},{name:"jumpToEnd",type:"Boolean",optional:true}]}],end:[{added:"1.0"}],andSelf:[{added:"1.2"}],siblings:[{added:"1.0",arg:[{name:"selector",type:"Selector",optional:true}]}],animate:[{added:"1.0",arg:[{name:"properties",type:"Options"},{name:"duration",type:"String,Number",optional:true},{name:"easing",type:"String",optional:true},{name:"callback",type:"Callback",optional:true}]},{added:"1.0",arg:[{name:"properties",type:"Options"},{name:"options",type:"Options"}]}],prevAll:[{added:"1.2",arg:[{name:"selector",type:"Selector",optional:true}]}],prev:[{added:"1.0",arg:[{name:"selector",type:"Selector",optional:true}]}],fadeTo:[{added:"1.0",arg:[{name:"duration",type:"String,Number"},{name:"opacity",type:"Number"},{name:"callback",type:"Callback",optional:true}]}],fadeOut:[{added:"1.0",arg:[{name:"duration",type:"String,Number",optional:true},{name:"callback",type:"Callback",optional:true}]}],parents:[{added:"1.0",arg:[{name:"selector",type:"Selector",optional:true}]}],fadeIn:[{added:"1.0",arg:[{name:"duration",type:"String,Number",optional:true},{name:"callback",type:"Callback",optional:true}]}],offsetParent:[{added:"1.26"}],slideToggle:[{added:"1.0",arg:[{name:"duration",type:"String,Number",optional:true},{name:"callback",type:"Callback",optional:true}]}],"jQuery.post":[{added:"1.0",arg:[{name:"url",type:"String"},{name:"data",type:"Map, String",optional:true},{name:"success(data, textStatus)",type:"Function",optional:true},{name:"dataType",type:"String",optional:true}]}],slideUp:[{added:"1.0",arg:[{name:"duration",type:"String,Number",optional:true},{name:"callback",type:"Callback",optional:true}]}],nextAll:[{added:"1.2",arg:[{name:"selector",type:"String",optional:true}]}],next:[{added:"1.0",arg:[{name:"selector",type:"Selector",optional:true}]}],slideDown:[{added:"1.0",arg:[{name:"duration",type:"String,Number",optional:true},{name:"callback",type:"Callback",optional:true}]}],find:[{added:"1.0",arg:[{name:"selector",type:"Selector"}]}],"jQuery.getScript":[{added:"1.0",arg:[{name:"url",type:"String"},{name:"success(data, textStatus)",type:"Function",optional:true}]}],contents:[{added:"1.2"}],closest:[{added:"1.3",arg:[{name:"selector",type:"Selector"}]},{added:"1.4",arg:[{name:"selector",type:"Selector"},{name:"context",type:"Element",optional:true}]},{added:"1.4",arg:[{name:"selectors",type:"Array"},{name:"context",type:"Element",optional:true}]}],"jQuery.getJSON":[{added:"1.0",arg:[{name:"url",type:"String"},{name:"data",type:"Map",optional:true},{name:"callback(data, textStatus)",type:"Function",optional:true}]}],"jQuery.get":[{added:"1.0",arg:[{name:"url",type:"String"},{name:"data",type:"Map, String",optional:true},{name:"callback(data, textStatus, XMLHttpRequest)",type:"Function",optional:true},{name:"dataType",type:"String",optional:true}]}],"jQuery.ajax":[{added:"1.0",arg:[{name:"settings",type:"Map"}]}],length:[{added:"1.0"}],children:[{added:"1.0",arg:[{name:"selector",type:"Selector",optional:true}]}],selector:[{added:"1.3"}],add:[{added:"1.0",arg:[{name:"selector",type:"Selector"}]},{added:"1.0",arg:[{name:"elements",type:"Elements"}]},{added:"1.0",arg:[{name:"html",type:"HTML"}]},{added:"1.4",arg:[{name:"selector",type:"Selector"},{name:"context",type:"Element"}]}],context:[{added:"1.3"}],outerWidth:[{added:"1.2.6",arg:[{name:"includeMargin",type:"Boolean",optional:true}]}],outerHeight:[{added:"1.2.6",arg:[{name:"includeMargin",type:"Boolean",optional:true}]}],toggle:[{added:"1.0",arg:[{name:"handler(eventObject)",type:"Function"},{name:"handler(eventObject)",type:"Function"},{name:"handler(eventObject)",type:"Function",optional:true}]},{added:"1.0",arg:[{name:"duration",type:"String,Number",optional:true},{name:"callback",type:"Callback",optional:true}]},{added:"1.3",arg:[{name:"showOrHide",type:"Boolean"}]}],innerWidth:[{added:"1.2.6"}],innerHeight:[{added:"1.2.6"}],"jQuery.param":[{added:"1.2",arg:[{name:"obj",type:"Array, Object"}]},{added:"1.4",arg:[{name:"obj",type:"Array, Object"},{name:"traditional",type:"Boolean"}]}],hide:[{added:"1.0"},{added:"1.0",arg:[{name:"duration",type:"String,Number"},{name:"callback",type:"",optional:true}]}],width:[{added:"1.0"},{added:"1.0",arg:[{name:"value",type:"String, Number"}]}],height:[{added:"1.0"},{added:"1.0",arg:[{name:"value",type:"String, Number"}]}],show:[{added:"1.0"},{added:"1.0",arg:[{name:"duration",type:"String,Number"},{name:"callback",type:"Callback",optional:true}]}],scrollLeft:[{added:"1.2.6"},{added:"1.2.6",arg:[{name:"value",type:"Number"}]}],"jQuery.trim":[{added:"1.0"}],"jQuery.isFunction":[{added:"1.2"}],"jQuery.isArray":[{added:"1.3",arg:[{name:"obj",type:"Object"}]}],"jQuery.unique":[{added:"1.1.3",arg:[{name:"array",type:"Array"}]}],"jQuery.merge":[{added:"1.0",arg:[{name:"first",type:"Array"},{name:"second",type:"Array"}]}],"jQuery.inArray":[{added:"1.2",arg:[{name:"value",type:"Any"},{name:"array",type:"Array"}]}],"jQuery.map":[{added:"1.0",arg:[{name:"array",type:"Array"},{name:"callback(elementOfArray, indexInArray)",type:"Function"}]}],"jQuery.makeArray":[{added:"1.2",arg:[{name:"obj",type:"Object"}]}],"jQuery.grep":[{added:"1.0",arg:[{name:"array",type:"Array"},{name:"function(elementOfArray, indexInArray)",type:"Function"},{name:"invert",type:"Boolean",optional:true}]}],"jQuery.extend":[{added:"1.0",arg:[{name:"target",type:"Object, Function"},{name:"object1",type:"Object",optional:true},{name:"objectN",type:"Object",optional:true}]},{added:"1.1.4",arg:[{name:"deep",type:"Boolean",optional:true},{name:"target",type:"Object, Function"},{name:"object1",type:"Object"},{name:"objectN",type:"Object",optional:true}]}],"jQuery.each":[{added:"1.0",arg:[{name:"object",type:"Object, Array"},{name:"callback(indexInArray, valueOfElement)",type:"Function"},{name:'args',type:'Array',optional:true}]}],"jQuery.boxModel":[{added:"1.0"}],scrollTop:[{added:"1.2.6"},{added:"1.2.6",arg:[{name:"value",type:"Number"}]}],"jQuery.support":[{added:"1.3"}],position:[{added:"1.2"}],offset:[{added:"1.2"},{added:"1.4",arg:[{name:"coordinates",type:"Object"}]},{added:"1.4",arg:[{name:"function(index, coords)",type:"Function"}]}],css:[{added:"1.0",arg:[{name:"propertyName",type:"String"}]},{added:"1.0",arg:[{name:"propertyName",type:"String"},{name:"value",type:"String, Number"}]},{added:"1.4",arg:[{name:"propertyName",type:"String"},{name:"function(index, value)",type:"Function"}]},{added:"1.0",arg:[{name:"map",type:"Map"}]}],unwrap:[{added:"1.4"}],detach:[{added:"1.4",arg:[{name:"selector",type:"Selector",optional:true}]}],clone:[{added:"1.0",arg:[{name:"withDataAndEvents",type:"Boolean",optional:true}]}],remove:[{added:"1.0",arg:[{name:"selector",type:"String",optional:true}]}],replaceAll:[{added:"1.2"}],replaceWith:[{added:"1.2",arg:[{name:"newContent",type:"String, Element, jQuery"}]},{added:"1.4",arg:[{name:"function",type:"Function"}]}],wrapInner:[{added:"1.2",arg:[{name:"wrappingElement",type:"String"}]},{added:"1.4",arg:[{name:"wrappingFunction",type:"Function"}]}],wrapAll:[{added:"1.2",arg:[{name:"wrappingElement",type:"String, Selector, Element, jQuery"}]}],wrap:[{added:"1.0",arg:[{name:"wrappingElement",type:"String, Selector, Element, jQuery"}]},{added:"1.4",arg:[{name:"wrappingFunction",type:"Function"}]}],insertBefore:[{added:"1.0",arg:[{name:"target",type:"Selector, Element, jQuery"}]}],before:[{added:"1.0",arg:[{name:"content",type:"String, Element, jQuery"}]},{added:"1.4",arg:[{name:"function",type:"Function"}]}],insertAfter:[{added:"1.0",arg:[{name:"target",type:"Selector, Element, jQuery"}]}],after:[{added:"1.0",arg:[{name:"content",type:"String, Element, jQuery"}]},{added:"1.4",arg:[{name:"function",type:"Function"}]}],prependTo:[{added:"1.0",arg:[{name:"target",type:"Selector, Element, jQuery"}]}],prepend:[{added:"1.0",arg:[{name:"content",type:"String, Element, jQuery",multiple:true}]},{added:"1.4",arg:[{name:"function(index, html)",type:"Function"}]}],appendTo:[{added:"1.0",arg:[{name:"target",type:"Selector, Element, jQuery"}]}],append:[{added:"1.0",arg:[{name:"content",type:"String, Element, jQuery",multiple:true}]},{added:"1.4",arg:[{name:"function(index, html)",type:"Function"}]}],val:[{added:"1.0"},{added:"1.0",arg:[{name:"value",type:"String"}]},{added:"1.4",arg:[{name:"function",type:"Function"}]}],html:[{added:"1.0"},{added:"1.0",arg:[{name:"htmlString",type:"String"}]},{added:"1.4",arg:[{name:"function(index, html)",type:"Function"}]}],map:[{added:"1.2",arg:[{name:"callback(index, domElement)",type:"Function"}]}],is:[{added:"1.0",arg:[{name:"selector",type:"Selector"}]}],filter:[{added:"1.0",arg:[{name:"selector",type:"Selector"}]},{added:"1.0",arg:[{name:"function(index)",type:"Function"}]}],toggleClass:[{added:"1.0",arg:[{name:"className",type:"String"}]},{added:"1.3",arg:[{name:"className",type:"String"},{name:"switch",type:"Boolean"}]},{added:"1.4",arg:[{name:"function(index, class)",type:"Function"},{name:"switch",type:"Boolean",optional:true}]}],removeClass:[{added:"1.0",arg:[{name:"className",type:"String",optional:true}]},{added:"1.4",arg:[{name:"function(index, class)",type:"Function"}]}],hasClass:[{added:"1.2",arg:[{name:"className",type:"String"}]}],removeAttr:[{added:"1.0",arg:[{name:"attributeName",type:"String"}]}],attr:[{added:"1.0",arg:[{name:"attributeName",type:"String"}]},{added:"1.0",arg:[{name:"attributeName",type:"String"},{name:"value",type:"*"}]},{added:"1.0",arg:[{name:"map",type:"Map"}]},{added:"1.1",arg:[{name:"attributeName",type:"String"},{name:"function(index, attr)",type:"Function"}]}],addClass:[{added:"1.0",arg:[{name:"className",type:"String"}]},{added:"1.4",arg:[{name:"function(index, class)",type:"Function"}]}]} }, api = lint.api, // Only cover certain fns under the jQ namespace coveredNamespace = /^(getJSON|extend|ajax|get|post|proxy|each|map|queue|ajax|ajaxSetup|removeData|data|pushStack)$/, version = _jQuery.fn.jquery, map = _jQuery.map, each = _jQuery.each, extend = _jQuery.extend, find = _jQuery.find, undefined, arrSlice = Array.prototype.slice, slice = function(a,s,e) { return a.length ? arrSlice.call(a, s || 0, e || a.length) : []; }, compare = function(a,b) { // Compare two arrays var i = a.length; if (a.length !== b.length) { return false; } while (i--) { if (a[i] !== b[i]) { return false; } } return true; }, isFunction = function(obj) { return toString.call(obj) === "[object Function]"; }, isArray = function(obj) { return toString.call(obj) === "[object Array]"; }, toString = Object.prototype.toString, typeToString = function(o) { if (!o) { return ""; } if (typeof o === 'string') { return '"' + o.replace(/"/g,'\\"') + '"'; } if (isFunction(o)) { return 'function(){...}'; } return o.toString(); }, shaveArray = function(arr) { arr = slice(arr); // Shave "undefined" off the end of args for (var i = arr.length; i--;) { if (arr[i] === undefined) { arr.splice(i, 1); } else { break; } } return arr; }, // Type map types = { '*': function() { return true; }, selector: function(o) { return this.string(o); }, element: function(o) { return o && (!!o.nodeName || o === window); }, elements: function(o) { return this.element(o) || this.jquery(o) || this.array(o); }, array: function(o) { // Just check that it's "array-like" return o && o.length !== undefined && typeof o !== 'string' && !isFunction(o); }, jquery: function(o) { return o instanceof _jQuery; }, object: function(o) { return toString.call(o) === '[object Object]'; }, 'function': function(o) { return isFunction(o); }, notfunction: function(o) { return !this['function'](o); }, callback: function(o) { return isFunction(o); }, string: function(o) { return typeof o === 'string'; }, number: function(o) { return typeof o === 'number' && !isNaN(o); }, integer: function(o) { return this.number(o) && ~~o === o; }, map: function(o) { return this.object(o); }, options: function(o) { return this.object(o); }, 'null': function(o) { return o === null; }, 'boolean': function(o) { return typeof o === 'boolean'; } }, selectorCache = {}, jQueryMethods = extend({}, _jQuery.fn), internal = false, fromInit = false; function logLocation() { // Attempt to log line number of error try { throw new Error(); } catch(e) { if (e.stack) { lint.console.groupCollapsed(lint.langs[lint.lang].location); lint.console.log( e.stack // Remove everything before the file name and line number // plus, get rid of errors from jQuery.lint.js & any libs // from google's CDN (not perfect but should narrow it down) .replace(/^.+?\n|.+?(jquery\.lint\.js|http:\/\/ajax\.googleapis\.com).+?(\n|$)|.+?(?=@)/g, '') // Remove duplicates .replace(/(^|\n)(.+?)\n(?=\2(?:\n|$)|[\s\S]+?\n\2(?:\n|$))/g, '$1') ); lint.console.groupEnd(); } } } function isValidArgumentList(args, sig) { // Determine if argument list complies with // signature outlined in API. var matches = false, sigArg, argLength = args.length, nextIsOptional = false; if (version < sig.added) { // Too new return false; } if (!sig.arg) { return 0 === args.length; } if (!sig.arg[0] && (args.length > 1)) { return false; } for ( var sigIndex = 0, argIndex = 0, fullLength = Math.max(argLength, sig.arg.length || 1); sigIndex < fullLength || argIndex < argLength; ++sigIndex ) { sigArg = sigIndex === 0 ? sig.arg[0] || sig.arg : sig.arg[sigIndex]; if (!sigArg) { // Too many args return false; } matches = isValidType(sigArg.type, args[argIndex]); if (!matches) { if (sigArg.optional) { if (args[argIndex] === undefined || args[argIndex] === null) { ++argIndex; matches = true; } continue; } else { // Sig isn't optional return false; } } if (sigArg.multiple) { // If it's multiple, then carry on with the same // signature, but check that there are remaining // arguments --sigIndex; if (argIndex + 1 >= argLength) { break; } } ++argIndex; } return matches; } function isValidType(type, arg) { // Check that argument is of the right type // The types are specified within the API data var split = type.split(/,\s?/g), i = split.length, cur; if (arg === undefined) { return false; } while (i--) { cur = split[i].toLowerCase(); if (types[cur] && types[cur](arg)) { return true; } } return false; } function runFunction(fn, args, isInternal, thisObj) { // Runs a function, while enabling/disabling // the 'internal' flag as necessary. var wasInternal = internal, ret; internal = isInternal; try { ret = fn.apply(thisObj, args); } catch(e) { internal = wasInternal; throw e; } internal = wasInternal; return ret; } function registerMethod(name, methodAPI) { var obj = /^jQuery\./.test(name) ? _jQuery : _jQuery.fn, methodName = name.replace(/^jQuery\./, ''); obj[methodName] = (function(meth, name){ return extend(function() { var args = slice(arguments), _internal = internal; // Cover functions so that the internal flag // is disabled before they are called each(args, function(i, fn){ if (typeof fn == 'function') { args[i] = function() { // Run it as non-internal return runFunction(fn, arguments, _internal, this); }; } }); return coverMethod.call(this, name, function(){ // Run it as internal return runFunction(meth, args, true, this); }, args); }, meth); })(obj[methodName], name); if (methodAPI) { api[name] = methodAPI; } } lint.registerMethod = registerMethod; function coverMethod(name, meth, args) { args = shaveArray(args); var locale = lint.langs[lint.lang], sigs = api[name], _console = lint.console, self = this, i = 0, sig, specialCheckResults = (function(){ // Perform special checks for current level and // all levels below current level. var lvl = lint.level + 1, results = [], check; while (lvl--) { if (checks[lvl] && (check = checks[lvl][name])) { if (types.array(check)) { each(check, function(i, chk){ results.push( chk.apply(self, args) ); }) } else { results.push( check.apply(self, args) ); } } } return results; }()), signatureMatch = false, sliced = slice(this, 0, 10); if (!sigs || !lint.level || internal) { return meth.apply(this, args); } if (this.length > 10) { sliced.push('...'); } // Check all arguments passed to method for compliance // against the corresponding signature. while ((sig = sigs[i++])) { if ( isValidArgumentList(args, sig) ) { signatureMatch = true; break; } } if (!signatureMatch) { // Args !== signature _console.warn(locale.incorrectCall.replace(/%0/, name)); _console.groupCollapsed(locale.moreInfo); if (this instanceof _jQuery) { _console.log(locale.collection, sliced); } logLocation(); _console.log(locale.youPassed, args); _console.group(locale.availableSigsInclude); each(sigs, function(i, sig){ if (version < sig.added) { return; } var sigArgs = sig.arg; _console.log( name + '(' + (sigArgs ? sigArgs[0] ? map(sigArgs, function(sig, i){ return sig ? sig.optional ? '[' + sig.name + ']' : sig.multiple ? sig.name + ',[...]' : sig.name : []; }).join(', ') : sigArgs.name : '') + ')' ); }); _console.groupEnd(); _console.groupEnd(); } if (specialCheckResults.length) { each(specialCheckResults, function(i, checkResult){ if (checkResult && checkResult !== true) { if (isFunction(checkResult)) { checkResult(_console); } else { _console.warn(locale.specialCheckFailed.replace(/%0/, name)); _console.groupCollapsed(locale.moreInfo); _console.log(checkResult); _console.log(locale.collection, sliced); logLocation(); _console.groupEnd(); } } }); } if (lint.throwErrors) { return meth.apply(this, args); } try { return meth.apply(this, args); } catch(e) { _console.warn( locale.errorThrown.replace(/%0/, name), e ); _console.groupCollapsed(locale.moreInfo); logLocation(); _console.log(locale.youPassed, args); _console.groupEnd(); return this; } } // "Cover" init constructor // Reports when no elements found, and when selector // used more than once to no effect. _jQuery.fn.init = (function(_init){ return function(selector, context) { var locale = lint.langs[lint.lang], ret = coverMethod.call(this, 'jQuery', function(){ return runFunction(function(){ return new _init(selector, context); }, [], true, this) }, arguments), _console = lint.console; // Deal with situations where no elements are returned // and for the same selector being used more than once // to no effect if (!internal && typeof selector === 'string' && lint.level > 1) { if (ret[0]) { // Check for identical collection already in cache. if ( lint.enabledReports.repeatSelector && selectorCache[selector] && compare(selectorCache[selector], ret) ) { _console.warn(locale.repeatSelector); _console.groupCollapsed(locale.info); logLocation(); _console.log(locale.selector + '"' + selector + '"'); _console.log(locale.selectorAdvice); _console.groupEnd(); } } else { if (lint.enabledReports.noElementsFound) { lint.console.warn(lint.langs[lint.lang].noElementsFound.replace(/%0/, selector)); logLocation(); } } selectorCache[selector] = ret; } return ret; }; })(_jQuery.fn.init); for (var i in _jQuery.fn) { if (i !== 'init' && isFunction(_jQuery.fn[i])) { registerMethod(i); } } for (var i in _jQuery) { if ( coveredNamespace.test(i) && isFunction(_jQuery[i]) ) { registerMethod('jQuery.' + i); } } _jQuery.LINT = lint; ///////////////////////// // Some special checks // ///////////////////////// addCheck('jQuery', 2, function(selector) { var locale = locale = lint.langs[lint.lang]; // Find invalid filters (e.g. :hover, :active etc.) // suggested by Paul Irish if (!internal && lint.enabledReports.invalidFilters && typeof selector === 'string' && !/^[^<]*(<[\w\W]+>)[^>]*$/.test(selector)) { // It's a string, and NOT html - must be a selector var invalidFilters = []; selector.replace(/('|")(?:\\\1|[^\1])+?\1/g, '').replace(/:(\w+)/g, function(m, filter){ if (!/^(contains|not)$/.test(filter) && !((filter in _jQuery.expr[':']) || (filter in _jQuery.expr.setFilters))) { invalidFilters.push(m); } }); if (invalidFilters.length) { return locale.invalidFilters.replace(/%0/, selector).replace(/%1/, invalidFilters.join('\n')); } } }); addCheck('jQuery', 2, function() { // Set flag for ready() method, so we can check // for $().ready() - which should be $(document).ready() // suggested by Paul Irish if (!arguments.length) { this._lint_noArgs = true; } }); addCheck('ready', 2, function(){ // If _lint_noArgs is set then this object // was instantiated with no args. I.e. $().ready() if (this._lint_noArgs) { return lint.langs[lint.lang].badReadyCall; } }); // Check for calls like css().css().css() // May as well use css({...}) each(['css','attr','bind','one'], function(i, methodName){ addCheck(methodName, 3, function(){ var args = arguments, hoc = this, locale = lint.langs[lint.lang], sliced = slice(hoc, 0, 10), _console = lint.console; if (hoc.length > 10) { sliced.push('...'); } if ( !internal && lint.level > 2 && !types.object(args[0]) && ( (/^(css|attr)$/.test(methodName) && args[1] !== undefined) || (/^(bind|one)$/.test(methodName) && version >= '1.4' && /* Data no passed as [1] */!isFunction(args[2])) ) ) { if (this._lastMethodCalled === methodName) { _console.warn(locale.methodTwice.replace(/%0/, methodName)); _console.groupCollapsed(locale.moreInfo); _console.log(locale.collection, sliced); _console.log(args); _console.log( locale.combineCalls .replace(/%0/, methodName) .replace(/%1/, '{\n' + map([args, hoc._lastMethodArgs], function(a){ return ' "' + a[0] + '": ' + typeToString(a[1]); }).join(',\n') + '\n}') ); _console.groupEnd(); } hoc._lastMethodCalled = methodName; hoc._lastMethodArgs = args; setTimeout(function(){ hoc._lastMethodCalled = null; hoc._lastMethodArgs = null; }, 0); } }); }); each( ['find', 'children', 'parent', 'parents', 'next', 'nextAll', 'prev', 'prevAll', 'first', 'last', 'closest', 'siblings', 'parentsUntil', 'nextUntil', 'prevUntil'], function(i, methodName) { var pureMethod = jQueryMethods[methodName]; addCheck(methodName, 2, function(selector){ if ( !internal && lint.enabledReports.noElementsFound && !runFunction(pureMethod, arguments, true, this).length ) { if (types['function'](selector)) { selector = '[FUNCTION]'; } lint.console.warn(lint.langs[lint.lang].noElementsFound.replace(/%0/, selector)); logLocation(); } }); } ) })();