できない.dev

TypeScript「Argument of type ... is not assignable」の原因と直し方

Argument of type X is not assignable は、as const・型ガード・satisfies で引数の型を絞れば消える。
リテラル型の広がり、null の混入、ジェネリック推論の失敗が主な原因である。

公開: 更新:

症状できない · exit 2
npx tsc
src/bad.ts(4,9): error TS2345: Argument of type 'string' is not assignable to parameter of type '"light" | "dark"'.
解決後できた · exit 0
npx tsc

2026-10-21 に node:20(TypeScript 5.9.3 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

エラー TS2345「Argument of type X is not assignable to parameter of type Y」は、関数を呼ぶときの実引数 X が宣言された仮引数の型 Y に代入できない(サブタイプではない)ことを示す。
原因の大半は、リテラル型の広がり、null/undefined の混入、余剰プロパティ、ジェネリック推論の失敗である。
as const / satisfies / 型ガード / 明示的な型引数のいずれかで意図した型に絞れば消える。
as での強制アサートは最後の手段にとどめる。

実行例

node:20(Debian GNU/Linux 12)環境の TypeScript 5.9.3 で上記の手順を動かすと、リテラル型の広がりによる TS2345 が終了コード 2 で出た。
as const による修正と、変数への型注釈の付与のどちらでも、終了コードは 0 になった。

Version 5.9.3
$ npx tsc
src/bad.ts(4,9): error TS2345: Argument of type 'string' is not assignable to parameter of type '"light" | "dark"'.
$ echo $?
2
$ npx tsc
$ echo $?
0
$ npx tsc
$ echo $?
0

— 2026-10-21 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-21 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • TypeScript 5.9.3

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. リテラル型を保つ

function setMode(m: "light" | "dark") {}
const m = "light" as const;       // 型は "light"
setMode(m);                       // OK
 
// あるいは関数宣言側で型注釈を付ける
const m2: "light" | "dark" = "light";

2. null / undefined を除外する

function need(s: string) {}
const maybe: string | null = getValue();
if (maybe != null) need(maybe);          // 型ガード
need(maybe ?? "");                       // デフォルト値

3. satisfies で形を保ちつつ検査する

type Config = { host: string; port: number };
const cfg = {
  host: "localhost",
  port: 5432,
} satisfies Config;

satisfies は型が一致しているか検査するが、推論されるリテラル情報はそのまま残るので、後段の cfg.host も "localhost" リテラル型として使える(公式リリースノート(新しいタブで開く))。

4. ジェネリックは型引数を明示する

function pick<T, K extends keyof T>(obj: T, key: K): T[K] { return obj[key]; }
pick<{ a: number }, "a">({ a: 1 }, "a");   // 推論失敗時はこのように明示

as は最後の手段

x as Y は型チェックを黙らせるだけで、ランタイムの不整合は残る。
先に上の 4 手を試して、本当に型情報の不足が確実な場合のみ使う。
基本的な型システムの考え方は 公式 Handbook(新しいタブで開く) にまとまっている。

よくある原因

  1. 文字列リテラルが string に広がっている。
    例えば function setMode(m: 'light' | 'dark') {} に let m = 'light'; setMode(m) と渡すと、m の推論は string になり代入できない。
    const m = 'light' なら型はリテラルの 'light' のまま残るので、このエラーは出ない。
  2. T | null を返す API の戻り値を T 専用の関数に流し込んでいる。
    null チェックなしでは渡せない。
  3. オブジェクトリテラルが、宣言されていない余剰プロパティを含む。
    あるいは required なプロパティが抜けている。
  4. ジェネリック関数の呼び出しで型引数を省略しており、推論が unknown や空オブジェクト {} で確定して、想定外の型として fail する。