OSS探訪GitHubでログイン

削除・非推奨jQuery APIを一時復元し、warningから移行箇所を洗い出す

スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標(上限なし)です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
2,094
主要言語
JavaScript
ライセンス
MIT
リポジトリ最終更新
2026/10/01
ページ内ナビ

概要

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を対応付けています。

出典:[2][1]

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. [1]jQuery Migrate 4.0.2 README(2026-10-05)
  2. [2]jQuery Migrate 4.0.2 package metadata(2026-10-05)
  3. [3]jQuery Migrate 4.0.2 release(2026-10-05)
  4. [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. 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. 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. 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
公式READMEで確認

成長

成長の推移 · 直近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で投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。

このページを読んで、次に何をすればよいか分かりましたか?