ReactのFunctions are not valid警告の直し方

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

React で Functions are not valid as a React child という警告が出るのは、JSX の { } に関数をそのまま書いたためです。コンポーネントなら {Greeting} を <Greeting /> に、値を作る関数なら {formatPrice} を {formatPrice()} に直すと、警告は消えます。自作のコンポーネントを画面に置こうとしたときや、価格や日付を整形する関数の () を書き忘れたときに出ます。

私は検証環境でこの警告をわざと出し、ブラウザーのコンソールに出た文と、直したあとに消えることを確かめました。このとき、画面全体が消えることはありません。関数を書いた場所だけが空のまま、ほかの部分は表示されます。

補足

検証環境は 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 で操作して開き、DevTools の画面は、画面ありの Chromium を仮想ディスプレイ(Xvfb)で動かして撮りました。Next.js などのフレームワークの開発サーバーや、Chromium 以外のブラウザーでの表示は試していません。

コンポーネントを {Greeting} と書いたときに出たメッセージ

次のコンポーネントを開発サーバー(npm run dev と同じ vite)で開きました。Greeting はコンポーネントですが、<p> の中に <Greeting /> ではなく {Greeting} と書いています。

tsx
// まちがい:コンポーネントを <Greeting /> ではなく {Greeting} と書いている
function Greeting() {
  return <span>こんにちは、たまさん</span>;
}

export default function BadComponent() {
  return <p>{Greeting}</p>;
}

DevTools のコンソールには、次の文が出ました。

text
Functions are not valid as a React child. This may happen if you return Greeting instead of <Greeting /> from render. Or maybe you meant to call this function rather than return it.
  <p>{Greeting}</p>

1文目は「関数は React の子として使えない」という意味です。続く2文で、<Greeting /> と書くつもりで Greeting と書いたのではないか、または関数を呼ぶつもりだったのではないか、と原因の見当を2つ挙げています。

最後の行の <p>{Greeting}</p> は、どこに何を書いてしまったかを表しています。Greeting は書いてしまった関数の名前、p はその関数を入れようとした要素です。メッセージの文そのものにはファイル名や行番号は入っていませんが、この2つの名前で探せば、書いた場所はすぐに見つかります。

DevTools のコンソールに、赤い行で「Functions are not valid as a React child. This may happen if you return Greeting instead of <Greeting /> from render.」から始まる文と「<p>{Greeting}</p>」が出ている。上のページの部分には何も表示されていない
{Greeting} と書いたページを開いたところ。p の中は空で、コンソールに赤い行が1件出た

コンソールでは、黄色い警告ではなく赤いエラーの行として出ます。react-dom 19.3.1 の開発用ビルドのコードを見ると、この文は console.error で出していました。ただ、エラーを投げてはいないので、描画は止まりません。ページの中身を調べると <p></p> があり、関数を書いた場所が空になっていただけでした。

関数の () を書き忘れたときも、同じ警告になる

コンポーネントでない、ふつうの関数でも同じです。次の formatPrice は文字列を返す関数ですが、() を付けずに書いています。

tsx
// まちがい:関数を呼ばずに {formatPrice} と書いている
const price = 1280;
const formatPrice = () => `${price.toLocaleString('ja-JP')}円`;

export default function BadCall() {
  return <p>価格: {formatPrice}</p>;
}
text
Functions are not valid as a React child. This may happen if you return formatPrice instead of <formatPrice /> from render. Or maybe you meant to call this function rather than return it.
  <p>{formatPrice}</p>

画面には 価格: までが表示され、金額だけが抜けていました。エラーで画面が消えるわけではないので、コンソールを開かないと、表示が欠けていることに気づきにくい場面です。

formatPrice はコンポーネントではないので、文の中の <formatPrice /> という案は当てはまりません。合うのは、もう1つの「関数を呼ぶつもりだったのでは」のほうです。

その場で書いたアロー関数では、名前が children になる

map の結果を、うっかりアロー関数で包んで書いた場合も試しました。

tsx
// まちがい:その場で書いたアロー関数を、呼ばずに JSX に入れている
const items = ['ごはん', 'おやつ'];

