JSXの正体 — ただの関数呼び出しだった

JSXの正体を知る。JSXのカードと関数を表すブロック、ノートパソコン。

JSXは特別な文法ではなく、関数呼び出しに変換されているだけです。変換後の姿を見れば、書き方の決まりの理由が分かります。

前回: コンポーネントは見た目の部品ではない — propsと状態

これは深掘りです。本線の順路ではありません。 本線のコンポーネントの回で props とリフトアップまで進んだ人が、「JSX のこの決まりは、覚えるしかないのか」というところで手が止まったときに読む記事です。飛ばしても本線は進みます。

この記事のコマンドは、すべて Ubuntu Server の中で打ちます。 Windows の PowerShell ではありません。 プロンプトが ユーザー名@ホスト名:~$ になっていれば、Linux の中にいます。 本線で作った ~/react-demo/ には一切触りません。 この記事は ~/reactlab/ を新しく作り、最後に丸ごと消します。

本線のフレームワークの回で、こう書きました。

JSX は「関数呼び出しの、見やすい書き方」でしかありません。

あれは、読んで納得しただけでした。 自分は変換後のコードを一度も見ていません。見ていないので、className も htmlFor も key も、結局は暗記した項目として頭に残っていました。暗記した項目は、少し形が変わると使えません。実際、{tasks.length && <p>…</p>} と書いて画面に 0 が出たとき、自分は理由が分からず、0 を消すためだけに条件を書き足しました。

この記事は、JSX の決まりを覚え直す記事ではありません。 JSX を変換器にかけて、出てきた JavaScript を1行ずつ読む記事です。出てきたコードを読めば、以下が全部同じ1つの理由から出てくることが分かります。

見た目の決まり変換後を見ると
class ではなく classNameオブジェクトのキーとして書かれている。class は予約語
key は props に入らない第3引数として、props とは別の場所に渡っている
{} に if が書けない変換前に構文エラーになる。React はまだ何もしていない
0 だけ画面に出る&& が左の値をそのまま返す。0 は「描かない値」に含まれていない
小文字のタグは部品にならない文字列 "mybutton" になる。大文字だけが変数参照になる

この対応表を、自分の手で作ります。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • JSX の変換には2種類(classic と automatic)あること。React.createElement を見たことがあるのに、いま自分のコードに import React が無い理由
  • key は props ではないこと。props.key は取れない理由が、変換後の引数の位置で説明できること
  • if が書けないのは React の制限ではなく、変換前の構文エラーであること。式と文の違いが、そのまま JSX の書ける・書けないになっていること
  • 配列は返せるがオブジェクトは返せないこと。false / null / undefined は何も描かないのに 0 は描かれる理由
  • children も props の1つにすぎないこと。スプレッド {...props} が、ただのオブジェクトの展開であること
  • dangerouslySetInnerHTML の名前が異常に長いのは、打ちにくくして事故を減らすためだということ
  • <div /> と書いた時点では、まだ何も描かれていないこと。それはただのオブジェクトで、描くのは React の仕事だということ

この記事でやること

  1. ~/reactlab を新しく作る(本線の ~/react-demo は触らない)
  2. npx esbuild に JSX を通して、変換後のコードを画面に出す。classic と automatic を見比べる
  3. <div className="a">こんにちは</div> の1行が、何の何になったかを対応表にする
  4. if を書いてわざと変換エラーを出す。式と文の境目を目で見る
  5. ブラウザで「返せるもの・返せないもの」を1つずつ試す。オブジェクトを返してエラーを出し、0 が画面に出るところを再現する
  6. console.log(<div />) で、React 要素の中身を開く
  7. ~/reactlab を消して、~/react-demo が無事なことを確かめる

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
トランスパイルあるコードを、同じ意味の別のコードに書き換えること。 JSX → JavaScript がこれ
esbuildGo で書かれた高速な変換器。 Vite の中で実際に動いている部品で、単体でも呼べる
classic 変換 / automatic 変換JSX の変換の2方式。前者は React.createElement を呼ぶので import React が必須。後者は react/jsx-runtime を自動で読み込むので不要
式(expression)値になるもの。 1 + 2、a ? b : c、関数呼び出し。{} の中に書けるのはこれだけ
文(statement)動作の単位。 if、for、return。値にならないので {} の中に置けない
React 要素<div /> と書いたときに作られる、ただの JavaScript オブジェクト。 DOM ではない
FragmentDOM には何も出さない、囲むためだけの入れ物。 <>...</> と書く
XSS他人が書いた文字列が、そのページの JavaScript として動いてしまう攻撃

