React×TypeScriptの書き方:props・useState・イベントの型と、実際に出る型エラー(React 19・TypeScript 7で確認)
目次
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 のテンプレートでプロジェクトを作り、よく使う型の書き方と、わざと間違えたときに実際に出るエラー文を並べました。
「型って何を書けばいいの?」という人が、最初に覚える分だけに絞っています。
確かめた環境
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.tssrc の中は 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>
)
}名前を入力して「登録」を押した後の画面です。
このコードは 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 83msVite は .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 の型を引数に直接付ける書き方にしています。
関連する記事
- Vite+Reactの環境構築:インストールからdev・build・previewまで
- React Hooks(フック)とは?一覧と使い方を、動かした結果で確かめる
- React Hook Formの使い方:register・handleSubmit・watchとエラー表示
- Reactとは?読み方と仕組みを、動くコードで確かめながら解説
まとめ
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 は、知らないと「なんで入らないの?」となるので、覚えておくと得です!




