Standardize DOM manipulation and AJAX across browsers and Node environments
This library lets you handle web pages with identical code by ignoring browser differences. With the release of jQuery 4.0.0, the latest version receives full support, while older versions receive only critical updates or have ended support. It is a tool that simplifies JavaScript-based DOM selection, event handling, and AJAX requests.
4.0.0 Release and Version Support Policy
jQuery 4.0.0 has been officially released. The 4.x versions on the main branch receive full support, while the 3.x branch provides only critical updates. The 2.x and 1.x branches are no longer supported. Commercial support for older versions is available from HeroDevs or TuxCare. Upgrading to the latest version is recommended for performance, security, and features.
Usage Environments and Build Requirements
jQuery runs in environments other than browsers, including Node.js, browser extensions, and other non-browser environments. To build it directly, you must install the latest Node.js/npm and git 1.7 or higher. Windows users should install git and Node.js directly, while macOS users can install them via Homebrew. Linux/BSD users can use a package manager or build from source.
Custom Builds and Module Control
You can create custom builds that include only the modules you need. You can exclude all modules except the core module; excluding the selector module replaces it with a simple wrapper that uses the browser's querySelectorAll. You can remove specific features like ajax, css, effects, and event by passing the --exclude option to the npm run build command. Using the --slim option builds the library with the same configuration as the official slim build. Additionally, you can build it as an ECMAScript module using the --esm option, or as a factory form that receives the window object from outside using the --factory option.
Running Tests and Contribution Guidelines
Running unit tests requires a local server that supports PHP. A database is not required, and pre-configured PHP server options are provided for Windows and Mac. Community contributions are encouraged, and you must read the contribution guidelines, core style guide, and jQuery project code writing guide before writing code. GitHub issues and PRs are referenced in the gh-NUMBER format, while issues from the former Trac-based bug tracker are referenced in the trac-NUMBER format.
Pre-Adoption Considerations
If you plan to use jQuery 4.x, you must have the latest Node.js and git environment set up. If you must maintain versions 3.x or lower, be aware that they receive only critical updates or have ended support. If you generate a custom build, it is not officially tested, so users must assume the risk themselves. If you exclude the selector module, you cannot use jQuery's extended selector syntax, so you should verify if you need this feature.