「JSX は HTML に似せた構文です」という説明は、半分しか正しくありません。 似せたのは見た目だけで、中身は JavaScript のオブジェクトリテラルと関数呼び出しです。 似ているせいで、HTML の知識をそのまま持ち込むと必ず外れます。 この記事は、似ている部分を全部はがして、下の JavaScript を見るためのものです。


① 練習用のプロジェクトを作る

本線で作った ~/react-demo/ は、この記事では一切触りません。 壊すと本線に戻れなくなるためです。新しく ~/reactlab/ を作ります。

VMの中で打ちます。

bash
$ cd ~
$ ls
react-demo

react-demo が見えていれば、正しい場所にいます。 ここに、もう1つ作ります。

bash
$ npm create vite@latest reactlab -- --template react

--template react を付けているので、選択画面は出ません。 そのまま作られます。

Scaffolding project in /home/ユーザー名/reactlab...

Done. Now run:

  cd reactlab
  npm install
  npm run dev

言われた通りに進めます。

bash
$ cd ~/reactlab
$ npm install
added 152 packages, and audited 153 packages in 8s

数字は違って構いません。 npm の回でやった通り、node_modules/ はここで作られます。

この記事では、本線と別のポート(5174番)を使います。 ~/react-demo を起動したままでも、ぶつからないようにするためです。

bash
$ sudo ufw allow 5174/tcp
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
5173/tcp                   ALLOW       Anywhere
5174/tcp                   ALLOW       Anywhere

5174/tcp の行が出れば準備完了です。開け忘れると、起動は成功しているのにブラウザは読み込み中のままになります。切り分けの順番はネットワークの回と同じです。

まだ起動しません。 ②〜④はブラウザを使わず、ターミナルだけで進みます。


② 変換後のコードを、実際に見る

ここが山場のひとつめです。

Vite は、JSX をそのままブラウザに渡してはいません。 渡す前に変換しています。変換をしているのは esbuild という部品で、ビルドツールの回で名前だけ出てきたものです。これは単体でも呼べます。

npm install を済ませたので、esbuild はもう node_modules/ の中にあります。 ネットから落とさずに呼べます。

bash
$ cd ~/reactlab
$ npx esbuild --version
0.25.0

数字は違って構いません。 npx は「node_modules/ の中にある実行ファイルを呼ぶ」コマンドです。

変換にかける1行を用意する

bash
$ mkdir -p ~/reactlab/jsxlab
$ cat > ~/reactlab/jsxlab/a.jsx <<'EOF'
  const el = <div className="a">こんにちは</div>;
  EOF
$ cat ~/reactlab/jsxlab/a.jsx
const el = <div className="a">こんにちは</div>;

<<'EOF' はヒアドキュメントといって、次に EOF だけの行が出るまでを、そのままファイルに書くという書き方です。'EOF' とクォートで囲んでいるので、中身の $ や記号がシェルに解釈されません。

classic 変換 — React.createElement が出てくる

bash
$ npx esbuild jsxlab/a.jsx --loader=jsx --charset=utf8
const el = /* @__PURE__ */ React.createElement("div", { className: "a" }, "こんにちは");

これが JSX の正体です。 1行の JSX が、1つの関数呼び出しになりました。

--charset=utf8 を付けている理由: 付けないと esbuild は日本語を "\u3053\u3093\u306B\u3061\u306F" のような形に書き換えます(既定は ASCII だけで出力する設定のため)。壊れているわけではありませんが、読めないので付けています。

/* @__PURE__ */ は「この呼び出しには副作用が無い」という印です。使われなければ削ってよい、と後段の道具に伝えるためのコメントで、意味には関係ありません。無視して構いません。

1行ずつ対応させる

元の JSX と 変換後 を、部品ごとに並べます。

JSX で書いたもの変換後のどこ何になったか
<div"div"第1引数。ただの文字列
className="a"{ className: "a" }第2引数のオブジェクトのキーと値
>こんにちは<"こんにちは"第3引数。子ども
</div>(消える)閉じタグは引数の切れ目でしかない

