ホーム>React>React×TypeScriptの書き方:props・useState・イベントの型と、実際に出る型エラー(React 19・TypeScript 7で確認)
React

React×TypeScriptの書き方:props・useState・イベントの型と、実際に出る型エラー(React 19・TypeScript 7で確認)

いつもご利用ありがとうございます。
この記事にはアフィリエイト広告を含む広告が掲載されており、その広告費によって運営しています。
Amazonのアソシエイトとして、ララテックは適格販売により収入を得ています。

ReactをTypeScriptで書く方法を、Viteのreact-tsテンプレートで作ったプロジェクトでまとめました。props・children・useState・useRef・イベント(ChangeEvent・FormEvent)の型の書き方と、型を間違えたときにtscが出すエラー文、npm run buildは止まるのにvite buildと開発サーバーは通る違いを、React 19.3・TypeScript 7.0で実際に動かした結果つきで書いています。

React は TypeScript でも書けます。

ファイルの拡張子を .tsx にして、props や state に型を付けると、渡し間違いを動かす前に tsc が教えてくれます。

この記事では、Vite の React + TypeScript のテンプレートでプロジェクトを作り、よく使う型の書き方と、わざと間違えたときに実際に出るエラー文を並べました。

「型って何を書けばいいの?」という人が、最初に覚える分だけに絞っています。

⇨ React 記事の目次はこちら

確かめた環境

2026年11月に、Docker の node:22 のコンテナで確かめました。

Node.js 22.23.5
react 19.3.1 / react-dom 19.3.1
@types/react 19.3.0 / @types/react-dom 19.3.0
typescript 7.0.2
vite 8.3.8
@vitejs/plugin-react 6.3.0

画面の確認は Chromium 156 です。

react-ts のテンプレートでプロジェクトを作る

Vite のテンプレートに react-ts を指定すると、最初から TypeScript の設定が入った React のプロジェクトができます。

npm create vite@latest my-ts-app -- --template react-ts
cd my-ts-app
npm install

できたファイルはこうなりました。

README.md
index.html
package.json
public
src
tsconfig.app.json
tsconfig.json
tsconfig.node.json
vite.config.ts

src の中は App.tsx・main.tsx で、JavaScript のテンプレートの .jsx が .tsx になっています。

package.json はこうでした。

{
  "scripts": {
    "dev": "vite",
    "build": "tsc -b && vite build",
    "lint": "oxlint",
    "preview": "vite preview"
  },
  "dependencies": {
    "react": "^19.3.1",
    "react-dom": "^19.3.1"
  },
  "devDependencies": {
    "@types/node": "^24.19.2",
    "@types/react": "^19.3.0",
    "@types/react-dom": "^19.3.0",
    "@vitejs/plugin-react": "^6.1.2",
    "oxlint": "^1.90.0",
    "typescript": "~7.0.2",
    "vite": "^8.3.6"
  }
}

React の型は @types/react・@types/react-dom から来ています。

build が tsc -b && vite build になっているのがポイントで、これは後の「npm run build だけが型エラーで止まる」で確かめます。

入っていた TypeScript は 7.0.2 でした。

tsconfig.app.json には strict が書かれていませんが、後で見るとおり implicitly has an 'any' type や possibly 'null' のエラーが出たので、strict のチェックは有効になっていました。

props の型を書く

props は type で形を決めて、引数の分割代入に付けます。

省略できる props は ? を付け、既定値は分割代入の = で書きます。

// src/Greeting.tsx
import type { ReactNode } from 'react'

type GreetingProps = {
  name: string
  age?: number
  children?: ReactNode
}

export function Greeting({ name, age = 20, children }: GreetingProps) {
  return (
    <div>
      <p>
        こんにちは、{name}さん({age}歳)
      </p>
      {children}
    </div>
  )
}

children には、JSX・文字列・数値・null などをまとめて表す ReactNode を使います。

テンプレートの tsconfig は verbatimModuleSyntax が有効なので、型だけを読み込むときは import type と書きます。

呼び出す側はこうです。

<Greeting name="ララ" />
<Greeting name="テック" age={30}>
  <p>children も渡せます</p>
</Greeting>

props を間違えたときのエラー

わざと間違えた呼び出しを書いて、tsc にかけました(以下のエラーは --pretty false で出したものです)。