export default function BadInline() {
  return <ul>{() => items.map((item) => <li key={item}>{item}</li>)}</ul>;
}
text
Functions are not valid as a React child. This may happen if you return children instead of <children /> from render. Or maybe you meant to call this function rather than return it.
  <ul>{children}</ul>

関数に名前がないので、メッセージには children と出ました。開発サーバーが変換したあとのコードを見ると、この関数は _jsxDEV("ul", { children: () => ... }) のように、オブジェクトの children プロパティに入っていました。MDN の Function.name の説明にあるとおり、名前のない関数をオブジェクトのプロパティに書くと、プロパティ名がその関数の名前(name)になります。React はこの名前を表示していました。

{children} と出たときは、<ul> のように最後の行に出た要素の中で、() => から始まる関数を { } に書いていないかを探します。

タグで書くか、呼んで戻り値を書くと消える

公式ドキュメントにある、React ノードとして返せるものの一覧には、<div /> のような React 要素、文字列、数値、true・false・null・undefined(何も表示されない)、それらの配列などが並んでいます。関数は入っていません。そこで、関数をこの一覧にある値に変えてから書きます。

コンポーネントは、公式チュートリアルのコンポーネントを使う例と同じように、タグとして書きます。

tsx
// 直したもの:コンポーネントは JSX のタグとして書く
function Greeting() {
  return <span>こんにちは、たまさん</span>;
}

export default function GoodComponent() {
  return (
    <p>
      <Greeting />
    </p>
  );
}

値を作る関数は、() を付けて呼び、戻り値の文字列を書きます。

tsx
// 直したもの:関数を呼んで、戻り値の文字列を書く
const price = 1280;
const formatPrice = () => `${price.toLocaleString('ja-JP')}円`;

export default function GoodCall() {
  return <p>価格: {formatPrice()}</p>;
}

アロー関数で包んでいたものは、包まずに map の結果(要素の配列)をそのまま書きます。

tsx
// 直したもの:関数で包まず、map の結果(要素の配列)をそのまま書く
const items = ['ごはん', 'おやつ'];

export default function GoodInline() {
  return (
    <ul>
      {items.map((item) => (
        <li key={item}>{item}</li>
      ))}
    </ul>
  );
}

直した3つのページを同じ開発サーバーで開くと、コンソールに警告は出ませんでした。画面には、それぞれ こんにちは、たまさん、価格: 1,280円、ごはん・おやつ の2行が表示されました。

直したページに「こんにちは、たまさん」と表示されている。下の DevTools のコンソールには、React DevTools の案内の1行だけが出ている
<Greeting /> に直したページを開いたところ。赤い行は出ていない

コンソールに残っている1行は、React DevTools の案内です。警告とは関係なく、直す前のページにも出ていました。

TypeScript の型チェックでは、開く前に見つかる

ここまでの3つのまちがいは、どれも型チェックで見つかりました。検証用のプロジェクトで npx tsc -p tsconfig.app.json --noEmit を実行した結果です。

text
src/BadCall.tsx(6,18): error TS2322: Type '() => string' is not assignable to type 'ReactNode'.
src/BadComponent.tsx(7,14): error TS2322: Type '() => Element' is not assignable to type 'ReactNode'.
src/BadInline.tsx(5,15): error TS2322: Type '() => React.JSX.Element[]' is not assignable to type 'ReactNode'.

JSX の { } に書ける型(ReactNode)に、関数の型は入らない、という意味です。ブラウザーのメッセージとちがって、ファイル名と行・列が出ます。テンプレートの npm run build は最初に tsc を実行するので、このまま本番用のビルドに進むこともありません。

ただし、Vite のドキュメントにあるとおり、開発サーバーは型チェックをしません。エディターで型エラーを見落とすと、さきほどのように画面を開けてしまいます。テンプレートに入っている lint ツールの oxlint も、設定はそのままで npx oxlint src を実行したところ、どのファイルにも何も出しませんでした。

注意

型チェックを飛ばして npx vite build だけで本番用にビルドし、npx vite preview で開くと、3つのまちがったページのどれでも、コンソールには何も出ませんでした。関数を書いた場所が空になるだけです。本番のサイトで表示が一部だけ抜けているときは、コンソールを見ても手がかりがないので、開発サーバーで開き直して警告を確かめます。

​Posted by 86