ここで、本線で「覚えてください」と書いた2つが、理由込みで回収できます。

  • class ではなく className — 属性はオブジェクトのキーとして書かれます。{ class: "a" } は、JavaScript の予約語をキーに使うことになります(オブジェクトのキーとしては実は書けるのですが、JSX の側が class を予約語として扱わない保証をできないため、React は最初から className を採用しました)。そして何より、props.class として関数の中で受け取ったときに、変数名として使えません。
  • for ではなく htmlFor — 同じ理由です。for はループの予約語なので、props.for を取り出して変数にできません。

覚えるべきは「className と htmlFor」ではありません。 「属性は、JavaScript のオブジェクトのキーになる」という1つの事実です。ここから両方が導けます。

automatic 変換 — いまの React が使っているのはこちら

React.createElement が出てきましたが、いま ~/react-demo/src/App.jsx の先頭に import React from "react" は書いていません。 本線で一度も書かなかったはずです。それでも動いていました。

変換方式が違うからです。

bash
$ npx esbuild jsxlab/a.jsx --loader=jsx --jsx=automatic --charset=utf8
import { jsx } from "react/jsx-runtime";
const el = /* @__PURE__ */ jsx("div", { className: "a", children: "こんにちは" });

2つ変わりました。

  1. import の行が、勝手に足されている。 だから import React を自分で書かなくてよい
  2. 子どもが第3引数ではなく、children というキーに入った

Vite の React プラグインは、この automatic のほうを使っています。 検索して出てくる古い記事に React.createElement が出てくるのは、2020年より前は classic しか無かったからです。どちらも「関数呼び出しになる」という点は同じです。

[スクリーンショット: 01_esbuild変換結果.png] VM のターミナルで npx esbuild jsxlab/a.jsx --loader=jsx --jsx=automatic --charset=utf8 を実行し、import { jsx } from "react/jsx-runtime"; と jsx("div", { className: "a", children: "こんにちは" }) の2行が出ている画面を撮ってください。

子どもが複数あるときは jsxs になる

bash
$ cat > ~/reactlab/jsxlab/b.jsx <<'EOF'
  const el = (
    <ul className="list">
      <li>あ</li>
      <li>い</li>
    </ul>
  );
  EOF
$ npx esbuild jsxlab/b.jsx --loader=jsx --jsx=automatic --charset=utf8
import { jsx, jsxs } from "react/jsx-runtime";
const el = /* @__PURE__ */ jsxs("ul", { className: "list", children: [
  /* @__PURE__ */ jsx("li", { children: "あ" }),
  /* @__PURE__ */ jsx("li", { children: "い" })
] });

jsx と jsxs の2つが出てきました。 末尾の s は children が配列(複数)のときに使われる版です。中身の意味は同じで、React 側が「配列かどうか」を毎回調べずに済むように分けてあるだけです。

そして、入れ子の JSX が、そのまま関数呼び出しの入れ子になっています。 <ul> の中に <li> を書くことは、jsxs(...) の引数に jsx(...) の結果を入れることと同じです。

key は props ではない

本線で tasks.map() に key を付けました。 あれが props に入らないことも、変換後を見れば分かります。

bash
$ cat > ~/reactlab/jsxlab/c.jsx <<'EOF'
  const el = <li key="k1" className="row">あ</li>;
  EOF
$ npx esbuild jsxlab/c.jsx --loader=jsx --jsx=automatic --charset=utf8
import { jsx } from "react/jsx-runtime";
const el = /* @__PURE__ */ jsx("li", { className: "row", children: "あ" }, "k1");

className は第2引数のオブジェクトの中に入りましたが、key だけ第3引数に出ています。

だから、コンポーネントの中で props.key を読んでも undefined です。 props のオブジェクトに入っていないからです。key は「React が並び替えを追跡するための札」であって、部品に渡すデータではありません。

もし ID を子コンポーネントの中でも使いたいなら、key とは別に渡す必要があります。 <TaskItem key={t.id} id={t.id} /> のように、2回書くのが正解です。重複に見えますが、行き先が違います。


③ {} の中に書けるのは「式」だけ

本線で「if は書けない、三項演算子は書ける」と書きました。 これも変換にかければ、React の制限ですらないことが分かります。

