ReactのObjects are not validエラーの直し方

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

React で Objects are not valid as a React child というエラーが出るのは、オブジェクトや Date を、JSX の { } にそのまま書いたためです。{user} を {user.name} に、{updatedAt} を {updatedAt.toLocaleString('ja-JP')} に変えて、文字列や数値にしてから書くと、エラーは消えます。API から取ってきたユーザー情報や、記事の更新日時を画面に出す場面で、オブジェクトや Date をそのまま書くと出ます。

私は検証環境でこのエラーをわざと起こし、ブラウザーのコンソールに出た文と、直したあとに消えることを確かめました。まちがった3つの書き方(オブジェクト、Date、JSON.parse の結果)では、どれもページを開いただけで画面が真っ白になりました。

補足

検証環境は 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 以外のブラウザーでの表示は試していません。

オブジェクトを書いたときに出たメッセージ

次のコンポーネントを開発サーバー(npm run dev と同じ vite)で開くと、すぐにエラーになりました。user はオブジェクトで、それを <p> の中に {user} と書いています。

tsx
// まちがい:オブジェクトをそのまま JSX に書いている
const user = { name: 'たま', age: 3 };

export default function BadObject() {
  return <p>ユーザー: {user}</p>;
}

DevTools のコンソールに出たエラーは、次のとおりです。

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

かっこの中の found: のあとに、書いてしまった値の中身が出ます。普通のオブジェクトのときは、object with keys {name, age} のように、持っているキーの名前が並びます。ここを見れば、どんな値を書いてしまったのか見当がつきます。

エラーに続いて、警告も1件出ました。

text
An error occurred in the <p> component.

Consider adding an error boundary to your tree to customize error handling behavior.
Visit https://react.dev/link/error-boundaries to learn more about error boundaries.

警告に出るのは、オブジェクトを書いたコンポーネントの名前(BadObject)ではなく、オブジェクトを中に入れようとした要素の <p> でした。

ページのほうには、エラーの文は出ませんでした。コンポーネントを入れる <div id="root"> の中が空になり、画面は真っ白です。エラーの文を見るには、DevTools のコンソールを開く必要があります。

Date を書いたときは found: [object Date] になる

Date も、JSX の中ではオブジェクトとして扱われます。次のコンポーネントを開くと、同じエラーになりました。

tsx
// まちがい:Date をそのまま JSX に書いている
const updatedAt = new Date(2026, 10, 11, 9, 30);

export default function BadDate() {
  return <p>更新日時: {updatedAt}</p>;
}
text
Uncaught Error: Objects are not valid as a React child (found: [object Date]). If you meant to render a collection of children, use an array instead.

今度は found: のあとが [object Date] です。react-dom 19.3.1 の開発用ビルドのコードを見ると、値を Object.prototype.toString で調べ、普通のオブジェクト([object Object])ならキーの一覧を、それ以外なら [object Date] のような調べた結果をそのまま入れていました。

DevTools のコンソールに、赤い行で「Uncaught Error: Objects are not valid as a React child (found: [object Date]).」、黄色い行で「An error occurred in the <p> component.」が出ている。上のページの部分は何も表示されていない
Date をそのまま書いたページを開いたところ。ページは真っ白で、コンソールにエラーと警告が1件ずつ出た

JSX の { } に書けるのは、文字列や数値などに限られる

公式ドキュメントにある、React ノードとして返せるものの一覧には、<div /> のような React 要素、文字列、数値、true・false・null・undefined(何も表示されない)、それらの配列などが並んでいます。普通のオブジェクトや Date は入っていません。

JSX の波かっこについての公式チュートリアルの練習問題でも、{person} と書いてこのエラーになる例が出てきます。オブジェクトをどう表示したいのか React には分からないのでエラーになる、と説明し、{person.name} に直しています。

文字列や数値にして書くと、エラーが消える

