TypeScript のコードスタイル支援
ReSharper は、コードをすっきりとクリーンに保つための多くの機能を提供します。 他の ReSharper の機能の大部分と密接に連携しているため、特定のコードスタイルに従ってコードを作成し、既存のコードベースを変更できます。 命名標準、フォーマット規則、その他のさまざまな小さな要素を含むコードスタイルは、非常に詳細なレベルに構成してチーム全体で共有できます。
他の言語と同様に、すべての TypeScript コードスタイル環境設定は、希望するスコープに対して 範囲内で修正または コードのクリーンアップのいずれか 1 つのコマンドで適用できます。
ReSharper は、TypeScript で次のコードスタイルアシスタンス機能を提供します：
命名スタイル
ReSharper は、コード内のシンボルに対して希望する命名スタイルを定義、管理、適用するのに役立ちます。 特定の識別子を対象とするルールのセットがあり、それぞれが制約のセットを持っています。 各ルールには、複合語、アンダースコア、接尾辞、接頭辞などの大文字化を定義する 1 つ以上の関連スタイルを含めることができます。
これらのルールは、ReSharper が コード補完や コード生成機能で新しいコードを作成し、 コードテンプレートを適用し、 リファクタリングを実行する際に考慮されます。 ReSharper は、命名規則違反を 検出して修正するのにも役立ちます。 必要に応じて、命名規則の自動チェックを 構成または無効にできます。
命名スタイルの構成と適用の詳細については、 ネーミングスタイル を参照してください。
コードフォーマットルールの管理と適用
コードスタイルの重要な側面は、コードのフォーマット方法です。つまり、空白、タブ、改行を使ってコード要素をどう配置するか、インデントにタブを使うかどうかとその方法、長い行を折り返すかどうかとその方法などです。
ReSharper の広範なコードフォーマット規則セットには、デフォルトの Visual Studio フォーマットオプションや多くのベストプラクティスを考慮したデフォルト構成があります。 フォーマットルールのすべての詳細を 構成し、コードにルールを適用できます。 これらのルールは、ReSharper が コード補完や コード生成機能で新しいコードを生成する際、 コードテンプレートを適用したり、 リファクタリングを実行したりする場合にも適用されます。 フォーマット規則は、現在の選択範囲、現在のファイル、またはソリューション全体までのより広いスコープの 既存のコードにも適用できます。
ReSharper は、 共有設定の仕組みを利用してフォーマット環境設定を保存します。 グループのオプションページで フォーマットルールを設定できます。 また、 EditorConfig および Clang 形式ファイルに フォーマット設定を保存して共有することもできます。
引用スタイル
TypeScript の仕様では、文字列リテラルを処理する際に、シングル（'）およびダブル（"）の両方の引用符が使用できます。 プロジェクトまたはソリューション内では、同じ引用符スタイルを使用することをお勧めします。 この操作は、ReSharper オプションの ページで、該当するコードインスペクションの 重要度レベルと合わせて環境設定を構成することで実行できます。 ReSharper は、環境設定と異なるコードを検出してハイライトします。 既存のコードベースでこの設定を適用するには、 組み込みプロファイル フルクリーンアップまたは 再フォーマットして構文スタイルを適用のいずれかを使用してコードクリーンアップを実行するか、対応するオプションが選択された場所で カスタムプロファイルを作成して実行します。
この設定は JavaScript の同じ設定と共有されているため、ある言語で変更すると、他の言語の設定も変更されます。
モジュールのインポートスタイル
他のモジュールから型をインポートする方法にはいくつかあり、モジュールエイリアスを追加するか完全修飾型名を使うことができます。 ReSharper は、好みに応じた型インポート方法を希望のスコープに適用するのをサポートします。
優先モジュールのインポートスタイルを適用する
ReSharper オプションの ページにある 型をインポートするときに修飾子にモジュールエイリアスを追加することを優先する チェックボックスを使って、環境設定を指定できます。
「完全クリーンアップ」プロファイルで希望のスコープに コードのクリーンアップを実行します。
必要に応じて、カスタムプロファイルを使用してモジュールインポートスタイルを適用できます。 これを行うには、 カスタムクリーンアッププロファイルを作成し、 TypeScript 固有 プロファイル設定の 「import」ステートメントを最適化する チェックボックスをオンにします。
参照コメントの最適化
ReSharper は、未使用の参照コメントの検出と削除を支援します。 参照コメントを最適化するには、「完全クリーンアップ」プロファイルで希望のスコープに コードのクリーンアップを実行するか、 カスタムクリーンアッププロファイルを作成し、プロファイル設定の TypeScript 固有 で 参照コメントを最適化する チェックボックスにチェックを入れてください。
終了文
JavaScript/TypeScript では、ステートメントが改行で終わる場合、または中括弧で囲まれたステートメントが 1 つだけある場合、ステートメントを終了するためにセミコロンは必要ありません。 ただし、多くの場合、各ステートメントの後にセミコロンを使用することが推奨されます (たとえば、 この StackOverflow スレッド(英語)を参照してください)。 ReSharper を使うと、セミコロンを自動的に追加できます。
特定のファイル、プロジェクト、ソリューションのステートメントを終了するには、「フルクリーンアップ」プロファイルまたは ステートメントの終了 が JavaScript/TypeScript セクションで選択されている カスタムプロファイルを使用して、目的のスコープで コードクリーンアップを実行します。
修飾子の配置
明示的な 'public' 修飾子を使用するかどうか選択する場合、ReSharper オプションの ページで該当するコードインスペクションの 重要度レベルとともに環境設定を構成できます。 ReSharper は、環境設定と異なるコードを検出してハイライトします。 既存のコードベースでこの設定を適用するには、 組み込みプロファイル フルクリーンアップまたは 再フォーマットして構文スタイルを適用のいずれかを使用してコードクリーンアップを実行するか、対応するオプションが選択された場所で カスタムプロファイルを作成して実行します。
暗黙的 / 明示的な型指定
TypeScript 仕様では、型に暗黙的または明示的に型を指定したり、型に 'any' キーワードを使用したりできます。 ReSharper のコードスタイルアシスタントを使って、型を明示的に指定すべきかや暗黙の'any'を許可するかどうかを定義できます。
環境設定を指定するには、ReSharper オプションの ページにある 型指定 グループのコントロールを使用します。
暗黙の「any」を使用することをプロジェクト設定で設定することもできます。 暗黙の 'any' タイプがプロジェクト設定で許可されていない場合は、コードスタイルの設定に関係なく、常にエラーとしてハイライトされます。
暗黙的 / 明示的型指定設定を特定のファイル、プロジェクト、ソリューションに適用するには、「完全クリーンアップ」プロファイル、または TypeScript 固有 セクションで 型アノテーションの有無をコードスタイルと同期する および 必要に応じて明示的な「any」型アノテーションを追加する チェックボックスが選択されている カスタムプロファイルを使用して、目的のスコープで コードクリーンアップを実行します。
暗黙的 / 明示的なタイプ設定の好みも ReSharper の コードインスペクションによって考慮に入れられています。