bash
$ cat > ~/reactlab/jsxlab/d.jsx <<'EOF'
  const n = 1;
  const el = <p>{ if (n > 0) { "あり" } }</p>;
  EOF
$ npx esbuild jsxlab/d.jsx --loader=jsx --jsx=automatic --charset=utf8
✘ [ERROR] Unexpected "if"

    jsxlab/d.jsx:2:19:
      2 │ const el = <p>{ if (n > 0) { "あり" } }</p>;
        ╵                    ^

1 error

エラーの出どころに注目してください。 React ではなく esbuild が、変換の時点で止めています。ブラウザにすら届いていません。

{} の中は、関数の引数の中と同じ場所です。

jsx("p", { children: ここ });

ここ に if を書けるでしょうか。 書けません。f(if (a) { b }) という JavaScript は存在しません。引数に置けるのは「値になるもの」=式だけです。

三項演算子は式なので、置けます。

bash
$ cat > ~/reactlab/jsxlab/e.jsx <<'EOF'
  const n = 1;
  const el = <p>{n > 0 ? "あり" : "なし"}</p>;
  EOF
$ npx esbuild jsxlab/e.jsx --loader=jsx --jsx=automatic --charset=utf8
import { jsx } from "react/jsx-runtime";
const n = 1;
const el = /* @__PURE__ */ jsx("p", { children: n > 0 ? "あり" : "なし" });

children: の値として、そのまま入っています。

書けるもの(式)書けないもの(文)
a + b / f(x) / obj.keyif (a) { ... }
a ? b : cfor (...) { ... }
a && b / a || bconst x = 1;
arr.map(...)return ...
(() => { if (a) return b; })() ← 関数で包めば式になるswitch (...) { ... }

最後の行が抜け道です。 どうしても if を書きたければ、その場で関数を作って呼ぶ(即時実行関数)と、全体が「関数呼び出し」という式になります。ただし読みにくいので、実際には JSX の外で先に計算します。 JavaScript の基本の回でやった「式と文」の区別が、ここで表示の書き方をそのまま決めています。


④ 返せるものと、返せないもの

ここが山場のふたつめです。 ここからブラウザを使います。

bash
$ cd ~/reactlab
$ npm run dev -- --host 0.0.0.0 --port 5174
  VITE v6.0.0  ready in 412 ms

  ➜  Local:   http://localhost:5174/
  ➜  Network: http://192.168.226.50:5174/

ホストの Windows のブラウザで http://192.168.226.50:5174/(IPは自分の値に。分からなければ VM の中で ip a)を開き、React と Vite のロゴのページが出ることを確認します。

確認できたら、src/App.jsx を丸ごと置き換えます。 VS Code から編集して構いません。

function App() {
  return (
    <div style={{ padding: "24px", fontFamily: "sans-serif" }}>
      <h1>返せるもの・返せないもの</h1>
      <hr />
    </div>
  );
}

export default App;

保存すると、ブラウザが自動で切り替わります。 ここに1つずつ足していきます。

配列は返せる

コンポーネントは、JSX を1つ返すものだと思いがちですが、配列も返せます。

App の上に足します。

function ArrayOk() {
  return [<p key="1">配列の1つ目</p>, <p key="2">配列の2つ目</p>];
}

App の <hr /> の下に <ArrayOk /> を置きます。2行そのまま出れば成功です。

なぜ返せるのか。 変換後を思い出すと、children には配列がそのまま入る(jsxs の例)からです。React にとって「子ども」は最初から配列を許す形です。

配列で返すなら key が要ります。 付けないとブラウザのコンソールに Each child in a list should have a unique "key" prop. という警告が出ます。赤いエラーではなく警告なので、画面は動いてしまいます。 F12 を開いていないと気づきません(開発者ツールの回)。

オブジェクトは返せない — わざとエラーを出す

function ObjectNg() {
  return { title: "これは出ません" };
}

<ObjectNg /> を足して保存すると、画面が真っ白になり、エラーが出ます。

Objects are not valid as a React child (found: object with keys {title}).
If you meant to render a collection of children, use an array instead.

「オブジェクトは React の子どもとして正しくない」です。理由は、React が「これをどう文字にすればいいか」を決められないからです。

  • 文字列・数値 → そのまま文字にする
  • 配列 → 中身を1つずつ処理する
  • React 要素(jsx() の戻り値) → 描く
  • { title: "..." } → どうすればいい?

