JavaScript IntelliSense
Visual Studio には、すぐに使用できる強力な JavaScript 編集機能があります。 TypeScript ベースのサービスを活用して、Visual Studio で高度な IntelliSense が提供されます。また、最新の JavaScript 機能と、定義へ移動、リファクタリングなどの生産性向上機能がサポートされています。
Visual Studio の一般的な IntelliSense の機能の詳細については、「IntelliSense の使用方法」を参照してください。
JavaScript IntelliSense では、パラメーターおよびメンバー リストに情報が表示されます。 この情報は TypeScript 言語サービスで提供されます。この言語サービスでは、コードをよりよく理解するためにバックグラウンドで静的分析が使用されます。
TypeScript では、この情報を作成するためにいくつかのソースを使用します。
型推論に基づく IntelliSense
JavaScript では、ほとんどの場合、明示的な型情報を利用できません。 幸い、周囲のコード コンテキストから型を推測するのは実に簡単です。 このプロセスを型推論と呼びます。
変数またはプロパティの場合、一般的に初期化の際に使用される値の型、または最新の割り当て値の型となります。
var nextItem = 10;
nextItem; // here we know nextItem is a number
nextItem = "box";
nextItem; // now we know nextItem is a string
関数の場合、return ステートメントから戻り値を推測できます。
関数パラメーターの場合、現時点では推測されませんが、JSDoc または TypeScript の .d.ts ファイル (以降のセクションを参照) を使用してこれに対処する方法があります。
さらに、次のような特殊な推論があります。
- "ES3 形式" クラス。プロトタイプ プロパティへのコンストラクター関数と割り当てを使用して指定します。
- CommonJS 形式のモジュールパターン。
exportsオブジェクトでのプロパティ割り当て、またはmodule.exportsプロパティへの割り当てとして指定します。
function Foo(param1) {
this.prop = param1;
}
Foo.prototype.getIt = function () { return this.prop; };
// Foo will appear as a class, and instances will have a 'prop' property and a 'getIt' method.
exports.Foo = Foo;
// This file will appear as an external module with a 'Foo' export.
// Note that assigning a value to "module.exports" is also supported.
JSDoc に基づく IntelliSense
型推論で必要な (またはドキュメントを補足するための) 型情報が提供されない場合、型情報は JSDoc 注釈で明示的に指定されることがあります。 たとえば、部分的に宣言されたオブジェクトに特定の型を指定する場合、次のように @type タグを使用できます。
/**
* @type {{a: boolean, b: boolean, c: number}}
*/
var x = {a: true};
x.b = false;
x. // <- "x" is shown as having properties a, b, and c of the types specified
前述のとおり、関数パラメーターが推測されることはありません。 ただし、JSDoc の @param タグを使用すれば、関数パラメーターにも型を追加することができます。
/**
* @param {string} param1 - The first argument to this function
*/
function Foo(param1) {
this.prop = param1; // "param1" (and thus "this.prop") are now of type "string".
}
現在サポートされている JsDoc 注釈については、「JavaScript ファイルの型チェック」の JsDoc 情報を参照してください。
TypeScript 宣言ファイルに基づく IntelliSense
JavaScript と TypeScript は同じ言語サービスに基づいているため、より多くの方法でやり取りすることができます。 たとえば、JavaScript IntelliSense は、.d.ts ファイルで宣言された値に提供することができ (TypeScript ドキュメントを参照してください)、TypeScript で宣言されているインターフェイスやクラスなどの型は、JsDoc コメントの型として使用できます。
(インターフェイス経由で) このような型情報を、(JsDoc タグを使用して) 同じプロジェクトの JavaScript ファイルに提供する TypeScript 定義ファイルの簡単な例を以下に示します。
型定義の自動取得
TypeScript の世界では、最も一般的な JavaScript ライブラリに .d.ts ファイルで記述された API が含まれ、その定義で最も一般的なレポジトリは DefinitelyTyped にあります。
既定では、言語サービスは使用されている JavaScript ライブラリを検出し、次に、高度な IntelliSense を提供するためにライブラリを記述する、対応する .d.ts ファイルを自動的にダウンロードして参照しようとします。 ファイルは、%LOCALAPPDATA%\Microsoft\TypeScript のユーザー フォルダーの下にあるキャッシュにダウンロードされます。
注意
tsconfig.json 構成ファイルを使用する場合、この機能は既定で無効になりますが、有効に設定することができます (下記参照)。
現在、自動検出は npm (package.json ファイルを読み取る場合)、Bower (bower.json ファイルを読み取る場合) からダウンロードされる依存関係に対して機能します。また、おおよそ上位 400 の最も一般的な JavaScript ライブラリのリストに一致する、プロジェクトのルーズ ファイルにも有効です。 たとえば、プロジェクトに jquery-1.10.min.js がある場合、ファイル jquery.d.ts は、優れた編集エクスペリエンスを提供するためにフェッチされ、読み込まれます。 この .d.ts ファイルはプロジェクトには影響しません。