🎴

TypeScriptのGenericsで部分的型推論を行う

2023/04/17に公開

TypeScript では部分的型推論が出来ない

TypeScript では部分的型推論が出来ないというのは、Generics の使い方に制限を与えてしまう問題です。例えば、上記のコードでは func 関数に対して一つ目の引数だけ number 型を指定したい場合、残りの引数の型も明示的に書かなければなりません。しかし、これは冗長であり、型安全性も損なわれる可能性があります。なぜなら、引数の型が変わったときに、Generics の型も一致させる必要があるからです。

部分的型推論が出来ればこのような問題を回避できまが、TypeScript では以下のような状態です。

const func = <A, B, C>(a: A, b: B, c: C): [A, B, C] => {
  return [a, b, c];
};

func(1, "2", 3); // OK
func<number>(1, "2", 3); //NG
func<number, string, number>(1, "2", 3); //OK

Generics を使うと引数の推論によって型を取り出し加工して再利用出来るので、複雑な変換を扱うデータを記述することも容易になります。ただし問題があって、対象の関数を利用するとき Generics に対して一つでも型を与えてしまうと、全て指定しなければなりません。型を一つだけ指定して、残りは推論してもらいたいという機能が無いのです。

外部から型を注入したい場合に困る

例えば以下のような JSON ファイルからデータを読み取って、対象のデータを取り出すというプログラムがあったとします。

import fs from "fs";

// jsonファイルからデータを読み込む
const getValue = <T extends object, K extends keyof T>(
  fileName: string,
  keyName: K
): T[K] => {
  const text = fs.readFileSync(fileName);
  const data = JSON.parse(text.toString());
  return data[keyName];
};

// ファイル内の型構造は分かっている
type DataType = { a: number; b: string };

// 推論を一つ設定すると、残りも手動で設定しなければならない
const value1 = getValue<DataType, "a">("file.json", "a"); // value1:number
const value2 = getValue<DataType, "b">("file.json", "b"); // value2:string
// `a`を自動推論したいが拾ってこられない
const value3 = getValue<DataType>("file.json", "a"); // タイプが一つだけしか指定されていないのでError

getValueは汎用的に使えるようにしたいけれど、特定のファイルの内部構造は分かっているので型を指定したい。そして取得したデータの型は自動で付けたい。こういう場合にabの部分は自動で推論してもらいたいのですがこれは出来ません。手動で指定する必要があります。

この問題を解決するために、TypeScript では Partial Type Argument Inference という機能が提案されています。これは、Generics に対して型を部分的に指定することができるようにするものです。しかし未だ使えない以上は、ある機能で対応するしかありません。

部分的型推論の作り方

以下のように型を指定する部分と推論部分を分けた type を作ります。interface でも同じ事は可能です。

// Tを設定しKは自動推論のタイプを作る
type GetValue<T extends object> = {
  <K extends keyof T>(fileName: string, keyName: K): T[K];
};

// キャストにより部分推論が出来る
const value4 = (<GetValue<DataType>>getValue)("file.json", "a"); // value4:number
const value5 = (<GetValue<DataType>>getValue)("file.json", "b"); // value5:string

// 型設定済み関数を作る
const getValue2: GetValue<DataType> = getValue;
const value6 = getValue2("file.json", "a"); // value6:number
const value7 = getValue2("file.json", "b"); // value7:string

先ほどの getValue をキャストすることによって、部分的型推論が機能するようになりました。書き方が冗長になってしまうので、いったん部分的型推論済みのgetValue2を作るという書き方も可能です。

外部から型情報を持ってくる必要のある汎用ライブラリなどを作る場合は、この方法を使うとかなり便利になります。

まとめ

部分的型推論の標準対応が欲しい。

GitHubで編集を提案

Discussion