{} の中に生のオブジェクトを置いたときも、同じエラーになります。 実務でいちばん多いのは日付です。

<p>{new Date()}</p>

これはエラーになります。 Date はオブジェクトだからです。{new Date().toLocaleString()} と、自分で文字にしてから渡します。

確認できたら <ObjectNg /> の行と関数を消してください。 画面が真っ白のままだと、この先が見えません。

false / null / undefined は何も描かない。ただし 0 は描かれる

ここが、本線で自分が踏んだところです。

function Falsy() {
  const items = [];
  const name = null;
  return (
    <div>
      <p>ここから下に4行分の「何か」があります</p>
      <div>[{false}]</div>
      <div>[{null}]</div>
      <div>[{undefined}]</div>
      <div>[{name && <span>名前あり</span>}]</div>
      <div>[{items.length && <span>件数あり</span>}]</div>
    </div>
  );
}

<Falsy /> を足して保存し、ブラウザで見てください。

[]
[]
[]
[]
[0]

最後の1行だけ 0 が出ます。

理由は React ではなく && の仕様です。

式返る値画面
null && <span/>null何も出ない
false && <span/>false何も出ない
0 && <span/>00 と出る
"" && <span/>""何も出ない(空文字は描いても見えない)

&& は真偽値を返しません。 「左が偽なら左の値を、真なら右の値を」返します。 そして React は、false / null / undefined / true を「描かない値」として決め打ちしていますが、0 はそこに入っていません。 0 は立派な数値で、数値は描く対象だからです。

直し方は1つです。

<div>[{items.length > 0 && <span>件数あり</span>}]</div>

> 0 を付けて、左を必ず真偽値にします。 Boolean(items.length) && ... でも、三項演算子 items.length ? <span/> : null でも構いません。「&& の左に数値を置かない」が守る型です。

[スクリーンショット: 02_0だけ表示される.png] ホストのブラウザで Falsy の結果が出ている状態を撮ってください。[] が4つ並び、最後だけ [0] になっているところが写るようにしてください。

Fragment が要る理由

ArrayOk を、配列ではなく普通に書き直そうとすると詰まります。

function Two() {
  return (
    <p>1つ目</p>
    <p>2つ目</p>
  );
}

これは変換の時点で落ちます。 理由は、変換後を想像すれば分かります。

return jsx("p", {...}) jsx("p", {...});   // 文法として成立しない

return は値を1つしか返せません。 関数呼び出しを2つ並べて置く文法は、JavaScript にありません。

囲めば1つになります。

function Two() {
  return (
    <>
      <p>1つ目</p>
      <p>2つ目</p>
    </>
  );
}

<>...</> が Fragment です。 変換後がどうなるか、確かめます。

bash
$ cat > ~/reactlab/jsxlab/f.jsx <<'EOF'
  const el = (
    <>
      <p>1つ目</p>
      <p>2つ目</p>
    </>
  );
  EOF
$ npx esbuild jsxlab/f.jsx --loader=jsx --jsx=automatic --charset=utf8
import { Fragment, jsxs, jsx } from "react/jsx-runtime";
const el = /* @__PURE__ */ jsxs(Fragment, { children: [
  /* @__PURE__ */ jsx("p", { children: "1つ目" }),
  /* @__PURE__ */ jsx("p", { children: "2つ目" })
] });

Fragment という「印」が第1引数に入っただけです。"div" のような文字列ではないので、React はDOM 要素を作らず、中身だけを外に出します。

<div> で囲んでも動きますが、意味のない <div> が1つ増えます。 CSS の回でやった通り、<div> が1つ増えると Flexbox や Grid の子要素の数が変わり、レイアウトが崩れます。 Fragment は、それを避けるためのものです。

key を付けたいときだけ、<> は使えません。 <Fragment key={x}>...</Fragment> と、import { Fragment } from "react" して書きます。<> は省略記法なので、属性を書く場所がないからです。


⑤ コンポーネントは大文字で始める

本線で「小文字だと動かない」とだけ書きました。 何が起きているかを見ます。

bash
$ cat > ~/reactlab/jsxlab/g.jsx <<'EOF'
  const el1 = <mybutton />;
  const el2 = <MyButton />;
  EOF