<Greeting />
<Greeting name="ララ" age="30" />
bad/Bad.tsx(27,8): error TS2741: Property 'name' is missing in type '{}' but required in type 'GreetingProps'.
bad/Bad.tsx(28,27): error TS2322: Type 'string' is not assignable to type 'number'.

必須の name がないことと、age に文字列の "30" を渡したことを、どちらも行と列つきで教えてくれました。

数値を渡すときは age={30} のように {} で囲みます。

button の props をそのまま受け取る

自作のボタンで、onClick や type など button の props を全部受け取りたいときは、ComponentProps<'button'> に自分の props を足せます。

// src/Button.tsx
import type { ComponentProps } from 'react'

type ButtonProps = ComponentProps<'button'> & {
  variant: 'primary' | 'secondary'
}

export function Button({ variant, ...rest }: ButtonProps) {
  return <button className={`btn btn-${variant}`} {...rest} />
}

variant を 'primary' | 'secondary' のどちらかに絞ったので、それ以外の文字列はエラーになりました。

<Button variant="danger">削除</Button>
bad/Bad.tsx(30,15): error TS2322: Type '"danger"' is not assignable to type '"primary" | "secondary"'.

useState・useRef・イベントの型

state やイベントに型を付けたフォームの例です。

// src/UserForm.tsx
import { useRef, useState, type ChangeEvent, type FormEvent } from 'react'

type User = {
  id: number
  name: string
}

export function UserForm() {
  const [name, setName] = useState('')
  const [user, setUser] = useState<User | null>(null)
  const [tags, setTags] = useState<string[]>([])
  const inputRef = useRef<HTMLInputElement>(null)

  const handleChange = (e: ChangeEvent<HTMLInputElement>) => {
    setName(e.target.value)
  }

  const handleSubmit = (e: FormEvent<HTMLFormElement>) => {
    e.preventDefault()
    setUser({ id: 1, name })
    setTags([...tags, name])
    inputRef.current?.focus()
  }

  return (
    <form onSubmit={handleSubmit}>
      <input ref={inputRef} value={name} onChange={handleChange} aria-label="名前" />
      <button type="submit">登録</button>
      <p>登録したユーザー: {user ? user.name : 'まだいません'}</p>
      <p>タグ: {tags.join(', ')}</p>
    </form>
  )
}

名前を入力して「登録」を押した後の画面です。

名前の入力欄に「ララテック」と入っていて、その下に「登録したユーザー: ララテック」「タグ: ララテック」と表示されている画面。上には Greeting コンポーネントの「こんにちは、ララさん(20歳)」「こんにちは、テックさん(30歳)」も出ている

このコードは npm run build(tsc -b を含む)がエラーなしで通りました。

型を書いたのは、次の4か所だけです。

  • useState('') は初期値から string と分かるので、型は書いていない
  • 最初は null で後からオブジェクトが入る state は useState<User | null>(null) と書く
  • 空の配列で始める state は useState<string[]>([]) と書く
  • DOM を指す ref は useRef<HTMLInputElement>(null)、イベントは ChangeEvent<HTMLInputElement>・FormEvent<HTMLFormElement>

型を書かないと何が起きる?

型を省いたり間違えたりしたコードも tsc にかけました。

const [count, setCount] = useState(0)
const [list, setList] = useState([])
const [user] = useState<User | null>(null)

const handleChange = (e: ChangeEvent<HTMLInputElement>) => {
  setCount(e.target.value)
}

const handleClick = (e) => {
  console.log(e)
}

setList(['a'])

// JSX の中
<p>{user.name}</p>
bad/Bad.tsx(16,14): error TS2345: Argument of type 'string' is not assignable to parameter of type 'SetStateAction<number>'.
bad/Bad.tsx(19,24): error TS7006: Parameter 'e' implicitly has an 'any' type.
bad/Bad.tsx(23,12): error TS2322: Type 'string' is not assignable to type 'never'.
bad/Bad.tsx(29,11): error TS18047: 'user' is possibly 'null'.

1つ目は、数値の state に input の値(文字列)を入れようとしたエラーです。

input の値は文字列なので、数値にしたいときは変換が要ります(下で確かめています)。

2つ目は、イベントの引数 e に型がないエラーです。

