$(document).ready()とDOMContentLoadedの違い書き方と3.0の変更
jQueryの$(document).ready()と素のJavaScriptのDOMContentLoadedの違いを、実行順の検証つきで解説。$(function(){})が推奨の理由、3.0で非同期になった点、loadイベントとの使い分けまで整理します。
この記事の目次
$.readyとDOMContentLoadedの違いとは
$(document).ready() は、HTMLの読み込みとDOMツリーの構築が終わった時点でコールバックを実行する jQuery の仕組みです。画像の読み込みは待たないので、window の load イベントより早く動きます。ブラウザ標準の DOMContentLoaded とほぼ同じタイミングですが、後から登録しても必ず実行される点が大きな違いです。
基本(書き方と違い)
jQuery 3.0 以降の公式ドキュメントでは、次の書き方が推奨されています。
$(function () {
// DOMの準備ができたら実行
});
次の書き方も動きますが、3.0 から非推奨です。
$(document).ready(function () { /* ... */ });
$('document').ready(function () { /* ... */ });
$().ready(function () { /* ... */ });
.ready() は選んだ要素と無関係に動くため、セレクタを付けると「その要素の準備を待つ」という誤解を生むから、というのが公式の説明です。
| 項目 | $(function(){}) |
DOMContentLoaded |
window の load |
|---|---|---|---|
| 発火のタイミング | DOM構築後 | DOM構築後 | 画像など全て読込後 |
| 後から登録した場合 | 実行される | 実行されない | 実行されない |
| 画像のサイズ取得 | 不可 | 不可 | 可能 |
画像の幅や高さが必要な処理は、$(window).on('load', fn) に書きます。
サンプルコード(実行結果つき)
const log = [];
$(function () { log.push('ready1'); });
$(document).ready(function () { log.push('ready2'); });
$(function () { throw new Error('boom'); });
$(function () { log.push('ready after error'); });
$(document).on('ready', function () { log.push('on-ready'); });
log.push('sync end of script');
// 100ms後に log を出力
出力は次のとおりでした。
sync end of script -> ready1 -> ready2 -> ready after error
ここから分かることは3つあります。
- 3.0 から ready ハンドラは非同期で呼ばれます。スクリプト末尾の
sync end of scriptが先に出ています。 - 途中の
throwは他のハンドラを止めません(3.0 から)。例外は別途ブラウザのエラーとして報告されます。 $(document).on('ready', ...)は 3.0 で削除されており、実行されません。
DOMがすでに準備済みの状態で $(fn) を呼んだ場合も、ハンドラは実行されました。
right after $(fn) -> late handler
一方、同じ状況で document.addEventListener('DOMContentLoaded', ...) を登録すると発火せず、readyState は complete でした。
動作確認(検証環境と結果)
- 環境: Node.js v24.19.0 / jsdom 30.1.2 / jQuery 3.7.1(
pretendToBeVisual有効) - 実行:
node t2.js(検証ログはtestsjquery-document-ready.md) - 結果: 上記の出力のとおり。
throwしたハンドラの後続も実行され、on('ready')は呼ばれず、遅れて登録したDOMContentLoadedは発火しませんでした。 - 実ブラウザでの
loadとの前後関係は、ここでは未検証です(仕様と公式ドキュメントに従った説明です)。
素のJavaScriptで同じ動作にしたい場合は、次の形が定番です。
function init() { /* 初期化 */ }
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', init);
} else {
init();
}
<script> を </body> の直前に置く、または defer 属性を付けると、そもそも待つ必要がなくなります。
$.readyとDOMContentLoadedの違いの注意点
- ready の中で
loadイベントを登録しない。公式ドキュメントも、ready ハンドラ内や動的に読み込んだスクリプトではloadがすでに発火済みで、登録しても動かないことがあると注意しています。 - ready 内で定義した関数・変数は、外から見えません。他のスクリプトから呼ぶ関数は、ready の外で定義します。
$.noConflict()を使う場合は、ready のコールバックの引数に jQuery が渡されるためjQuery(function ($) { ... })と書けます。- 非同期になったことで、「スクリプトの直後に ready が走る」前提のコードは動きがずれることがあります。
$.readyとDOMContentLoadedの違いでよくあるミス
- jQuery の読み込みより前に
$(function(){})を書く($ is not defined)。 $(document).on('ready', ...)を残している。3.0 以降は何も起きません。- ready の外で、まだ存在しない要素に
.on()する。動的な要素は jQuery イベント委譲 で対応します。 - 画像サイズを ready 内で取ってしまい
0になる。loadを使います。 - ready を何箇所にも書き、処理の順序に依存してしまう。登録順に実行されますが、見通しが悪くなります。
ブラウザ対応・バージョン
本記事は jQuery 3.x(3.7.1)を前提にしています。jQuery 3.x は IE9 以降と主要ブラウザの最新版・1つ前の版が対象です(2026年1月公開の jQuery 4.0.0 は IE10 以前のサポートを終了。最新は公式で確認してください)。DOMContentLoaded と readyState はすべての現行ブラウザで使えます。ready の非同期化は 3.0 で入りました。jQuery 1.x/2.x から更新する際は、公式の jQuery Migrate プラグインで警告を確認する手順が案内されています(jQuery 3の変更点・非推奨API も参照)。
$.readyとDOMContentLoadedの違いのチェックリスト
$(function () { ... })の形で書いている。$(document).on('ready')を使っていない。- 画像サイズが必要な処理は
loadに書いている。 - 他のスクリプトから呼ぶ関数を ready の外に出している。
deferで足りないか検討した。
$.readyとDOMContentLoadedの違いのFAQ(よくある質問)
$(document).ready と $(function(){}) は何が違いますか。
動作は同じです。3.0 から公式は短い後者を推奨しています。
DOMContentLoaded に置き換えても大丈夫ですか。
readyState を確認する形(上のコード)にすれば、同じ挙動にできます。
ready の中の処理が二重に走ります。
同じ関数を複数回登録していないか、スクリプトを二重に読み込んでいないかを確認してください。
筆者の見解($.readyとDOMContentLoadedの違い)
新しく書くなら defer 属性と素の DOMContentLoaded、既存の jQuery コードなら $(function(){}) に統一する、という分け方が分かりやすいと考えます。$(document).ready を一括置換する必要はありませんが、触るついでに短い形へ揃えておくと、将来の更新時の差分が小さくなります。
PR SkillHacks
ウェブ制作の次の一歩を、動画講座で自分のペースで進められます
独学のまま詰まって、制作の勉強が止まってしまう前に
こんなお悩みはありませんか?
- HTMLとCSSは分かったが、アプリや仕事の受注までの道筋が見えない
- 独学で詰まったとき、聞ける相手がいない
- スクールは高額で、続けられるか不安
プログラミングの独学は、エラーで進めなくなったときに聞く相手がいないと、そのまま止まりがちです。始める前に、質問できる時間帯と方法、受講期間、料金を確認しておくと選びやすくなります。
Programming Hacks(旧Skill Hacks)は、94本以上の動画で基礎からツール・アプリ作成、仕事の受注まで学べる買い切りのオンライン講座です。目安は1日2時間で2か月。質問は24時間LINEで送れます。
選ばれるポイント
- 仕事の受注まで見通せる。基礎からツール・アプリ作成、仕事の受注までを一つの講座で学べる
- 自分の時間割で進められる。動画講義が94本以上あり、目安は1日2時間で2か月
- 期限を気にせず学べる。受講期間は無制限で、修了後の再受講もでき、会員サイトは永久ログイン
- 詰まっても止まりにくい。24時間LINEで質問でき、サポートは無制限に延長と案内されている
- 追加費用を気にせず続けやすい。買い切り型で、料金は公式サイトに記載。支払いはクレジットカード・PayPal・銀行振込
- 講座の中身を確認してから決められる。運営は株式会社スキルハックス。申込前に特定商取引法の表記と最新の料金を公式サイトで確認する
買い切り型で、受講期間の期限はありません。申込前に講座の内容を公式サイトで確認できます
Programming Hacksの講座ページを開きます
【PR】この枠は広告(アフィリエイト)を含みます。内容は2026年11月15日時点の公式サイトの記載です。料金・サポート範囲・返金の可否は変わることがあるため、申込前に公式サイトと特定商取引法の表記で最新の条件をご確認ください。
$.readyとDOMContentLoadedの違いの関連項目
- jQueryの基礎中の基礎をなるべく分かり易く解説!
- jQuery on()
- jQuery イベント委譲
- jQuery 3の変更点・非推奨API
- JavaScriptを必ずCSSの後に読み込ませるべき理由とは?
出典(一次情報)
本記事は情報提供を目的としています。ブラウザの仕様やライブラリのバージョンによって動作が異なる場合があるため、実際の開発では公式ドキュメントも合わせてご確認ください。
