【JQuery】Uncaught ReferenceError: $ is not defined

Question

やりたいこと

ページを表示した時、JQueryがロードされた段階で必ずスクリプトを実行したいです。
ページ表示段階でJQueryがロードされていなければスクリプトを実行しないというエラー回避ではなくJQueryがロードされた段階で必ずスクリプトを実行したいという要件になります。

困っていること

以下のようなHTMLがあります。（簡略化しています）

<ul class="users">
  <li>Michael</li>
  <li>Daniel</li>
  <li>John</li>
</ul>

<script>
$('.users').each(function(index, user) {
    console.log($(user).text());
});
</script>

これをスーパーリロードすると、以下エラーがコンソールに出力されます。
※スーパーリロードしない時はキャッシュが有効なのでエラーが起こりません。

Uncaught ReferenceError: $ is not defined

JQueryがロードされる前にスクリプトが実行されていることはわかるのですが、これの対応策が調べてもわかりませんでした。
これを以下のようにすればエラーを回避できることがわかりましたが、エラー回避ではなくJQueryがロードされた段階で必ずスクリプトを実行したいというのが今回の要件になりますのでマッチしませんでした。

<ul class="users">
  <li>Michael</li>
  <li>Daniel</li>
  <li>John</li>
</ul>
<script>
if (typeof jQuery != "undefined") {
    $('.users').each(function(index, user) {
        console.log($(user).text());
    });
}
</script>

「待つ」という手段としてsetIntervalというものがあることも知りましたが、この要件への当てはめ方が調べてもわかりませんでした。

すみませんがよろしくお願いします。

Comments

[defghi1977]

jQueryを読み込んでいるscript要素もコードに追加して下さい

[masaya_ohashi]

なぜjQueryが読み込まれた直後でないといけないのかの説明もお願いします。window.onloadのタイミングでは駄目な理由もお願いします。

[defghi1977]

多分defer属性がついている

[yambejp]

jQueryが読まれているかどうかをチェックするより、事前に読むことが肝要なのでは？関係ソースをロードしておいてあとからjQueryをロードしたいのかもしれませんが、メリットが感じられません

Answer 1

以下は推測です.

---

おそらくjQueryを読み込んでいるscript要素にdefer属性が付与されていることが原因です.

defer属性はスクリプトの読み込みをdocumentのDOMContentLoadedイベントが発生する前までに完了することを指定(保証)するものです. 一般にscript要素が参照するスクリプトコードは同期的に実行されるため, 複数のコードを参照している際にどうしてもWEBページのロードに時間がかかります. そこでdefer属性を指定しておくとWEBページ読み込みの背後でスクリプトが同時並行的に処理され, WEB応答性がよくなるのです.

さて, あなたのコードではDOMノードの展開直後(DOMContentLoadedイベント発生前)にscript要素を配置してすぐにjQuery要素を使おうとしています. すると, スーパーリロード直後のタイミングではdefer属性によりjQueryコードのダウンロードと同時にスクリプトが実行されることとなり, 変数jQueryが見つからないことになるのです.

改善策としては次の2つが挙げられます.

• defer属性を削除する

jQueryの読み込みを同期的に行うことで, (script要素の配置が正しい限り)jQueryの読み込み後にあなたのコードが実行されるようになります. その代償としてWEB応答性が(多少)犠牲になります.

• スクリプトの実行をDOMContentLoadedイベントの発生まで待つ

DOMContentLoadedイベントが発生した後であればjQueryの初期化が完了していることが保証されていますから, あなたのコードは正しくjQueryを使えることになります.

後者を選択するのであれば, おそらくコードは次のようになるでしょう.

document.addEventListener("DOMCotnentLoaded", function(){
    $('.users').each(function(index, user) {
        console.log($(user).text());
    });
});

Comments

[maisumakun]

$で遅らせるのでは、その$が揃う前に「$(function(){...})」のコードが読まれてしまう以上、タイミングが良くないと間に合いません。

jQueryをdeferで読み込むこと自体、（jQueryをサブにしか使わないシチュエーションなら話は別ですが）かなり使いにくいとは思います。

[defghi1977]

言われてみればそのとおり. 修正します.

Answer 2

基本的には、（特に、jQueryで動かすウィジェットをページ内に置いてあって、表示も変化するような場合）jQuery本体の読み込みにdeferを付けるのはあまりおすすめしません。

そして、$(function(){...})内に書かれたコードは、結局DOMContentLoadedのタイミングで実行されますので、「jQueryの読み込み直後」に実行してもほとんど意味はありません。

本当にどうしてもやりたいのなら、「$がそろうか監視する」「jQueryの読み込みタグもJavaScriptで生成して、そのloadイベントに仕掛ける」などの手段が考えられます。

// <script>内の想定
(function main(){
  if(!window.$) {
   setTimeout(main, 50);
   return;
  }
  // ここまで来たときには確実に$がある
  $(function(){
    // 後略
  });
})();

Answer 3

jqueryロードと同時に動かすモジュールpreload.jsがあったとして、jqueryやpreload.jsをdererでロードしたいということならpreload.jsとjqueryの依存関係をbrowserifyで(実行時ではなくビルド時に)マージすることで解決する手もあると思います。

preload.js

var $ = require('js/jquery-...min.js').$;

$( ... ) // DOM構築前に何かするならここに(できることあるのかな...)

$(function () {
  // DOM構築後の処理はこちらに
  if (typeof jQuery != "undefined") {
    $('.users').each(function(index, user) {
      console.log($(user).text());
    });
  }
});

＝＝＞jqueryとマージしたものがbuild.jsになったとすると以下のように巨大な他のJSファイルと並行してロードすることはできそうです。

...
<script type="text/javascript" defer src="js/build.js"></script>
<script type="text/javascript" defer src="js/heavy1.js"></script>
<script type="text/javascript" defer src="js/heavy2.js"></script>
...

なお例えばjquery.xxx.min.jsだと90KBほどだと思います。90KBのロードが与える性能の影響がどのくらいのものか自分にわかってないのですが、heavyN.jsのロード時間が性能を支配する主要因ならjquery/preloadのみ同期的にロードするdefghi1977さんの方法が自然に感じます。

トンチンカンなことを言っていたらご容赦ください。

Answer 4

<ul class="users">
  <li>Michael</li>
  <li>Daniel</li>
  <li>John</li>
</ul>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>
<script>
if (typeof jQuery != "undefined") {
    $('.users').each(function(index, user) {
        console.log($(user).text());
    });
}
</script>

これではダメなのですか？