(e: MouseEvent<HTMLButtonElement>) => ... のように型を書くか、onClick={(e) => console.log(e.currentTarget.textContent)} と JSX の中に直接書けば、どちらも tsc -b がエラーなしで通りました(JSX の中に書くと、e の型は推論されます)。

onChange={(e) => setCount(Number(e.target.value))} のように、文字列を Number() で変換して数値の state に入れる書き方も通りました。

3つ目が一番ハマりやすいところで、useState([]) と型なしで空の配列を渡すと、配列の中身が never になり、何も入れられなくなりました。

空の配列や null で始める state は、useState<string[]>([]) のように型を書きます。

4つ目は、null かもしれない値のプロパティを読もうとしたエラーです。

user ? user.name : ... や user?.name のように、null のときを先に分けると消えました。

この4つを見ると、「初期値から分かるものは書かない、分からないものだけ書く」で十分そうです 😊

npm run build だけが型エラーで止まる

TypeScript と JavaScript の違いでつまずきやすいのが、型エラーがあっても動いてしまう場面です。

src に、型エラーが1つあるファイルを置きました。

// src/Oops.tsx
import { Greeting } from './Greeting'

export function Oops() {
  return <Greeting name="ララ" age="30" />
}

この状態で npm run build を実行すると、tsc -b のところで止まり、終了コードは 1 でした。

> [email protected] build
> tsc -b && vite build

src/Oops.tsx(4,30): error TS2322: Type 'string' is not assignable to type 'number'.

一方、同じ状態で npx vite build だけを実行すると、エラーなしで最後まで通りました。

dist/assets/index-Bebeu7K5.js   220.52 kB │ gzip: 69.13 kB

✓ built in 83ms

Vite は .tsx から型を取り除いて JavaScript に変えるだけで、型のチェックはしないためです。

開発サーバー(npm run dev)も同じで、型エラーがあっても画面は表示されます。

型エラーに気づけるのは、エディタの表示と npm run build(または npx tsc -b)なので、ビルドのコマンドから tsc -b を外さないほうが安全です!

ビルドした JavaScript には型が残らない

npm run build でできた dist/assets/index-*.js には、GreetingProps という文字列は1つもありませんでした。

Greeting の部分は、型が消えて普通の JavaScript になっていました。

こんにちは、`,e,`さん(`,t,`歳)`]}),n]})}function m(){let[e,t]=(0,l.useState)(``),[n,r]=(0,l.useState)(null),...

ブラウザで動くのはこの JavaScript なので、TypeScript にしたからといって、動きや速さが変わるわけではありません。

型は書いている間とビルドの前に、間違いを見つけるためのものです。

参考: 公式ドキュメントに書かれていること

React の公式ドキュメント「TypeScript の使用」によると、既存の React プロジェクトに TypeScript を足すときは、@types/react と @types/react-dom を入れ、tsconfig.json の lib に dom を含め、jsx を有効なオプションに設定する必要があるとのことです(TypeScript の使用 – React)。

同じページでは、useReducer・useContext・useMemo・useCallback の型の付け方や、React.CSSProperties でスタイルの型を書く方法も紹介されています。

TypeScript の公式ブログによると、TypeScript 6.0 で strict の既定値が true に変わったとのことです(Announcing TypeScript 6.0)。

この記事で tsconfig に strict がないのに strict のエラーが出たのは、このためだと思われます。

古い記事やプロジェクトで React.FC を使った書き方を見かけることがありますが、この記事では props の型を引数に直接付ける書き方にしています。

関連する記事

まとめ

React を TypeScript で書くときに、最初に覚えるのはこれくらいです。

  • npm create vite@latest -- --template react-ts で始める
  • props は type で形を書き、省略できるものに ?、children は ReactNode
  • useState は初期値で分かるなら書かない、null や空の配列で始めるときは <User | null>・<string[]>
  • イベントは ChangeEvent<HTMLInputElement>・FormEvent<HTMLFormElement>、ref は useRef<HTMLInputElement>(null)
  • 型エラーは開発サーバーでは止まらないので、npm run build(tsc -b)で確かめる

useState([]) の never は、知らないと「なんで入らないの?」となるので、覚えておくと得です!

フィードバックのお願い
この記事のフィードバックがありましたらYoutubeの適当な動画にコメントしていただいたり、お問い合わせからご連絡ください。