DOM

どのようなものか

DOMは、Document Object
Modelの略で、ブラウザーがページから作り、開いている間、メモリーに保
持する、オブジェクトの木です。HTMLパーサーは、マークアップを読み、文
書オブジェクトを出力します。各要素、連続したテキスト、コメントが、そ
れぞれノードとなり、各ノードは、親、子、隣接するノードを知っていま
す。スクリプトは、この木を通じてページを読み、変更します。ブラウザー
が描くものも、木から決まります。

WHATWGは、DOM標準で、このモデルを維持しています。標準の要約は、特定
のプラットフォームに結び付けず、ノードの木、イベント、進行中の処理の
中止という、三つの対象を挙げます。名前は、標準より古いものです。元
は、文書へアクセスして変更するインターフェースを意味しました。今は、
木自体もDOMと呼ぶことが多く、両方の意味を日常的に使います。HTML標準
は、その上に構築されています。HTMLは、要素とその動作を定義し、DOM標
準は、ノード、要素、属性、イベントとは何かを定義します。

木は、ソースファイルではありません。ページのHTMLは、ネットワークから
届いたテキストです。DOMは、HTML標準の規則に従ってすべての解析エラー
を処理し、パーサーがそのテキストから作ったものを、その後のスクリプト
が変更した結果です。パーサーは、忘れがちな細部も残します。二つのタグ
の間の空白が、独立したテキストノードになる場合があります。そのため、
最初の子ノードは、必ずしも中の最初の要素ではありません。ただし、標準
自身の例も、すべての空白がテキストノードになるわけではないと記してい
ます。

ノードには、いくつかの種類があります。ルートには文書があり、その下
に、文書型宣言、要素、テキストノード、コメントがあります。文書フラグ
メントは、ページの木の外にある、軽い入れ物です。ブロックを組み立てて
から一度に挿入する場所として、便利です。要素は、シャドウツリーを持つ
こともできます。独立した別の木で、文書の通常のクエリーは、中へ届きま
せん。

ノードの一覧には二種類あり、その違いが重要です。標準では、特記がなけ
れば、コレクションはライブです。`childNodes`と、
`getElementsByClassName()`が返すHTMLCollectionは、木が変わると、とも
に変わります。`querySelectorAll()`は、明記した例外で、呼び出し時点の
スナップショットである、静的な一覧を返します。

同じ標準が、イベントの伝わり方も定義します。イベントは、対象のノード
へ送出され、三段階を通ります。木の上から対象の祖先を通って下るキャプ
チャー、対象自体、祖先を通って上へ戻るバブリングです。`eventPhase`プ
ロパティーは、段階を1、2、3で表し、送出中でなければ0です。
`addEventListener()`で加えるリスナーには、オプションがあります。
`once`は、最初の呼び出し後に取り除き、`passive`は、
`preventDefault()`を呼ばないと約束します。`signal`は、
`AbortController`へ結び付け、コントローラーを中止すると、リスナーも
外れます。

なぜ重要なのか

ページを変えるスクリプトは、言語やフレームワークに関係なく、DOMを通
じて動きます。フレームワークは、独自の層を上に加えますが、読者が最後
に見るものは、この木のノードです。Next.jsは、ハイドレーションを、
ReactがDOMへイベントハンドラーを取り付けることと説明します。サーバー
から届いたHTMLが、クリックに応答するページになる仕組みです。下にある
木を理解したチームは、フレームワークへ頼んだ内容ではなく、実際の動作
をデバッグできます。

木は、テキストとマークアップが分かれる場所でもあります。
`textContent`へ代入した文字列は、要素の子を、一つのテキストノードで
置き換え、マークアップとして解釈されることはありません。同じ文字列を
`innerHTML`へ代入すると、HTMLパーサーへ渡します。HTML標準は、この
HTMLの代入処理では、既定で危険なものを取り除かないと記しています。ど
ちらを使うかで、訪問者の表示名が、テキストとして表示されるか、コード
として動くかが決まります。

読者の体験は、木だけでは決まりません。スタイルが、ノードの可視性、位
置、ポインターで届くかどうかを決めます。ノードをたどるだけの道具から
は、どれも見えません。この差が、自動検査のよく間違う部分で、文書だけ
でなく、描画されたページもテストする理由です。

最後に、DOMは、サーバーの仕事が終わった後のページと、それを読むすべ
てのものとの間の取り決めです。クリックして進むテスト、ブラウザー拡
張、支援ソフトウェアは、すべてライブの木から始めます。この取り決めに
は、見落としやすい別の側面もあります。JavaScriptを動かさないクロー
ラーは、送られたHTMLだけを見て、後からスクリプトが加えるノードは見ま
せん。

実際の活用例

この記事用に書いた次のスクリプトは、データから注文の一覧を作ります。
項目ごとではなく、一覧に一つだけクリックリスナーを置き、後で、一回の
呼び出しで取り除けます。`openOrder`は、注文を選んだときにページが行
う処理を表します。

