OSS TanbouOn this page
Overview
jQuery Migrate 4.0.2 is a development tool for upgrading applications to jQuery 4.x. It temporarily patches removed APIs and, in development builds, reports deprecated or removed API usage as console warnings so existing code can be migrated incrementally.
Features and best fit
Based on official documentation; not hands-on tested · Content checked:
Key features
Patch removed APIs to reduce breakage during an upgrade
The README explains that Migrate restores APIs removed by breaking jQuery releases so existing code can keep running while it is updated.
Sources: [1]
Use JQMIGRATE development warnings to locate code that needs changes
The development build reports JQMIGRATE warnings and exposes detected messages through APIs such as jQuery.migrateMessages.
Sources: [1]
Control compatibility patches individually
The Migrate API supports disabling patches by code and checking whether a patch is enabled, which supports gradually removing compatibility behavior.
Sources: [1]
Best fit
Fits staged jQuery 4 upgrades in large existing applications
It supports an upgrade workflow where deprecated calls are replaced warning by warning until Migrate itself can be removed.
Sources: [1]
Before adoption
Version 4.x targets jQuery >=4 and <5
Package metadata declares jQuery >=4 <5 as its peer range, and the README compatibility table maps jQuery 4.x to Migrate 4.x.
Upgrade from jQuery 1.x or 2.x through jQuery 3.x first
The README explicitly recommends moving older applications to jQuery 3.x with Migrate 3.x and resolving compatibility issues before proceeding to jQuery 4.x.
Sources: [1]
Version 4.0.2 fixes missing module files in the npm release
The 4.0.2 release fixes the 4.0.1 npm package where module files were missing by building both script and module outputs during release.
Sources: [3]
Official sources
- [1]jQuery Migrate 4.0.2 README(2026-10-05)
- [2]jQuery Migrate 4.0.2 package metadata(2026-10-05)
- [3]jQuery Migrate 4.0.2 release(2026-10-05)
- [4]jQuery Migrate MIT license(2026-10-05)
Supplemental curator note
Migrate 4.x targets jQuery 4.x. When upgrading from jQuery 1.x or 2.x, the README recommends first moving to jQuery 3.x with Migrate 3.x, resolving compatibility issues there, and only then moving to jQuery 4.x.
Try it in 3 steps
- 1
Install pinned jQuery Migrate 4.0.2 with jQuery 4.0.0
Create an isolated npm project with the reviewed jQuery 4 migration tool and jQuery version pinned.
demo=$(mktemp -d "${TMPDIR:-/tmp}/jquery-migrate.XXXXXX") && cd "$demo" && npm init -y >/dev/null && npm install --save-exact jquery-migrate@4.0.2 jquery@4.0.0 - 2
Verify package versions and the peer range
Require the reviewed versions and confirm that Migrate 4 targets jQuery 4.x.
test "$(node -e "const fs=require('fs');const m=JSON.parse(fs.readFileSync('node_modules/jquery-migrate/package.json'));const j=JSON.parse(fs.readFileSync('node_modules/jquery/package.json'));console.log(m.version+'/'+j.version+'/'+m.peerDependencies.jquery)")" = '4.0.2/4.0.0/>=4 <5' - 3
Check script and module distributions
Verify the script and module outputs whose npm packaging was fixed in 4.0.2.
test -f node_modules/jquery-migrate/dist/jquery-migrate.js && test -f node_modules/jquery-migrate/dist-module/jquery-migrate.module.js
Growth
Growth trends · Last 30 days
2,094 Stars
Trend data is still being collected.
Development activity
Last 90 days · weekly
- Commits (last 30 days)
- 1
- Open PRs
- 1
Development activity is still being collected.
Built with
Categories and tags
Categories
GitHub data
GitHub dataView detailed GitHub data
- Stars
- 2,094
- Forks
- 476
- Watchers
- 122
- Open issues
- 6
- Contributors
- 29
- Owner type
- Organization
- Primary language
- JavaScript
- License
- MIT
- Repository last updated
- Oct 1, 2026
Related information
Write a related articleShare a guide or use case for this OSS in Markdown. Articles are published after administrator approval.
Explore next
- Airbnb JavaScript Style Guide148,304 Stars
2 shared tag(s) · 1 shared category(s) · Same language
standardize JavaScript code style with a detailed guide and reusable ESLint shared configurations
JavaScript - Svelte88,287 Stars
2 shared tag(s) · 1 shared category(s) · Same language
compile components into efficient JavaScript and express reactive UI through runes
JavaScript - Prettier52,344 Stars
2 shared tag(s) · 1 shared category(s) · Same language
an opinionated formatter that parses code and reprints a consistent style
JavaScript - Day.js48,664 Stars
2 shared tag(s) · 1 shared category(s) · Same language
Parse, format, and manipulate dates with a small immutable JavaScript library and a familiar Moment.js-style API
JavaScript - Fastify37,232 Stars
2 shared tag(s) · 1 shared category(s) · Same language
build Node.js web and API servers with low overhead, plugins, JSON Schema validation, and Pino logging
JavaScript - Immer28,983 Stars
2 shared tag(s) · 1 shared category(s) · Same language
framework-agnostic state utility that turns mutation-style recipes into structurally shared immutable next states
JavaScript
Report incorrect information
Tell us if any listing information is incorrect or outdated.