TypeScriptのあれこれ②違う型なのに代入できる！？

◆ Live配信スケジュール ◆
サイオステクノロジーでは、Microsoft MVPの武井による「わかりみの深いシリーズ」など、定期的なLive配信を行っています。
⇒ 詳細スケジュールはこちらから
⇒ 見逃してしまった方はYoutubeチャンネルをご覧ください

【5/21開催】Azure OpenAI ServiceによるRAG実装ガイドを公開しました
生成AIを活用したユースケースで最も一番熱いと言われているRAGの実装ガイドを公開しました。そのガイドの紹介をおこなうイベントです!!
https://tech-lab.connpass.com/event/315703/

1 はじめに
2 TypeScriptとは
3 TypeScriptでの型付け
4 代入の場合
5 関数の引数の場合
6 部分型？
7 終わりに

はじめに

こんにちは、PSの新卒2年目エンジニアの細川です。普段の業務ではTypeScriptやGoを使った開発を行っています。

今回はTypeScriptの部分型についてまとめてみようと思います。

TypeScriptを書き始めたばかりのころに、「型が違うのにエラーにならない！？」って思ったことがある方はいませんか？

本ブログではこのような事態の原因になりうるTypeScriptの部分型についてまとめてみたいと思います。間違っているところありましたら、優しく教えていただければと思います。

TypeScriptとは

TypeScriptはJavaScriptの文法を拡張したものです。主に型に関する部分が拡張されています。TypeScriptはコンパイルすることで、JavaScriptになります。

イメージ的には、JavaScriptに型をつけたイメージです。

より詳細な定義が気になる方はこちらを読んでみてください。

TypeScriptでの型付け

TypeScriptで採用されている型の定義は構造的部分型と呼ばれるものです。

型の定義の仕方は公称型と構造的部分型とがあり、構造的部分型は比較的緩めの型付けとなっています。

構造的部分型では、必要なプロパティを持っていれば、違う型でもエラーになりません。実際にコードを見てみましょう。

代入の場合

まず、例として以下のようなコードを書いてみます。

type TypeA = {
  a: string;
};
type TypeAandB = {
  a: string;
  b: string;
};

const ab: TypeAandB = {
  a: "hoge",
  b: "hoge",
}
const a: TypeA = ab
console.log(a);

// 出力結果:{ a: 'hoge', b: 'hoge' }

a.b // エラー

aはTypeA型として宣言していますが、TypeAandB型を代入してもエラーになりません。

Aを出力してみると、きちんとaとbの両方が保持されています。ただし、bのプロパティにはアクセスできなくなります。

関数の引数の場合

他にも以下のようなコードを考えてみます。

const change_a = (obj: TypeA, s: string): TypeA => {
  const result: TypeA = {...obj, a: s}
  return result
}
const ab: TypeAandB = {
    a: "wa-",
    b: "wa-",
}
const result: TypeA = change_a(ab, "hoge")
console.log(result)
// 出力結果:{ a: 'hoge', b: 'wa-' }

このコードでは、change_aという関数は引数にTypeA型を受け取るように宣言していますが、TypeAandB型を渡してもエラーにならず、そのまま処理を行っています。

これはTypeA型がTypeAandB型の部分型だからです。

TypeScriptで採用している構造的部分型ではその型に必要なプロパティがあるかどうかしかチェックしていません。今回の場合ではstring型のaというプロパティを持つオブジェクトであれば、なんでもOKになります。

これを知ってないと、「関数の引数に違う型を渡したのにエラーにならない！」とちょっとだけびっくりしたりします。

部分型？

また、部分型と聞くと、部分じゃないといけないように感じますが、以下のような場合でもエラーを出さずに実行することができます。

type Human = {
	name: string;
	age?: number;
};

type Company = {
	name: string;
	num_of_employees?: number;
	address?: string;
};

const change_name = (company: Company, name: string): Company => {
	const result: Company = {...company, name: name}
	return result
};

const h1: Human = {
	name: "Taro",
	age: 15,
};

const result: Human = change_name(h1, "Hanako");
console.log(result);

↑の場合、companyがhumanの部分型となっています。プロパティの数はcompanyのほうが多いのですが、必須のプロパティが一緒なので、companyはhumanの部分型になることができます。つまり、TypeScriptは必須のプロパティが足りてるかどうかしかみてなさそうですね。