taupe WebとAIと暮らし

Notes / 実践記録

WordPress 5.6でjQuery is not definedが出た時の記録

WordPress 5.6でjQuery is not definedが出た時の記録

本ページはアフィリエイトプログラムを利用しています

WordPress 5.6にアップグレード。
するとおやおや、JavaScriptのエラーが発生。

2026年7月追記:この記事は、WordPress 5.6更新時にAutoptimizeまわりで jQuery is not defined が出た時の記録です。
WordPress 5.5から5.7にかけては、同梱jQueryの更新が段階的に進められていました。
今から同じエラーを見る場合は、単純に古いjQueryへ戻すより、テーマ、プラグイン、最適化設定、読み込み順を確認した方がよさそうです。
背景はWordPress CoreのjQuery更新案内と、当時の互換確認用プラグインだったEnable jQuery Migrate Helperが参考になります。

コンソールに出力されているエラーは「jQuery is not defined」。
jQuery本体が読み込まれていない様子です。

WordPress 5.5からjQueryに変更が入っているようで。
その辺りが原因かな……と調べてみたところ、プラグインの「Autoptimize」が関係している模様。

結果として、WordPress 5.6になってjQueryのファイル名が変更となっていたのが原因
これまではjquery.jsだったのがjquery.min.jsとなっていました。

Autoptimizeでは、ファイル名指定でjsを圧縮から外すことができます。
この指定から漏れたことで、jquery.min.jsまで圧縮されてjQueryが機能しなくなった形です。

jQuery is not defined|WordPress 5.6に更新したらJavaScriptエラーが発生

個人のブログなど、WordPressで運用しているサイトは自動アップグレードしています。
そんなこんなで、WordPress 5.6にも更新されたわけですが。

WordPress 5.6へ更新した管理画面

その直後から、閲覧数をカウントするプラグインなどが動かなくなりました。

jQuery is not definedのコンソールエラー画面

表示側で確認してみると、コンソールにスクリプトエラーが。
「jQuery is not defined」との内容なので、jQuery自体が読み込まれていない様子。

WordPress 5.6からjQueryのファイル名が変更に…プラグインAutoptimizeを使っている場合は注意!

諸々調べたところ、下記のフォーラムの書き込みを発見。

WordPress 5.6でjQuery is not definedが出た時の記録
jQuery is not defined after updating to WordPress 5.6
jQuery is not defined after updating to WordPress 5.6 Resolved eltarny (@eltarny) 5 years, 7 months ago Hello, One of my...

同じ現象だったので読み進めていると、下記コメントが答えになりました。

aha, found it; 5.6.0 changes the filename of jQuery, so you’ll have to change js/jquery/jquery.js into js/jquery/jquery.min.js ..

WordPress 5.6からjQueryのファイル名が変更になっていたようです。
これまではjquery.jsでしたが、jquery.min.jsとなっています。

私が運用しているWordPressサイトではプラグインのAutoptimizeを使っています。
HTMLやCSS・JSなどを圧縮したり結合したりすることで、表示スピードを上げるなどの恩恵を受けられます。

AutoptimizeのJavaScript除外設定画面

そのAutoptimizeですが、設定で特定のJavaScriptを処理から除外できます。
jQueryなんかは圧縮したり結合すると動かなくなるため、「Autoptimizeからスクリプトを除外」の入力欄にこれまではjquery.jsを記述していました。

これが、WordPress 5.6からjQueryのファイル名が変更になってしまったので……。

jquery.min.jsを除外対象に追加した設定画面

jquery.min.jsを除外するスクリプトに追加してやります。

この設定で、スクリプトエラーは解消。
WordPressのアップグレード前と同じように、想定通りの動作となりました。

WordPress の jQuery は5.5、5.6、5.7の3回のリリースにわたって更新されます。このプロセスの中間点に到達した今、更新テストプラグインを実行して事前にサイトでのエラーを確認してください。

スライダーが動かない、ボタンの動きがおかしいなどサイトの見た目で問題がある場合は jQuery Migrate プラグインをインストールしてください。

こんな通知もされていますからね、5.7系のアップグレード時も気をつけたほうが良さそうですね。

楽天Kobo電子書籍ストア
¥2,200 (2026/07/31 06:21時点 | 楽天市場調べ)

続けて読む

次に読むなら、これ。

同じテーマの実践記録や、taupeの読み方へ進めます。

同じテーマWordPress近い実践記録をカテゴリから続けて読めます。サイトの読み方FAQ運用方針や、よくある質問を確認できます。taupeについてこのサイトについてどんな視点で作り、使い、運用しているかをまとめています。

Category

Author / Official hub

イシカワヒデカズの実践記録

Web制作、開発、AI活用、メディア運営の相談先は公式サイトにまとめています。