ページ内ナビ
概要
jQuery Migrate 4.0.2はjQuery 4.xへのupgradeを支援するdevelopment toolです。削除されたAPIを一時的にpatchし、development buildではdeprecated/removed API利用をconsole warningとして報告することで、既存codeの修正箇所を段階的に特定できます。
特徴と向いている用途
公式資料に基づく紹介・実機未検証 · 内容確認日:
主な特徴
removed APIをpatchしてupgrade中のbreakageを一時的に抑える
READMEはbreaking changeで削除されたAPIを復元し、移行期間中に既存codeを動かしながら修正できることを説明しています。
出典:[1]
development buildのJQMIGRATE warningから修正箇所を特定する
development versionはconsoleへJQMIGRATE warningを出し、jQuery.migrateMessages等のAPIから検出messageを確認できます。
出典:[1]
patch単位でdisable/enabled状態を制御する
Migrate APIはpatch codeを指定するdisableやenabled判定を提供し、互換patchを段階的に外す運用を支援します。
出典:[1]
向いている用途
large existing jQuery applicationを段階的に4.xへ移行したい場合に向く
一括rewriteではなくwarningを消しながらdeprecated APIを置換し、最終的にMigrate自体を外すupgrade workflowに適します。
出典:[1]
導入前の確認
4.xはjQuery >=4かつ<5専用である
package metadataはpeer dependencyをjQuery >=4 <5と定義し、READMEのcompatibility表もjQuery 4.xにはMigrate 4.xを対応付けています。
jQuery 1/2系からは3.xを経由してから4.xへ上げる
READMEは古いjQueryから4.xへ直接上げず、先にjQuery 3.x + Migrate 3.xでcompatibility issueを解消するよう明記しています。
出典:[1]
4.0.2はnpm releaseのmissing module filesを修正する
4.0.2 releaseは4.0.1でnpm packageからmodule filesが欠けていた問題を修正し、script/module filesをrelease時にbuildする変更です。
出典:[3]
参考にした公式資料
- [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)
編集部からの補足
Migrate 4.xはjQuery 4.x向けです。jQuery 1/2系から直接4.xへ上げるのではなく、READMEどおり先にjQuery 3.x + Migrate 3.xで互換問題を解消してから4.xへ進めてください。
3ステップで試す
- 1
jQuery Migrate 4.0.2とjQuery 4.0.0を固定して導入する
一時npm projectへjQuery 4向けMigrateとjQueryを固定して導入します。
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
package versionとpeer rangeを確認する
review対象versionとjQuery 4専用peer dependencyを確認します。
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
script/module distributionを確認する
4.0.2で修正されたscriptとmoduleの両distributionがnpm packageに含まれることを確認します。
test -f node_modules/jquery-migrate/dist/jquery-migrate.js && test -f node_modules/jquery-migrate/dist-module/jquery-migrate.module.js
成長
成長の推移 · 直近30日
2,094 Stars
推移データを蓄積中です。
開発アクティビティ
直近90日・週次
- Commit(直近30日)
- 1
- Open PR
- 1
開発アクティビティを蓄積中です。
Built with
カテゴリとタグ
カテゴリ
GitHubデータ
GitHubのデータGitHubの詳細データを見る
- Stars
- 2,094
- Forks
- 476
- Watchers
- 122
- Open Issues
- 6
- Contributors
- 29
- 所有者種別
- Organization
- 主要言語
- JavaScript
- ライセンス
- MIT
- リポジトリ最終更新
- 2026/10/01
関連情報
関連記事を投稿するこのOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。
あわせて探訪
- Airbnb JavaScript Style Guide148,304 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
JavaScriptの記述規約をESLint shared configとセットで導入し、teamのcode styleを統一する
JavaScript - Svelte88,287 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
componentをcompile時に効率的なJavaScriptへ変換し、runesでreactive UIを記述する
JavaScript - Prettier52,344 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
codeをparseして一貫したstyleへ再出力するopinionated formatter
JavaScript - Day.js48,664 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
日時の解析・整形・計算を、軽量でイミュータブルなMoment.js互換APIで扱うJavaScriptライブラリ
JavaScript - Fastify37,232 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
Node.js向けWeb/APIサーバーを低オーバーヘッド、プラグイン、JSON Schema検証、Pinoログで構築する
JavaScript - Immer28,983 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
mutableに見えるrecipeからstructural sharingされたimmutable next stateを生成するJavaScript state utility
JavaScript
情報の誤りを報告
掲載内容に誤りや古い情報があればお知らせください。