$ npx esbuild jsxlab/g.jsx --loader=jsx --jsx=automatic --charset=utf8
import { jsx } from "react/jsx-runtime";
const el1 = /* @__PURE__ */ jsx("mybutton", {});
const el2 = /* @__PURE__ */ jsx(MyButton, {});

決定的な差です。

書き方変換後の第1引数React から見ると
<mybutton />"mybutton"(クォート付き=文字列)HTML のタグ名として扱う
<MyButton />MyButton(クォート無し=変数)その関数を呼ぶ

変換器は、頭文字が大文字かどうかだけを見て、文字列にするか変数にするかを決めています。 ファイル名でも、export の有無でも、import したかどうかでもありません。1文字目だけです。

ブラウザでも起こします。 src/App.jsx に足します。

function greeting() {
  return <p>これは出ません</p>;
}

App の中に <greeting /> を置いて保存します。エラーは出ません。 そして画面にも何も出ません。

F12 でコンソールを開くと、警告だけが出ています。

Warning: <greeting /> is using incorrect casing.
Use PascalCase for React components, or lowercase for HTML elements.

これがいちばん怖い形です。 真っ白なエラー画面なら気づきます。警告は、開発者ツールを開いていなければ見えません。 ブラウザは <greeting> という知らないタグを無害な空要素として受け入れるので、画面は静かに欠けます。

<greeting /> を書いても greeting() は一度も呼ばれません。 中の <p> は存在しないので、「なぜか表示されない」ではなく「そもそも実行されていない」が正しい理解です。

確認できたら <greeting /> と関数を消します。


⑥ props の正体は、ただのオブジェクト

本線で「props は親から子への一方通行」と書きました。 変換後を見ると、props は「関数呼び出しの第2引数のオブジェクト」そのものだと分かります。

bash
$ cat > ~/reactlab/jsxlab/h.jsx <<'EOF'
  const rest = { id: 1, done: false };
  const el = <TaskItem title="買い物" {...rest} onDone={f}>本文</TaskItem>;
  EOF
$ npx esbuild jsxlab/h.jsx --loader=jsx --jsx=automatic --charset=utf8
import { jsx } from "react/jsx-runtime";
const rest = { id: 1, done: false };
const el = /* @__PURE__ */ jsx(TaskItem, { title: "買い物", ...rest, onDone: f, children: "本文" });

3つ確認できます。

  1. title="買い物" は、ただのキーと値
  2. {...rest} は、ただのスプレッド構文。JSX 固有の記法ではなく、オブジェクトを展開する JavaScript の書き方がそのまま出ている
  3. タグに挟んだ「本文」は、children というキーに入っている。children も props の1つでしかない

だから、この2つはまったく同じ意味になります。

<Box children="こんにちは" />
<Box>こんにちは</Box>

後者は前者の書きやすい形というだけです。children が特別な仕組みではなく、ただの決まった名前のキーだと分かると、props.children を条件で出し分けたり、配列として数えたりできるようになります。

スプレッドの順番には意味があります。 上の出力で title → ...rest → onDone の順に並んでいる通り、後に書いたキーが勝ちます。

<Box color="red" {...props} />    {/* props に color があれば、そちらが勝つ */}
<Box {...props} color="red" />    {/* 必ず red になる */}

「既定値として使いたいなら先に、上書きしたいなら後に」です。これはオブジェクトリテラルの規則そのもので、React の規則ではありません。


⑦ dangerouslySetInnerHTML の名前が長い理由

React では、文字列はすべて「文字として」描かれます。

src/App.jsx に足して確かめます。

function Escaped() {
  const fromUser = "<b>太字にしたい</b>";
  return <p>{fromUser}</p>;
}

画面には、太字ではなく <b>太字にしたい</b> という文字列がそのまま出ます。

これは React の親切ではなく、防御です。 DOM 操作の回で innerHTML を使いました。あれは渡された文字列を HTML として解釈します。 つまり、掲示板の投稿欄に <img src=x onerror="..."> と書かれたら、それが実行されます。 これが XSS です。

React は、{} に入れた文字列を必ずエスケープします。 何も考えずに書いても、既定で安全になります。

それでも HTML として入れたいとき(自分が書いた Markdown を変換した結果など)は、専用の props を使います。