```js
const list = document.querySelector("#orders");
const controller = new AbortController();

function render(orders) {
  const items = orders.map((order) => {
    const li = document.createElement("li");
    li.dataset.id = order.id;
    li.textContent = `${order.number}: ${order.status}`;
    return li;
  });
  list.replaceChildren(...items);
}

list.addEventListener(
  "click",
  (event) => {
    const li = event.target.closest("li");
    if (li) openOrder(li.dataset.id);
  },
  { signal: controller.signal },
);

// ビューを破棄するとき：
controller.abort();
```

どの部分も、標準に対応します。`createElement()`は、挿入するまで親を
持たない要素を作ります。`textContent`は、注文番号をテキストとして置
くので、山括弧を含む状態表示でも、状態表示のままです。
`replaceChildren()`は、古い項目を消し、一回の操作で新しい項目を挿入
します。項目のクリックは一覧までバブリングするので、一つのリスナー
が、すべての項目に対応します。`closest()`は、クリックした場所から、
最も近い`li`までたどります。コントローラーを中止すると、ページが関数
の参照を残さなくても、リスナーを取り除けます。

このサイトのレビューで見つかった、ある種類の欠陥も、木から説明できま
す。2026年8月のアクセシビリティーレビューでは、自動ルールを通って
も、十一件の欠陥がありました。どれも、マークアップの内容ではなく、描
画に関わるものでした。フッターの八つのリンクは、`pointer-events`によ
りポインターでは操作できないのに、タブ移動の順序には残っていました。
このプロパティーが取り除くのは、ポインターによる操作だけです。文書を
読む道具には、普通のリンクです。ポインターは届かず、キーボードは、す
べてで止まりました。スクロールに連動するアニメーションによって、三つ
のページではフッターが切れて表示されなくなっていました。レビューが残
した四つの規則のうち、一つは、木だけを信じないための警告です。可視性
は、文書の木だけでなく、描画したピクセルから確かめる必要があります。

問題が起きるところ

ライブのコレクションを回すループが、一つおきに飛ばします。
`getElementsByClassName()`のHTMLCollectionはライブなので、添え字で各
要素のクラスを取り除くループは、途中でコレクション自体を縮め、一つお
きに飛ばします。代わりに、静的な一覧をたどります。
`querySelectorAll()`は静的な一覧を返し、`Array.from()`なら、先にライ
ブのコレクションを通常の配列へ変えられます。

```js
const pending = document.getElementsByClassName("pending");
for (let i = 0; i < pending.length; i++) {
  pending[i].classList.remove("pending"); // 一つおきに飛ばしてしまう
}

for (const el of document.querySelectorAll(".pending")) {
  el.classList.remove("pending"); // 静的な一覧なので、すべてを処理する
}
```

リスナーが、積み重なります。
描画のたびにリスナーを加え、取り除かないビューは、イベントのたびに、
描画した回数だけハンドラーを動かします。三回訪問すると、一回のクリッ
クで三つのリクエストを送ります。手で取り除くには、加えたときと、まっ
たく同じ関数オブジェクトが必要です。呼び出しの場でアロー関数を書く
と、後で渡すものが残りません。先の例のように、ビューごとの一つの
`AbortController`から`signal`を渡します。一回の`abort()`で、その
ビューが加えたすべてのリスナーを外せます。一度だけ動かすものには、
`once:
true`を使います。

テキストを、マークアップとして入れます。
データからHTML文字列を作り、`innerHTML`へ代入すると、既定のサニタイ
ズなしで、パーサーへ渡します。エラーハンドラー付きの画像タグなど、
マークアップを含む表示名が、ハンドラーの付いた本物の要素としてページ
へ届きます。テキストは、`textContent`か、`createTextNode()`で作るテ
キストノードへ置きます。本当に文字列からマークアップを作る必要がある
場合、HTML標準は、解析中にサニタイズし、危険な内容を取り除く
`setHTML()`を定義しています。

オブザーバーが、自分自身を動かします。
`MutationObserver`は、監視するノードの変更を報告し、変更の各まとまり
の後に、コールバックを動かします。カウンターを加えたり、クラスを直し
たりするために、監視中のサブツリーへ書くコールバックは、新しい変更レ
コードを生み、再び呼ばれます。ページが、自ら作るループで動かなくなる
場合があります。必要なところだけを、`attributeFilter`を使い、可能な
ら`subtree`なしで監視します。書く前に、すでに変更済みか確かめるよう
にするか、書く前に`disconnect()`、後に`observe()`を呼びます。

参考資料

  * DOM標準 —
WHATWGによる、ノード、木、ライブと静的なコレクション、イベント、
`AbortController`、`MutationObserver`の定義です。

  * HTML文書の解析 — HTMLパーサーが、文字の流れから、解析エラーも処
理しながら、文書オブジェクトを作る方法です。

  * 動的なマークアップの挿入 —
`innerHTML`、`setHTML()`、`setHTMLUnsafe()`と、それぞれがサニタイズ
するかどうかです。

  * サーバーとクライアントのコンポーネント —
Next.jsによるハイドレーションの説明です。サーバーからHTMLが届き、そ
の後、DOMにイベントハンドラーを取り付けます。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/dom/	engineer.company	70
