特別なツール不要! TypeScript 2時代の型定義ファイルの取り扱い方

  • 187
    Like
  • 0
    Comment

TypeScriptを使う上で欠かせないのが型定義ファイルの取り扱いです。TypeScript 1系では、型定義ファイルを管理するツールとして、tsdTypingsがありました。TypeScript 2では特別なツールはいらず、Node.jsインストール時に付属するnpmのみで型定義ファイルが管理できる機能が開発中です

TypeScript 2.0で型定義ファイルをインストールする

TypeScript 2.0の導入方法については、記事「リリース直前のTypeScript 2.0をインストールして新機能を先取りする方法」にて解説しています。他プロジェクトに影響を与えることなく導入する方法を紹介しています。以下、TypeScript 2.0が使える環境として進めます。

npmの初期設定後、型定義ファイルをインストールするには次のコマンドを実行します。

コマンド
npm install --save @types/(型定義ファイル名)

例えば、jQueryの型定義ファイルをインストールするには次のようにします。

コマンド
npm install --save @types/jquery

プロジェクトフォルダのnode_modulesフォルダに@typesフォルダが作成され、jQueryの型定義ファイルがインストールされます。

TypeScript 2.0で型定義ファイルを使う

先ほどインストールしたjQueryの型定義ファイルを用いて、TypeScript 2.0でjQueryを使ってみます。

次のサンプルコードを試します。ファイル名はhoge.tsです。

TypeScript2でjQueryを使う
$(function () {
    alert("hoge");
});

jQueryの型定義ファイルを使いますが、reference pathで型定義ファイルを読み込んだり、tsconfig.jsonfilesに型定義ファイルを指定したりといった作業は不要です

コンパイルする

hoge.tsをコンパイルします。Typings等の特別なツールは使わず、npmでインストールした型定義ファイルのみでコンパイルが成功します。

TypeScript2のコンパイル
./node_modules/.bin/tsc hoge.ts 

どんな型定義ファイルが使えるのか

使用できる型定義ファイルは「TypeScript Types Search」より検索できます。多くの型定義ファイルが使用可能であり、例えば筆者が使う機会のある以下のようなライブラリも対応していました。

  • three.js
  • pixi.js
  • CreateJS
  • AngularJS (1.5)
  • RxJS
  • 他多数

TypeScript 2.0で型定義ファイルが便利になる

TypeScript 2.0の型定義ファイル管理は、tsdTypingsに比べて楽になっています。特別な知識は不要で、npmさえ使えればすぐに型定義ファイルを使えるのです。TypeScript導入の敷居も下がることでしょう。筆者はこれまで型定義ファイルで煩わしさを感じることが度々ありましたが、TypeScript 2.0の登場により悩みが解決されると感じました。