function Raw() {
  const html = "<b>これは太字になります</b>";
  return <div dangerouslySetInnerHTML={{ __html: html }} />;
}

この名前と形は、わざとです。

わざとやっていること狙い
dangerously(危険なことに)から始まる長い名前打つときに必ず一度読む。 レビューで検索して見つけられる
文字列ではなく {{ __html: ... }} というオブジェクトを渡させるうっかり変数を渡せない。 1段余計な手間で、意図を明示させる
アンダースコア2つの __html通常のコードでは書かない見た目にして、目立たせる

「安全に使う方法」はありません。 あるのは、入れる文字列を自分が完全に管理しているかだけです。他人が入力したものを、ここに渡してはいけません。 どうしても必要なら、渡す前にサニタイズ(危険なタグを除去する処理)を通します。

この話の続きは本線にあります。 XSS が「何ができてしまうのか」と、サーバー側とヘッダ側でどう塞ぐかは、セキュリティ点検の回と防御ヘッダの回で扱っています。フロント側でエスケープしているから安全、にはなりません。


⑧ <div /> は、まだ何も描いていない

最後です。 JSX が関数呼び出しなら、その戻り値は何なのかを見ます。

src/App.jsx の App 関数の中の、return の前に1行足します。

function App() {
  console.log(<div className="a">こんにちは</div>);
  return (
    <div style={{ padding: "24px", fontFamily: "sans-serif" }}>
      <h1>返せるもの・返せないもの</h1>
      <hr />
    </div>
  );
}

ホストのブラウザで F12 を押し、Console タブを見ます。三角形をクリックして開いてください。

{$$typeof: Symbol(react.transitional.element), type: 'div', key: null, props: {…}, …}
  $$typeof: Symbol(react.transitional.element)
  type: "div"
  key: null
  props:
    className: "a"
    children: "こんにちは"

Symbol(...) の中身は React のバージョンで変わります(Symbol(react.element) と出ることもあります)。気にしなくて構いません。

読むべきはこれです。

キー中身意味
type"div"何を作るか。 文字列なら HTML、関数ならコンポーネント
props{ className, children }渡されたもの全部
keynullprops の外にある(②で見た第3引数)
$$typeofSymbol「これは本物の React 要素だ」という印

DOM はどこにもありません。 document.createElement も呼ばれていません。<div /> と書いてできたのは、「div を作ってほしい」という注文書だけです。

描くのは React の仕事です。 main.jsx にある createRoot(...).render(<App />) が、この注文書のツリーを受け取って、初めて本物の DOM を作ります。 更新のときは、前回の注文書と新しい注文書を比べて、違うところだけ本物の DOM に当てます。 これが本線のフレームワークの回で出てきた仮想DOMの実体です。

$$typeof に Symbol が使われている理由も、防御です。 Symbol は JSON に変換できません。 つまり、外部から送られてきた JSON を、そのまま React 要素だと偽って描かせることができません。 サーバーから受け取ったデータを {} にそのまま入れてしまう事故を、型の側で潰しています。

[スクリーンショット: 03_React要素の中身.png] ホストのブラウザで F12 のコンソールを開き、console.log(<div />) の結果が展開されて type: "div" と props が見えている状態を撮ってください。


つまずいたところ

変換後のコードを見ようとして、いきなり npx esbuild を打って失敗しました。 ~/reactlab を作る前、ホームディレクトリで打ったためです。

Need to install the following packages:
esbuild@0.25.0
Ok to proceed? (y)

ネットから落とそうとしています。 npx は、まず node_modules/ を探し、無ければダウンロードするという順で動きます。プロジェクトの中で打てば、既にあるものが使われます。 落としても動きはしますが、Vite が実際に使っているものと同じバージョンを見たいので、プロジェクトの中で打つべきでした。

次に、--jsx=automatic を付けずに見て、混乱しました。 出てきたのが React.createElement だったので、「自分のプロジェクトにも import React が要るのでは」と思い、App.jsx の先頭に足しました。動きはしましたが、不要でした。 esbuild の既定が classic で、Vite の React プラグインが automatic を指定している、というだけの違いです。同じ道具でも、呼び出し方が違えば出力が変わります。

0 の件は、本線を書いた時点では「そういうもの」で流していました。 深掘りで && の戻り値を確かめて、0 が特別扱いされているのではなく、false・null・undefined のほうが特別扱いされている、と向きが逆だったことに気づきました。React が描かない値のリストに 0 が入っていないだけです。

