TypeScriptのコード生成をつらくしないために

Transcript

1. TypeScriptのコード生成をつ らくしないために ノーン（@nkowne63）
2. 自己紹介 ノーン（@nkowne63） 大学院に通いながら株式会社ventusでエンジニ アをしている。 今日の話は2019年～から開発しているプロダクト で遭遇したコード生成についての話。
3. コード生成をどういうときに書く？ APIやDBといった「TypeScriptの外」とのやりとり 基本的にはライブラリがあるのでそれを使えばよいが...... 今回は「自分たちで実装しなきゃいけなくなった」ときに避けるべきアンチ パターンを1つ紹介する。
4. 処理だけをコード生成 TypeScriptの型推論の能力は割と 優れているので、 処理だけをコード生成しても適切に アノテーションされていれば問題なく 使える → 最初のうちは開発が高速化する が......
5. 処理だけコード生成することのつらさ 生成されたコードがバグっていると 厳しいデバッグが始まる...... 後からより優れたOSSやコード生成 が出てきた時に影響範囲が大きす ぎる → 乗り換えられない！
6. 対策：型をまずは生成して処理は別で書く 型（インターフェース）だけ生成し、 処理を別で書く（or生成する）こと で、速いサイクルで処理を差し替え られるようになる。
7. 対策：型をまずは生成して処理は別で書く 後に良いOSSが出たときに、そちら に段階的に移行する戦略を取りや すい。 具体的な処理はコード生成を用い てもよいし、GenericsやProxyを用 いた動的な実装でもよい。
8. TSの機能を積極的に使ってless codegenを志向する Template Literal TypesやMapped Types, Conditional Typesなどを用 いることで、生成しなければいけな いものを減らしていき、運用しやす くすることができる。
9. まとめ • コード生成される具体的な処理に依存してしまうと、後々差し替え が効かなくなってつらくなる • コード生成を行うときは、処理だけではなく型の生成をして、デバッ グの難易度を下げたり差し替えをしやすくしよう