オブジェクトのときは、表示したいプロパティを取り出して書きます。

tsx
// 直したもの:オブジェクトの中の、文字列や数値のプロパティを書く
const user = { name: 'たま', age: 3 };

export default function GoodObject() {
  return (
    <p>
      ユーザー: {user.name}({user.age}歳)
    </p>
  );
}

Date のときは、toLocaleString などで文字列にしてから書きます。

tsx
// 直したもの:Date を文字列に変えてから書く
const updatedAt = new Date(2026, 10, 11, 9, 30);

export default function GoodDate() {
  return <p>更新日時: {updatedAt.toLocaleString('ja-JP')}</p>;
}

直した2つのページを同じ開発サーバーで開くと、コンソールにはエラーも警告も出ませんでした。画面には、それぞれ ユーザー: たま(3歳)、更新日時: 2026/11/11 9:30:00 と表示されました。

直したページに「更新日時: 2026/11/11 9:30:00」と表示されている。下の DevTools のコンソールには、React DevTools の案内の1行だけが出ている
Date を文字列にしたページを開いたところ。エラーは出ていない

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

TypeScript なら開く前に見つかるが、any の値は見つからない

TypeScript で書いていれば、オブジェクトや Date を JSX に書いた時点で型チェックのエラーになります。検証用のプロジェクトで npx tsc -p tsconfig.app.json --noEmit を実行すると、次のエラーが出ました。

text
src/BadDate.tsx(5,19): error TS2322: Type 'Date' is not assignable to type 'ReactNode'.
src/BadObject.tsx(5,19): error TS2322: Type '{ name: string; age: number; }' is not assignable to type 'ReactNode'.

JSX の { } に書ける型(ReactNode)に、Date やこのオブジェクトの型は入らない、という意味です。テンプレートの npm run build は最初に tsc を実行するので、このまま本番用のビルドに進むこともありません。ただし、Vite のドキュメントにあるとおり、開発サーバーは型チェックをしないため、さきほどのようにそのまま画面を開けてしまいます。

型チェックで見つからないのは、値の型が any のときです。JSON.parse の戻り値は any なので、次のコンポーネントは tsc でエラーになりませんでした。テンプレートに入っている lint ツールの oxlint も、設定はそのままで npx oxlint src を実行したところ、どのファイルにも何も出しませんでした。

tsx
// まちがい:JSON.parse の結果(型は any)をそのまま JSX に書いている
const user = JSON.parse('{"name":"たま","age":3}');

export default function BadJson() {
  return <p>ユーザー: {user}</p>;
}

このページを開くと、オブジェクトを書いたときと同じ found: object with keys {name, age} のエラーになり、画面は真っ白でした。JSON.parse の結果のように型が any の値は、tsc でもテンプレートの oxlint でも見つからず、ページを開くまでこのエラーに気づけませんでした。

本番用のビルドでは、番号だけのエラーになる

型チェックを飛ばして npx vite build だけで本番用にビルドし、npx vite preview で開くと、DevTools のコンソールに出るエラーは次のように変わりました。Date を書いたページの例です。ページが真っ白になるのは開発中と同じで、警告は出ませんでした。

text
Uncaught Error: Minified React error #31; visit https://react.dev/errors/31?args[]=%5Bobject%20Date%5D for the full message or use the non-minified dev environment for full errors and additional helpful warnings.

オブジェクトを書いたページでは、URL の末尾が args[]=object%20with%20keys%20%7Bname%2C%20age%7D になりました。found: のあとに入る値が、URL の args[]= のあとに URL エンコードされて付いています。

React のリポジトリにある、エラー番号と文の対応表では、31 番は Objects are not valid as a React child (found: %s). If you meant to render a collection of children, use an array instead. です。公開中のサイトで #31 が出ていたら、このエラーと同じものです。URL の args[]= のあとを読めば、どんな値を書いてしまったのかも分かります。

​Posted by 86