オブジェクトを返すエラーで、画面が真っ白になって焦りました。 ファイルを元に戻しても白いままだったのですが、ブラウザを再読み込みしたら戻りました。 描画中に落ちると、HMR(保存して自動反映する仕組み)では復帰しないことがあります。真っ白になったら、まずリロードです。

Fragment に key を付けようとして詰まりました。 <> key={x}> のような書き方を探しましたが、存在しません。 <> は属性を書く場所が無い省略記法なので、import { Fragment } from "react" して <Fragment key={x}> と書きます。 変換後に Fragment という変数が第1引数に入っているのを見て、これは他のコンポーネントと同じ扱いなのだと納得しました。


後片づけ

この記事で作ったものを、全部消します。 本線の ~/react-demo/ が無傷であることも確かめます。

まず、開発サーバーを止めます。 起動しているターミナルで Ctrl+C です。

bash
$ ss -tlnp | grep 5174

何も出なければ止まっています。 プロセスとサービスの回でやった通り、「止めたつもり」を確かめる手段を持っておきます。

ファイアウォールを閉じます。

bash
$ sudo ufw delete allow 5174/tcp
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
5173/tcp                   ALLOW       Anywhere

5174/tcp の行が消えていれば片づきました。 5173/tcp は本線で使うので残します。

練習用プロジェクトを消します。

bash
$ cd ~
$ rm -rf ~/reactlab
$ ls
react-demo

react-demo だけが残っていれば正解です。 rm -rf は戻せないので、打つ前にパスを声に出して読んでください。 ~/react-demo と ~/reactlab は、先頭6文字が同じです。

最後に、本線が壊れていないことを確かめます。

bash
$ cd ~/react-demo
$ npm run dev -- --host 0.0.0.0

本線のタスクリストがブラウザで動けば、何も壊していません。 確認したら Ctrl+C で止めます。


まとめ

  • JSX は構文糖衣で、変換器が関数呼び出しに書き換えている。 見るのは npx esbuild ファイル.jsx --loader=jsx。説明を読むより速い
  • 変換方式は2つある。 React.createElement を呼ぶ classic と、react/jsx-runtime を自動で読み込む automatic。Vite は automatic なので import React が要らない
  • --charset=utf8 を付けないと、日本語が \u30xx 表記になる。 壊れているわけではない
  • 属性は、第2引数のオブジェクトのキーになる。 だから class → className、for → htmlFor。2つを暗記するのではなく、1つの事実から導く
  • key だけは第3引数に出る。 props に入らないので、props.key は undefined。子でも ID が要るなら別の名前でもう1回渡す
  • {} の中に書けるのは式だけ。 if は変換の時点で構文エラーになり、React には届かない。三項演算子と && を使うのは、それが式だから
  • 返せるのは、文字列・数値・React 要素・配列・null。 オブジェクトは返せない(Objects are not valid as a React child)。new Date() をそのまま置く事故が多い
  • false / null / undefined / true は描かれない。0 は描かれる。 && は真偽値ではなく左の値をそのまま返すため。&& の左に数値を置かない
  • return が1つしか返せないから Fragment が要る。 <> は変換後に Fragment という印が第1引数に入るだけ。key を付けたいときは <Fragment> と書く
  • 大文字か小文字かだけで、変換後が「文字列」か「変数」かに分かれる。 小文字はエラーにならず、静かに何も出ない。関数はそもそも呼ばれていない
  • props はただのオブジェクト。children もその1つのキー。 {...props} はスプレッド構文そのもので、後に書いたキーが勝つ
  • dangerouslySetInnerHTML は、名前と形をわざと面倒にして事故を減らしている。 他人の入力を渡さない
  • <div /> はまだ何も描いていない。 できるのは { type, props, key } を持つ注文書のオブジェクトだけで、描くのは React

参考リンク


次に読む

この記事は 【深掘り】React の 1 / 24 本目です。

記事
← 前の記事本番のDocker Composeを組む — 決めることは8つある
→ 次の記事propsとstateの違い — pushしても画面が変わらない

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›React — JSX
  • JSXは関数呼び出しに変換される
  • 式しか書けない / 描かれる値と描かれない値

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次