useState([])のnever型エラーをTypeScriptで直す
React で、一覧に表示するデータを入れる state を useState([]) と空の配列から始めると、TypeScript が error TS2339: Property 'id' does not exist on type 'never'. を出すことがあります。原因は、空の配列からは要素の型が分からず、state の型が never[](何も入れられない配列)になることです。useState<Todo[]>([]) のように、要素の型を型引数で書くとエラーは消えます。
API から取得したデータを入れる state のように、空の配列から始めて、あとで中身を入れる state で起きます。私は検証環境で tsc と TypeScript の言語サーバーの両方でこのエラーを起こし、メッセージの全文と、型を付けると消えることを確かめました。
検証環境は Ubuntu 24.04、Node.js 22.23.4 です。TypeScript 7.0.2、React 19.3.1、@types/react 19.3.0 を使い、比べるために TypeScript 5.9.3 でも同じファイルを tsc にかけました。tsconfig.json は npx tsc --init で作ったもの("strict": true が入っています)です。エディターに出るエラーは、VS Code などのエディター本体ではなく、TypeScript 7 の言語サーバー(tsc --lsp --stdio)を直接動かして確かめました。エディターの画面での見え方、ブラウザで動かしたときの表示は試していません。
エラーの全文
src/TodoList.tsx に、受け取った ToDo の配列をボタンで state に読み込み、一覧に表示するコンポーネントを書きました。state は useState([]) で、型を付けずに空の配列から始めています。
import { useState } from "react";
type Todo = { id: number; title: string };
export function TodoList({ initial }: { initial: Todo[] }) {
const [todos, setTodos] = useState([]);
function load() {
setTodos(initial);
}
return (
<>
<button onClick={load}>読み込む</button>
<ul>
{todos.map((todo) => (
<li key={todo.id}>{todo.title}</li>
))}
</ul>
</>
);
}
npx tsc --noEmit を実行すると、次のように出ました(終了コードは1)。
src/TodoList.tsx(9,14): error TS2345: Argument of type 'Todo[]' is not assignable to parameter of type 'SetStateAction<never[]>'.
Type 'Todo[]' is not assignable to type 'never[]'.
Type 'Todo' is not assignable to type 'never'.
src/TodoList.tsx(17,25): error TS2339: Property 'id' does not exist on type 'never'.
src/TodoList.tsx(17,35): error TS2339: Property 'title' does not exist on type 'never'.
エラーは2種類あります。TS2339 は「never 型には id(title)というプロパティはない」という意味で、todo.id と todo.title の行に出ています。TS2345 は「Todo[] を、SetStateAction<never[]> を受け取る引数には渡せない」という意味で、setTodos(initial) の行に出ています。
--pretty を付けると、波線で場所が示されます(色を付けるための制御文字は消し、最後の集計の行は省いています)。
src/TodoList.tsx:9:14 - error TS2345: Argument of type 'Todo[]' is not assignable to parameter of type 'SetStateAction<never[]>'.
Type 'Todo[]' is not assignable to type 'never[]'.
Type 'Todo' is not assignable to type 'never'.
9 setTodos(initial);
~~~~~~~
src/TodoList.tsx:17:25 - error TS2339: Property 'id' does not exist on type 'never'.
17 <li key={todo.id}>{todo.title}</li>
~~
src/TodoList.tsx:17:35 - error TS2339: Property 'title' does not exist on type 'never'.
17 <li key={todo.id}>{todo.title}</li>
~~~~~
どちらのエラーも、場所は state を使っている行です。けれども原因は、6行目の useState([]) にあります。
言語サーバーでも同じ3件が出る
TypeScript 7 の tsc は、--lsp --stdio を付けると言語サーバーとして動きます(検証環境で起動して確かめました)。TypeScript 7 の移植に使われた typescript-go リポジトリの README には、LSP の言語サービスと、VS Code のプレビュー版の拡張機能のことが書かれています。TypeScript 7.0.2 の言語サーバーを tsc --lsp --stdio で起動し、LSP の手順で src/TodoList.tsx を開かせました。返ってきた診断と、todos と todo の位置を指定して返してもらった型の情報(ホバー)は次のとおりです。返ってきた JSON を、私が書いた小さなスクリプトで1件ずつ並べて表示しています。ホバーを見る位置を変えて2回実行し、2回とも同じだった診断と server の行は1回分だけ載せています。
server: typescript-go 7.0.2
diagnostics (3):
9:14-9:21 severity=1 source=ts code=2345 Argument of type 'Todo[]' is not assignable to parameter of type 'SetStateAction<never[]>'.
Type 'Todo[]' is not assignable to type 'never[]'.
Type 'Todo' is not assignable to type 'never'.
17:25-17:27 severity=1 source=ts code=2339 Property 'id' does not exist on type 'never'.
17:35-17:40 severity=1 source=ts code=2339 Property 'title' does not exist on type 'never'.
hover 6:10: const todos: never[]
hover 16:21: (parameter) todo: never
severity=1 は、LSP の仕様でエラーを表す値です。メッセージの文面は tsc と同じでした。ホバーでは、useState の行の todos の型が never[]、map に渡した関数の引数 todo の型が never になっています。
空の配列から型を決めると never[] になる
useState の型は、@types/react では次のように定義されています(検証環境の node_modules/@types/react/index.d.ts から写しました)。
function useState<S>(initialState: S | (() => S)): [S, Dispatch<SetStateAction<S>>];
state の型 S は、型引数を書かなければ、初期値から決まります。TypeScript のハンドブックにあるジェネリクスの説明(英語)では、これを型引数の推論(type argument inference)と呼んでいます。React の公式ドキュメントにある、TypeScript で useState に型を付ける説明(英語)でも、useState(false) なら boolean 型になる、という例が載っています。
初期値が [] だと、要素が1つもないので、要素の型の手がかりがありません。検証環境の "strict": true の設定では、このとき S は never[] になりました。never は、決して現れない値を表す型です(ハンドブックの never の説明(英語))。要素が never なので、どのプロパティを読んでも TS2339 になり、Todo[] を入れようとしても TS2345 になります。
React を使わなくても同じことが起きます。比べるために、空の配列を変数に入れる場合と、受け取った値をそのまま返すジェネリクスの関数 keep に空の配列を渡す場合を書きました。
function keep<T>(value: T): T {
return value;
}
const list = [];
list.push({ id: 1 });
const kept = keep([]);
kept.push({ id: 1 });
tsc では、kept.push の行だけが error TS2345: Argument of type '{ id: number; }' is not assignable to parameter of type 'never'. になりました。ホバーの型は、list が any[]、kept が never[] でした。const list = [] のように変数に入れたときはエラーになりませんが、型引数を推論するジェネリクスの関数に [] を渡したときは、useState と同じく never[] に決まります。
useState に要素の型を書くと消える
直し方は、6行目の useState に、型引数で state の型を書くことです。
- const [todos, setTodos] = useState([]);
+ const [todos, setTodos] = useState<Todo[]>([]);
この1行だけを変えて npx tsc --noEmit を実行すると、何も出ずに終了コード0で終わりました。言語サーバーの診断も0件になり、ホバーの型は次のように変わりました(前と同じく2回の実行をまとめ、server の行は省いています)。
diagnostics (0):
hover 6:10: const todos: Todo[]
hover 16:21: (parameter) todo: Todo
TypeScript 5.9.3 でも、直す前のファイルでは同じ3件のエラーが同じ文面で出て、直したファイルではエラーは出ませんでした。ただし、エラーのときの tsc の終了コードは、5.9.3 では 2、7.0.2 では 1 でした。
型を書いたあとは、プロパティ名の書き間違いも見つかります。todo.title を todo.titel と書き間違えたファイルを tsc にかけると、次のエラーになりました。
src/TodoList.tsx(17,35): error TS2551: Property 'titel' does not exist on type 'Todo'. Did you mean 'title'?
strictNullChecks を切ると、エラーは消えるが any[] になる
tsc --init で作った設定で strictNullChecks を無効にすると(exactOptionalPropertyTypes は strictNullChecks なしでは指定できず TS5052 のエラーになるので、これも無効にしました)、直す前のファイルでもエラーは出なくなりました。このとき、言語サーバーのホバーでは todos の型が any[] でした。
any[] では、要素のプロパティを読んでも型のチェックが働きません。同じ設定で todo.title を todo.titel に書き間違えたファイルも、tsc ではエラーになりませんでした。エラーを消すために設定を緩めるのではなく、useState<Todo[]>([]) と型を書いてください。
never のエラーが state を使う行に出たときは、その変数をたどって、state を作った行で、変数の型が never[] になっていないかを確かめると、直す場所が分かります。





