Reactの&&で条件付き表示をすると0が出る原因と直し方

​​React​JavaScript,TypeScript,トラブルシュート

React で {count && <p>…</p>} と書くと、count が 0 のときに、何も出ないはずの場所へ「0」が表示されます。&& が左側の 0 をそのまま返し、React は数値の 0 を文字として画面に出すためです。{count > 0 && <p>…</p>} のように、左側を true か false になる式にすると直ります。未読件数のバッジ、検索結果の件数、一覧が空かどうかで表示を切り替える場面で起きやすいまちがいで、公式ドキュメントでも「よくある間違い」として取り上げられています。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4 です。npm create vite@latest の react-ts テンプレートで作ったプロジェクト(react / react-dom 19.3.1、Vite 8.3.8、TypeScript 7.0.2、oxlint 1.93.0)で、コンポーネントを StrictMode で囲んで試しました。ページは開発サーバーで開き、Chromium 153 を Playwright 1.63.0 で操作して表示を確かめました。React Native や、Chromium 以外のブラウザでの表示は試していません。

未読が0件のとき、見出しの下に「0」だけが出る

次の2つのコンポーネントを用意しました。1つ目は未読の件数があるときだけメッセージを出すもの、2つ目はやることの一覧が空でないときだけリストを出すものです。

tsx
// まちがい:count が 0 のとき、&& の左側の 0 がそのまま表示される
type Props = { count: number };

export default function UnreadBadge({ count }: Props) {
  return (
    <div>
      <h2>受信箱</h2>
      {count && <p>未読が {count} 件あります</p>}
    </div>
  );
}
tsx
// まちがい:配列が空のとき、items.length の 0 が表示される
type Props = { items: string[] };

export default function TodoList({ items }: Props) {
  return (
    <div>
      <h2>やること</h2>
      {items.length && (
        <ul>
          {items.map((item) => (
            <li key={item}>{item}</li>
          ))}
        </ul>
      )}
    </div>
  );
}

<UnreadBadge count={0} /> と <TodoList items={[]} /> を開発サーバーで開くと、どちらの見出しの下にも「0」が表示されました。

「受信箱」と「やること」の2つの見出しの下に、それぞれ「0」とだけ表示されている
count が 0、items が空の配列のときの画面。見出しの下に 0 が出ている

ページの中身を調べると、次のようになっていました。<p> も <ul> も作られず、0 という文字だけが <div> の中に入っています。

html
<div><h2>受信箱</h2>0</div><div><h2>やること</h2>0</div>

このとき、ブラウザのコンソールに警告やエラーは出ませんでした。数値は React が表示できる値なので、React は警告を出しません。また、同じコンポーネントを count={3}、items={['ごはん', 'おやつ']} で renderToString に通すと、「未読が 3 件あります」と2行のリストが期待どおりに出ました。件数があるときは正しく見えるので、0件のときを画面で確かめるまで気づきにくいまちがいです。

&& は、左側が偽のときに左側の値を返す

MDN の論理積演算子(&&)の説明にあるとおり、a && b は a が偽とみなされる値(falsy)なら a そのものを返し、そうでなければ b を返します。true か false を返す演算子ではありません。0 は偽とみなされるので、count && <p>…</p> は count が 0 のとき、false ではなく 0 になります。

一方、React は false・null・undefined(true も)を画面に何も表示しません。公式ドキュメントの条件付きレンダーの説明でも、false は null や undefined と同じように何もレンダーしない、と書かれています。数値はReact が表示できる値(React ノード)の1つなので、0 は文字として出ます。同じ説明の中で、公式ドキュメントも「&& の左辺に数値を置かない」と注意しています。

左側に置いた値ごとに、<div>{値 && <p>表示</p>}</div> が何になるかを renderToString で調べました。

&& の左側 表示されたもの
0 0
-0 0
0n(BigInt の 0) 0
NaN NaN
''(空文字列) 何も出ない
false・null・undefined 何も出ない
0 > 0・!!0・Boolean(0) 何も出ない

偽とみなされる値のうち、数値の 0、-0、NaN と BigInt の 0n は文字として出ました。NaN のときは、Received NaN for the `children` attribute. という警告も出ました。空文字列は偽とみなされて左側が返りますが、空の文字なので画面には何も出ません。

左側を true / false にして直す

左側を、true か false になる式に変えます。件数なら「0より大きいか」を比べると、読みやすくなります。

tsx
// 直したもの:&& の左側を、比べた結果の true / false にする
type Props = { count: number };

export default function UnreadBadgeFixed({ count }: Props) {
  return (
    <div>
      <h2>受信箱</h2>
      {count > 0 && <p>未読が {count} 件あります</p>}
    </div>
  );
}

上の表のとおり、!!count や Boolean(count) と書いても 0 は出ません。ただ、count > 0 のほうが「件数が1以上のとき」という意図がコードから読み取れます。

一覧が空のときに「やることはありません」のような案内を出したいなら、&& ではなく三項演算子で、空のときの表示も書きます。

tsx
// 直したもの:空のときに出す内容を、三項演算子で書き分ける
type Props = { items: string[] };

export default function TodoListFixed({ items }: Props) {
  return (
    <div>
      <h2>やること</h2>
      {items.length > 0 ? (
        <ul>
          {items.map((item) => (
            <li key={item}>{item}</li>
          ))}
        </ul>
      ) : (
        <p>やることはありません</p>
      )}
    </div>
  );
}

同じく count={0}、items={[]} で開くと、「受信箱」の下には何も出なくなり、「やること」の下には案内の文が出ました。

「受信箱」の見出しの下には何もなく、「やること」の見出しの下に「やることはありません」と表示されている
直したあとの画面。0 は出ず、空の一覧には案内の文が出ている

テンプレートのままの型チェックとlintでは見つからない

まちがったままのコードで npx tsc -p tsconfig.app.json --noEmit を実行しても、エラーは出ませんでした。count && <p>…</p> の型は「数値か JSX の要素」で、検証環境の @types/react 19.3.0 にある JSX の { } に書ける型(ReactNode)の定義には、どちらも入っているからです。テンプレートに入っている oxlint も、設定はそのままで npx oxlint src を実行したところ、何も出しませんでした。

テンプレートの設定のままでは、型チェックもlintも通り、コンソールにも何も出ないので、画面を見るまで気づけません。&& の左側に件数や length を書いている箇所は、件数が 0 のときの画面を開いて確かめるか、はじめから > 0 を付けて書いておくのが確実です。

​Posted by 86