jQuery — 4.0が登場したWeb定番JavaScriptライブラリのビルドと特徴
jquery/jquery
★ 60,023 ・ JavaScript ・ MIT
概要
jquery/jquery は、DOM操作やイベント処理、Ajax通信などを直感的に記述できるように設計された定番のJavaScriptライブラリです。長年にわたりWebフロントエンド開発の基礎として広く普及してきました。
近年では標準のWeb APIや各種モダンフロントエンドフレームワークの普及が進んでいますが、jQueryは現在も多くのWebサイトや既存システムで活用されています。最新のメジャーバージョンである「jQuery 4.0.0」がリリースされ、従来のスクリプト形式にとどまらず、モダンなJavaScript開発環境に合わせたECMAScriptモジュール(ESM)形式の提供や、不要な機能を削ぎ落とせる詳細なカスタムビルド機能が強化されています。
既存のjQuery資産をメンテナンスしているエンジニアはもちろん、軽量なDOM操作ユーティリティを自前でカスタマイズして構築したい開発者にも適した構成となっています。
主な特徴
- 最新バージョン 4.x への移行: jQuery 4.0.0 がリリースされ、現在のメインブランチ(4.x)がフルサポート対象となっています。
- 多様な実行環境のサポート: 通常のWebブラウザ環境だけでなく、Node.js、ブラウザ拡張機能、その他の非ブラウザ環境での動作にも対応しています。
- 複数の配布バリエーション: 通常版の
jquery.jsに加え、一部機能を省いたjquery.slim.js、ECMAScriptモジュールに対応したjquery.module.jsやjquery.slim.module.jsなどが用意されています。 - 高度なカスタムビルド機能: ビルドスクリプトを介して、Ajaxやエフェクト、アニメーションなど不要なモジュールを除外し、プロジェクト固有の最適化されたファイルを出力できます。
- ネイティブセレクターへのフォールバック: セレクターエンジン(
selectorモジュール)を除外した場合でも、ブラウザ標準のquerySelectorAllを使った軽量なラッパーに自動で置き換える設計が備わっています。
使い方
READMEでは、公式配布サイトからのダウンロードに加えて、リポジトリから自身でビルドする手順が詳しく案内されています。
前提条件
ソースコードからビルドするには、最新の Node.js / npm と、git 1.7 以降が必要です。
- Windows: 公式サイトから Git と Node.js をインストールします。
- macOS: Homebrew を使用して
brew install gitおよびbrew install nodeを実行します。 - Linux/BSD: 各ディストリビューションのパッケージマネージャー経由でインストールします。
基本的なビルド手順
リポジトリをクローンし、依存関係をインストールした上でビルドを実行します。
cd jquery
npm install
npm run build
ビルドが完了すると、dist/ ディレクトリ内に通常版のファイル、圧縮(minified)版、およびソースマップファイルが出力されます。
すべてのバリエーションを一括生成する
リリースに含まれるすべてのバリエーション(通常版、slim版、ESM版)を生成する場合は、次のコマンドを実行します。
npm run build:all
このコマンドにより、通常の dist/ に加え、ESM形式(jquery.module.js、jquery.slim.module.js)が dist-module/ ディレクトリに出力されます。
カスタムビルドの作成
ビルドスクリプトに引数を渡すことで、特定の機能のみを含めたり除外したりできます。
ビルドオプションの全体を確認するコマンド:
npm run build -- --help
特定モジュールを除外する場合は --exclude、指定モジュールのみを含める場合は --include を使用します。また、AMDのモジュール名変更やESモジュール形式での出力も指定可能です。
# AMDモジュール名を指定してビルド
npm run build -- --amd="custom-name"
# 匿名AMDモジュールとしてビルド
npm run build -- --amd
# slim版を指定ディレクトリへ別名で出力
npm run build -- --slim --filename="jquery.slim.js" --dir="/tmp"
# ECMAScriptモジュール(ESM)としてビルド
npm run build -- --filename=jquery.module.js --esm
技術的なポイント
モジュール構造と柔軟な依存関係
jQueryのソースコードは src/ 配下に機能単位で細かく分割されています。カスタムビルドでは、core 以外のほぼすべてのモジュールが除外対象として設定可能です。
READMEで挙げられている主なモジュール例:
- ajax:
$.ajax()、$.get()、$.post()などの通信機能全般。トランスポート単位(ajax/xhr、ajax/script、ajax/jsonp)での個別管理も可能です。 - css:
.css()メソッド。これを除外すると、cssに依存するeffectsやdimensions、offsetも連鎖して除外されます。 - effects:
.animate()や.slideUp()、.hide("slow")などのアニメーション機能全般。 - event:
.on()や.off()を含むイベントシステム。 - deferred:
jQuery.Deferred実装。除外すると、依存するajaxやqueueなども連鎖して除外され、core/readyはDeferred非依存の実装に切り替わります。 - selector: jQuery独自の拡張を含むセレクターエンジン。除外すると、
src/selector-native.jsに定義されたネイティブのquerySelectorAllベースの最小限のエンジンに差し替えられます。
モジュール形式への対応とファクトリー機能
最新のビルド環境では、従来のブラウザ用グローバル変数定義だけでなく、ECMAScriptモジュール(ESM)形式の出力に対応しており、jQuery や $ を名前付きエクスポートとして利用できます。
また、window オブジェクトが存在しない非ブラウザ環境(Node.jsなど)への対応として、外部から window を受け取る関数を公開する --factory モードも備わっています。
注意点
バージョンのサポート状況
jQuery 4.0.0 のリリースに伴い、公式のバージョンサポートポリシーは以下のようになっています。
- 4.x(mainブランチ): フルサポート(Full)
- 3.x(3.x-stableブランチ): クリティカルな修正のみ(Critical-only)
- 2.x(2.x-stableブランチ): サポート終了(None)
- 1.x(1.x-stableブランチ): サポート終了(None)
公式では、パフォーマンス、セキュリティ、機能面を考慮し、最新版へのアップグレードを推奨しています。なお、過去バージョンに対する商用サポートについては、外部ベンダー(HeroDevs、TuxCare)が提供している旨がREADMEに案内されています。
カスタムビルド時の依存関係
モジュールを除外する際は、連鎖的な依存関係に注意が必要です。例えば deferred や css を除外すると、それらを前提としている ajax や effects などの機能もビルドから自動的に除外されます。また、セレクターエンジンをネイティブ版に置き換えた場合、jQuery独自の擬似クラス(:animated や :hidden など)や一部の拡張構文は動作しなくなります。
ライセンス
本プロジェクトは MIT ライセンス のもとで公開されています。
まとめ
jQuery は、長い歴史を持ちながらもバージョン 4.x への進化やESモジュール対応を果たすなど、現代のWeb標準に合わせたメンテナンスが継続されています。必要なモジュールのみを柔軟にビルドできる設計を備えているため、既存システムの保守はもちろん、用途を絞った軽量なDOMライブラリを必要とする場面でも引き続き有力な選択肢です。





