useState([])のnever型エラーをTypeScriptで直す

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

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([]) で、型を付けずに空の配列から始めています。

tsx
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)。

text
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 を付けると、波線で場所が示されます(色を付けるための制御文字は消し、最後の集計の行は省いています)。

text
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回分だけ載せています。

text
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 から写しました)。

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 に空の配列を渡す場合を書きました。

ts
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 の型を書くことです。

diff
-  const [todos, setTodos] = useState([]);
+  const [todos, setTodos] = useState<Todo[]>([]);

この1行だけを変えて npx tsc --noEmit を実行すると、何も出ずに終了コード0で終わりました。言語サーバーの診断も0件になり、ホバーの型は次のように変わりました(前と同じく2回の実行をまとめ、server の行は省いています)。

text
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 にかけると、次のエラーになりました。

text
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[] になっていないかを確かめると、直す場所が分かります。

​Posted by 86