jQuery, at its core, is a Document Object Model (DOM) manipulation library. The DOM is a tree-structure representation of all the elements of a Web page. jQuery simplifies the syntax for finding, selecting, and manipulating these DOM elements. For example, jQuery can be used for finding an element in the document with a certain property (e.g. all elements with the h1 tag), changing one or more of its attributes (e.g. color, visibility), or making it respond to an event (e.g. a mouse click).
jQuery also provides a paradigm for event handling that goes beyond basic DOM element selection and manipulation. The event assignment and the event callback function definition are done in a single step in a single location in the code. jQuery also aims to incorporate other highly used JavaScript functionality (e.g. fade ins and fade outs when hiding elements, animations by manipulating CSS properties).
The principles of developing with jQuery are:
jQuery was originally created in January 2006 at BarCamp NYC by John Resig, influenced by Dean Edwards' earlier cssQuery library.1011 It is currently maintained by a team of developers led by Timmy Willison (with the jQuery selector engine, Sizzle, being led by Richard Gibson).12
jQuery was originally licensed under the CC BY-SA 2.5, and relicensed to the MIT License in 2006.13 At the end of 2006, it was dual-licensed under GPL and MIT licenses.14 As this led to some confusion, in 2012 the GPL was dropped and is now only licensed under the MIT license.15
jQuery includes the following features:
jQuery 3.0 and newer supports "current−1 versions" (meaning the current stable version of the browser and the version that preceded it) of Firefox (and ESR), Chrome, Safari, and Edge as well as Internet Explorer 9 and newer. On mobile it supports iOS 7 and newer, and Android 4.0 and newer.23
The jQuery library is typically distributed as a single JavaScript file that defines all its interfaces, including DOM, Events, and Ajax functions. It can be included within a Web page by linking to a local copy or by linking to one of the many copies available from public servers. jQuery has a content delivery network (CDN) hosted by MaxCDN.24 Google in Google Hosted Libraries service and Microsoft host the library as well.2526
Example of linking a copy of the library locally (from the same server that hosts the Web page):
Example of linking a copy of the library from jQuery's public CDN:
jQuery provides two kinds of functions, static utility functions and jQuery object methods. Each has its own usage style.
Both are accessed through jQuery's main identifier: jQuery. This identifier has an alias named $.27 All functions can be accessed through either of these two names.
The jQuery function is a factory for creating a jQuery object that represents one or more DOM nodes. jQuery objects have methods to manipulate these nodes. These methods (sometimes called commands), are chainable as each method also returns a jQuery object.
Access to and manipulation of multiple DOM nodes in jQuery typically begins with calling the $ function with a CSS selector string. This returns a jQuery object referencing all the matching elements in the HTML page. $("div.test"), for example, returns a jQuery object with all the div elements that have the class test. This node set can be manipulated by calling methods on the returned jQuery object.
These are utility functions and do not directly act upon a jQuery object. They are accessed as static methods on the jQuery or $ identifier. For example, $.ajax() is a static method.
jQuery provides a $.noConflict() function, which relinquishes control of the $ name. This is useful if jQuery is used on a Web page also linking another library that demands the $ symbol as its identifier. In no-conflict mode, developers can use jQuery as a replacement for $ without losing functionality.28
Typically, jQuery is used by putting initialization code and event handling functions in $(handler). This is triggered by jQuery when the browser has finished constructing the DOM for the current Web page.
or
Historically, $(document).ready(callback) has been the de facto idiom for running code after the DOM is ready. However, since jQuery 3.0, developers are encouraged to use the much shorter $(handler) signature instead.29
jQuery object methods typically also return a jQuery object, which enables the use of method chains:
This line finds all div elements with class attribute test , then registers an event handler on each element for the "click" event, then adds the class attribute foo to each element.
Certain jQuery object methods retrieve specific values (instead of modifying a state). An example of this is the val() method, which returns the current value of a text input element. In these cases, a statement such as $('#user-email').val() cannot be used for chaining as the return value does not reference a jQuery object.
Besides accessing existing DOM nodes through jQuery, it is also possible to create new DOM nodes, if the string passed as the argument to $() factory looks like HTML. For example, the below code finds an HTML select element, and creates a new option element with the value VAG and the label Volkswagen, which is then appended to the select menu:
It is possible to make Ajax requests (with cross-browser support) with $.ajax() to load and manipulate remote data.
This example posts the data name=John and location=Boston to /process/submit.php on the server. When this request finishes the success function is called to alert the user. If the request fails it will alert the user to the failure, the status of the request, and the specific error.
The above example uses the .then() and .catch() methods to register callbacks that run when the response has completed. These promise callbacks must be used due to the asynchronous nature of Ajax requests.
jQuery's architecture allows developers to create plug-in code to extend its function. There are thousands of jQuery plug-ins available on the Web30 that cover a range of functions, such as Ajax helpers, Web services, datagrids, dynamic lists, XML and XSLT tools, drag and drop, events, cookie handling, and modal windows.
An important source of jQuery plug-ins is the plugins sub-domain of the jQuery Project website.31 The plugins in this subdomain, however, were accidentally deleted in December 2011 in an attempt to rid the site of spam.32 The new site is a GitHub-hosted repository, which required developers to resubmit their plugins and to conform to new submission requirements.33 jQuery provides a "Learning Center" that can help users understand JavaScript and get started developing jQuery plugins.34
QUnit is a test automation framework used to test the jQuery project. The jQuery team developed it as an in-house unit testing library.57 The jQuery team uses it to test its code and plugins, but it can test any generic JavaScript code, including server-side JavaScript code.58
As of 2011, the jQuery Testing Team uses QUnit with TestSwarm to test each jQuery codebase release.59
Simplifying tasks such as HTML document traversal, animation, and event handling, the stalwart jQuery JavaScript library changed the face of web development. As of May 2019, jQuery is still being used in 74 percent of known websites, according to web technology surveyor W3Techs. Nevertheless, the jQuery library, which debuted in August 2006, is now being viewed by some developers as an older technology whose time has passed. Alternatives to jQuery have emerged in recent years, such as the Cash library or even just modern, vanilla JavaScript, now that web browsers all handle JavaScript the same way and jQuery is no longer needed to solve compatibility issues. Arguments on Reddit and videos on YouTube make the case that jQuery has become obsolete, or at least is not as essential as it once was.— Paul Krill, InfoWorld (2019)60
Simplifying tasks such as HTML document traversal, animation, and event handling, the stalwart jQuery JavaScript library changed the face of web development. As of May 2019, jQuery is still being used in 74 percent of known websites, according to web technology surveyor W3Techs. Nevertheless, the jQuery library, which debuted in August 2006, is now being viewed by some developers as an older technology whose time has passed. Alternatives to jQuery have emerged in recent years, such as the Cash library or even just modern, vanilla JavaScript, now that web browsers all handle JavaScript the same way and jQuery is no longer needed to solve compatibility issues. Arguments on Reddit and videos on YouTube make the case that jQuery has become obsolete, or at least is not as essential as it once was.
As cross-browser compatibility is no longer as much of an issue, most of jQuery can nowadays be replaced with modern web standards, without losing much convenience.61 Partly due to this, GitHub removed jQuery from its pages in 2018.62
"jQuery: The write less, do more, JavaScript library". The jQuery Project. Retrieved April 29, 2010. http://jquery.com/ ↩
"jQuery Project License". jQuery Foundation. Retrieved March 11, 2017. https://github.com/jquery/jquery/blob/master/LICENSE.txt ↩
"Usage of JavaScript libraries for websites". W3Techs. Archived from the original on November 15, 2019. Retrieved November 15, 2019. jQuery (74.1%) is 3.7 times more popular than Bootstrap (19.9%). https://w3techs.com/technologies/overview/javascript_library/all ↩
"Libscore". Archived from the original on February 19, 2017. Retrieved February 11, 2017. Top scripts are 1. jQuery (692,981 sites); 2. jQuery UI (193,680 sites); 3. Facebook SDK (175,369 sites); 4. Twitter Bootstrap JS (158,288 sites); 5. Modernizr (155,503 sites). https://web.archive.org/web/20170219042532/https://libscore.com/ ↩
"Selectors API Level 1, W3C Recommendation" (21 February 2013). This standard turned what was jQuery "helper methods" into JavaScript-native ones, and the wide use of jQuery stimulated the fast adoption of querySelector/querySelectorAll into main Web browsers. https://www.w3.org/TR/selectors-api/#queryselector ↩
Resig, John (September 28, 2008). "jQuery, Microsoft, and Nokia". jQuery Blog. jQuery. Retrieved January 29, 2009. http://jquery.com/blog/2008/09/28/jquery-microsoft-nokia/ ↩
Guthrie, Scott (September 28, 2008). "jQuery and Microsoft". ScottGu's Blog. Retrieved April 15, 2019. https://weblogs.asp.net/scottgu/jquery-and-microsoft ↩
"Guarana UI: A jQuery Based UI Library for Nokia WRT". Forum Nokia. Archived from the original on August 16, 2011. Retrieved March 30, 2010. https://web.archive.org/web/20110816054350/http://www.developer.nokia.com/Community/Wiki/Guarana_UI:_a_jQuery-Based_UI_Library_for_Nokia_WRT ↩
York, Richard (2009). Beginning JavaScript and CSS Development with jQuery. Wiley. p. 28. ISBN 978-0-470-22779-4. 978-0-470-22779-4 ↩
Resig, John (October 31, 2007). "History of jQuery". Retrieved April 15, 2019. https://www.slideshare.net/jeresig/history-of-jquery ↩
"The jQuery Team". jquery.com. JS Foundation. Retrieved May 22, 2019. Team: Timmy Willison (jQuery Core Lead), Richard Gibson (Sizzle Lead, jQuery Core). https://jquery.org/team/ ↩
jquery-under-the-mit-license on jquery.org (2006) https://blog.jquery.com/2006/05/27/jquery-under-the-mit-license/ ↩
license on jquery.org (archived 2010) https://web.archive.org/web/20100301130833/http://jquery.org/license ↩
"jQuery Licensing Changes". jQuery Blog. September 10, 2012. https://blog.jquery.com/2012/09/10/jquery-licensing-changes/ ↩
"Handling 15,000 requests per second: The Growth Behind jQuery". www.maxcdn.com. MaxCDN. June 20, 2015. Archived from the original on July 2, 2018. Retrieved July 2, 2018. https://web.archive.org/web/20180702093146/https://www.maxcdn.com/blog/maxscale-jquery/ ↩
"jQuery Usage Statistics (Dec 2019)". trends.builtwith.com. December 31, 2019. Archived from the original on February 21, 2020. Retrieved February 21, 2020. https://web.archive.org/web/20200221204800/https://trends.builtwith.com/javascript/jQuery ↩
"Usage Statistics and Market Share of JavaScript Libraries (February 2020)". W3Techs. February 21, 2020. Archived from the original on February 21, 2020. Retrieved February 21, 2020. https://w3techs.com/technologies/overview/javascript_library ↩
Resig, John (January 14, 2009). "jQuery 1.3 and the jQuery Foundation". jQuery Blog. Retrieved May 4, 2009. https://blog.jquery.com/2009/01/14/jquery-13-and-the-jquery-foundation/ ↩
Browser Support | jQuery //jquery.com/browser-support/ ↩
jquery.org, jQuery Foundation -. "jQuery CDN". https://code.jquery.com/ ↩
"Google Libraries API - Developer's Guide". Retrieved March 11, 2012. https://code.google.com/apis/ajaxlibs/documentation/#jquery ↩
"Microsoft Ajax Content Delivery Network". ASP.net. Microsoft Corporation. Retrieved April 15, 2019. https://docs.microsoft.com/en-us/aspnet/ajax/cdn/overview ↩
js.foundation, JS Foundation -. "jQuery() | jQuery API Documentation". api.jquery.com. Retrieved July 2, 2018. https://api.jquery.com/jQuery/ ↩
"jQuery.noConflict() jQuery API Documentation". http://api.jquery.com/jquery.noconflict/ ↩
jquery.org, jQuery Foundation -. "jQuery Core 3.0 Upgrade Guide - jQuery". https://jquery.com/upgrade-guide/3.0/#deprecated-document-ready-handlers-other-than-jquery-function ↩
"Plugins". The jQuery Project. Retrieved April 15, 2019. https://plugins.jquery.com/ ↩
"What Is Happening To The jQuery Plugins Site?". jQuery Blog. Retrieved April 22, 2015. https://blog.jquery.com/2011/12/08/what-is-happening-to-the-jquery-plugins-site/#pluginstldr ↩
"jquery/plugins.jquery.com". GitHub. Retrieved April 22, 2015. https://github.com/jquery/plugins.jquery.com ↩
"jQuery Learning Center". jQuery Foundation. Retrieved July 2, 2014. http://learn.jquery.com/ ↩
"jQuery 1.6.4 Released". jQuery Blog. September 12, 2011. https://blog.jquery.com/2011/09/12/jquery-1-6-4-released/ ↩
"jQuery 1.7.2 Released". jQuery Blog. March 21, 2012. https://blog.jquery.com/2012/03/21/jquery-1-7-2-released/ ↩
"jQuery 1.8.3 Released". jQuery Blog. November 13, 2012. https://blog.jquery.com/2012/11/13/jquery-1-8-3-released/ ↩
"jQuery 1.9.1 Released". jQuery Blog. February 4, 2013. https://blog.jquery.com/2013/02/04/jquery-1-9-1-released/ ↩
"jQuery 1.10.2 and 2.0.3 Released". jQuery Blog. July 3, 2013. https://blog.jquery.com/2013/07/03/jquery-1-10-2-and-2-0-3-released/ ↩
"jQuery 1.11.3 and 2.1.4 Released – iOS Fail-Safe Edition". jQuery Blog. April 28, 2015. https://blog.jquery.com/2015/04/28/jquery-1-11-3-and-2-1-4-released-ios-fail-safe-edition/ ↩
"jQuery 1.12.4 and 2.2.4 Released". jQuery Blog. May 20, 2016. https://blog.jquery.com/2016/05/20/jquery-1-12-4-and-2-2-4-released/ ↩
Chesters, James (June 15, 2016). "Long-awaited jQuery 3.0 Brings Slim Build". infoq.com. Retrieved January 28, 2017. https://www.infoq.com/news/2016/06/jQuery-3 ↩
"jQuery 3.2.0 Is Out!". jQuery Blog. March 16, 2017. Retrieved March 12, 2018. https://blog.jquery.com/2017/03/16/jquery-3-2-0-is-out/ ↩
"jQuery 3.3.0 – A fragrant bouquet of deprecations and…is that a new feature?". jQuery Blog. January 19, 2018. Retrieved April 15, 2019. https://blog.jquery.com/2018/01/19/jquery-3-3-0-a-fragrant-bouquet-of-deprecations-and-is-that-a-new-feature/ ↩
"jQuery 3.3.1 – fixed dependencies in release tag". jQuery Blog. January 20, 2018. Retrieved April 15, 2019. https://blog.jquery.com/2018/01/20/jquery-3-3-1-fixed-dependencies-in-release-tag/ ↩
"jQuery 3.4.0 Released". jQuery Blog. April 10, 2018. Retrieved April 15, 2019. https://blog.jquery.com/2019/04/10/jquery-3-4-0-released/ ↩
"jQuery 3.4.1: triggering focus events in IE and finding root elements in iOS 10". jQuery Blog. jQuery Foundation. https://blog.jquery.com/2019/05/01/jquery-3-4-1-triggering-focus-events-in-ie-and-finding-root-elements-in-ios-10/ ↩
"jQuery 3.5.0 Released!". jQuery Blog. April 10, 2020. Retrieved April 11, 2020. https://blog.jquery.com/2020/04/10/jquery-3-5-0-released/ ↩
"jQuery 3.5.1 Released: Fixing a Regression". jQuery Blog. jQuery Foundation. https://blog.jquery.com/2020/05/04/jquery-3-5-1-released-fixing-a-regression/ ↩
jquery.org, jQuery Foundation-. "jQuery 3.6.0 Released! | Official jQuery Blog". Retrieved March 27, 2021. https://blog.jquery.com/2021/03/02/jquery-3-6-0-released/ ↩
"jQuery 3.6.4 Released: Selector Forgiveness". Retrieved March 8, 2023. https://blog.jquery.com/2023/03/08/jquery-3-6-4-released-selector-forgiveness/ ↩
"jquery v3.6.4". bundlephobia.com. Retrieved March 8, 2023. https://bundlephobia.com/package/jquery@3.6.4 ↩
jquery.org, jQuery Foundation-. "jQuery 3.7.0 Released: Staying in Order | Official jQuery Blog". https://blog.jquery.com/2023/05/11/jquery-3-7-0-released-staying-in-order/ ↩
"jQuery 3.7.1 Released: Reliable Table Row Dimensions". Retrieved September 14, 2023. https://blog.jquery.com/2023/08/28/jquery-3-7-1-released-reliable-table-row-dimensions/ ↩
"jquery v3.7.0". bundlephobia.com. Retrieved May 11, 2023. https://bundlephobia.com/package/jquery@3.7.0 ↩
jquery.org, jQuery Foundation-. "jQuery 4.0.0 BETA!". https://blog.jquery.com/2024/02/06/jquery-4-0-0-beta/ ↩
"History". qunitjs.com. Retrieved April 15, 2019. https://qunitjs.com/#History ↩
"jquerytesting [licensed for non-commercial use only] / FrontPage". jquerytesting.pbworks.com. http://jquerytesting.pbworks.com/w/page/41556026/FrontPage ↩
Krill, Paul (May 8, 2019). "3 JavaScript libraries to replace jQuery". InfoWorld. https://www.infoworld.com/article/3392876/3-javascript-libraries-to-replace-jquery.html ↩
"You Might Not Need jQuery". youmightnotneedjquery.com. Retrieved April 23, 2022. https://youmightnotneedjquery.com/ ↩
"Removing jQuery from GitHub.com frontend". The GitHub Blog. September 6, 2018. Retrieved July 21, 2021. https://github.blog/2018-09-06-removing-jquery-from-github-frontend/ ↩