WebStormインテンション・アクションの極限活用：AST操作と型推論エンジンをハックする近代JS/TSリファクタリング
世の中の多くの開発者は、`Alt + Enter`（macOSでは `⌥ + ⏎`）を単なる「赤波線（エラー）の簡易修正ツール」だと思っている。
しかし、それはジェットエンジンをペーパーウェイトとして使っているようなものだ。
WebStormをはじめとするJetBrainsのIntelliJプラットフォームの真髄は、コードを単なるテキストではなく、厳密な抽象構文木（AST：Abstract Syntax Tree）と双方向で同期する「生きた構造体」として捉えている点にある。インテンション・アクション（Intention Actions）は、そのAST操作エンジンを開発者の手元でダイレクトに暴走させるためのキースイッチなのだ。
本稿では、WebStormのインテンション・アクションを骨の髄までしゃぶり尽くし、モダンJavaScript/TypeScriptのコードベースを極限まで美しく、かつ秒速でリファクタリングするための裏技を、内部アーキテクチャの視点も交えながら叩き込む。
—
1. WebStorm内部で何が起きているか？ ASTとインテンションの裏側
インテンション・アクションを語る上で避けて通れないのが、IDE内部におけるPSI（Program Structure Interface）ツリーの存在だ。
WebStormは、エディタに打ち込まれた文字列を即座に字句解析（Lexical Analysis）し、構文解析（Parsing）を経て、型定義（TypeScript Compiler APIのラッパー）と統合されたPSIツリーをメモリ上に構築する。
あなたが `Alt + Enter` を押した瞬間、IDEは「現在のカーソル位置にあるPSIノードの型、スコープ、および周囲のコンテキスト」をミリ秒単位で評価し、適用可能な変換パターンのリストを動的に生成している。
つまり、インテンション・アクションとは「テキストの置換」ではなく、「ASTノードの安全な構造的トランスフォーメーション（変形）」なのだ。正規表現による置換とは異なり、スコープの競合や変数のシャドーイングを完全に自動で回避しながらコードを書き換えることができる。この堅牢性こそが、大規模なTypeScriptコードベースにおいてインテンションが手放せない理由である。
—
2. 実戦投入：コードベースを劇的に洗練させる4大リファクタリング技
ここからは、実務の現場で遭遇する「美しくないコード」を、インテンション・アクション一発でモダンな傑作へと昇華させる具体的なテクニックを紹介する。
技01: 帝国主義的な命令型ループを、関数型 `map` / `filter` へ一瞬で堕とす
次のような、一時配列を用意して `for` ループでデータを詰めていくコードは見慣れたものだろう。可読性が低く、ミュータブル（変更可能）な変数がスコープに残るためバグの温床になりやすい。
// リファクタリング前：伝統的な命令型コード
function getActiveUserEmails(users: User[]): string[] {
const result: string[] = [];
for (let i = 0; i < users.length; i++) {
const user = users: i;
if (user.isActive && user.email) {
result.push(user.email);
}
}
return result;
}
インテンションの奔流
1. `for` 文のブロック、あるいは `for` キーワードそのものにカーソルを合わせる。
2. `Alt + Enter` を叩く。
3. 「Replace with .forEach()」 または 「Replace with .map() / .filter()」（※コード構造に依存）を選択する。
WebStormのAST解析エンジンは、このループが「配列のフィルタリングと射影（Projection）」を行っていることを静的解析で検知しているため、一撃で以下のような宣言的コードへ変換してくれる。
// リファクタリング後：洗練された関数型パイプライン
function getActiveUserEmails(users: User[]): string[] {
return users
.filter(user => user.isActive && user.email)
.map(user => user.email);
}
ミュータブルな `result` 変数は消え去り、イミュータブルで高度に合成可能なストリーム処理へと生まれ変わった。
—
技02: コールバック地獄を `async/await` へシームレスに巻き戻す
Promiseチェーンがネストした非同期処理は、メンテナンスの悪夢だ。これを現代的な `async/await` 構文に書き換える際、手動でやるとスコープのミスや `return` の付け忘れを引き起こす。
// リファクタリング前：複雑なPromiseチェーン
function fetchUserData(userId: string): Promise
return api.getUser(userId)
.then(user => {
return api.getPermissions(user.roleId)
.then(permissions => {
return { …user, permissions };
});
})
.catch(error => {
logger.error(error);
throw new Error(‘Failed to fetch user data’);
});
}
インテンションの奔流
1. `.then()` メソッドチェーンの先頭、または関数全体にカーソルを置く。
2. `Alt + Enter` を叩き、「Unwrap ‘Promise.then()’」 または 「Replace with ‘async/await’」 を呼び出す。
WebStormはクロージャのスコープを解析し、外側の変数バインディングを維持したまま、次のように美しくフラットな非同期関数にリフトアップする。
// リファクタリング後：可読性の高いasync/await
async function fetchUserData(userId: string): Promise
try {
const user = await api.getUser(userId);
const permissions = await api.getPermissions(user.roleId);
return { …user, permissions };
} catch (error) {
logger.error(error);
throw new Error(‘Failed to fetch user data’);
}
}
`try/catch` ブロックへの自動包摂も含め、人間がやるとミスしやすいボイラープレートの書き換えを完全自動化する。
—
技03: ネストの深い「アローの迷宮」をガード節（Guard Clauses）で光らせる
条件分岐が深くネストしたコード（いわゆる矢印型コード：Arrow Anti-pattern）は、認知負荷を跳ね上げる最大の要因だ。
// リファクタリング前：ディープネストな条件分岐
function processOrder(order: Order | null): string {
if (order) {
if (order.isPaid) {
if (order.items.length > 0) {
return ‘Processing order…’;
} else {
return ‘Error: Cart is empty’;
}
} else {
return ‘Error: Not paid’;
}
} else {
return ‘Error: Invalid order’;
}
}
インテンションの奔流
1. 最外殻の `if (order)` ブロックにカーソルを置く。
2. `Alt + Enter` を押し、「Invert ‘if’ condition」 や 「Lift ‘if’ out」、あるいは「Replace ‘if’ with guard clause」系のインテンションを実行する。
3. 必要に応じて数段階適用する。
これにより、異常系を先に弾き返す「ガード節」のパターンへと構造が反転する。
// リファクタリング後：フラットで直感的なガード節
function processOrder(order: Order | null): string {
if (!order) {
return ‘Error: Invalid order’;
}
if (!order.isPaid) {
return ‘Error: Not paid’;
}
if (order.items.length === 0) {
return ‘Error: Cart is empty’;
}
return ‘Processing order…’;
}
Cognitive Complexity（認知的複雑度）が劇的に下がり、関数の出口（exit points）が明確になるため、バグの混入余地が大幅に減少する。
—
技04: オブジェクトの分割代入（Destructuring）の強制と最適化
膨大なプロパティを持つ設定オブジェクトやpropsを扱う際、毎回 `props.xxx` と書くのは冗長である。
// リファクタリング前：冗長なプロパティアクセス
function UserCard(props: { user: User; theme: string; onEdit: (id: string) => void }) {
return (
{props.user.name}
);
}
インテンションの奔流
1. 引数部分、または関数本体のオブジェクトアクセス箇所にカーソルを合わせる。
2. `Alt + Enter` -> 「Unfold object destructuring」 もしくは引数の型/名に対して 「Create destructuring」 を選択。
// リファクタリング後：洗練された分割代入
function UserCard({ user, theme, onEdit }: { user: User; theme: string; onEdit: (id: string) => void }) {
return (
{user.name}
);
}
コードのタイポグラフィが引き締まり、TypeScriptの型推論とも完璧に同期する。
—
3. さらに先へ：インテンションを拡張する「Custom Inspection / Structural Search and Replace (SSR)」
標準のインテンション・アクションだけでも強力無比だが、シニアアーキテクトであれば「チーム固有のアンチパターンを排除するカスタムインテンション」を定義したくなるはずだ。
WebStormには、任意のコードパターンを検知し、それをインテンションとして修正候補に登録できる 「Structural Search and Replace (SSR)」 という究極の機能が備わっている。
例：古臭い `lodash` のインポートをネイティブESMに強制置換するカスタムルールの作成
プロジェクト内で `import _ from ‘lodash’` と書かれている非効率なコードを、すべて `import { debounce } from ‘lodash-es’` のようなツリーシェイキング可能な形式に誘導するインテンションを作る。
1. `Settings (Preferences) > Editor > Inspections` を開く。
2. `Structural Search` から新規テンプレートを作成。
3. Search Pattern:
import _ from ‘lodash’;
_.debounce($ARG1$, $ARG2$)
4. Replace Pattern:
import { debounce } from ‘lodash-es’;
debounce($ARG1$, $ARG2$)
5. これを「Inspection」として保存し、Quick Fix（インテンションとして呼び出し可能）に紐付ける。
これにより、チームメンバー全員が `Alt + Enter` を押すだけで、組織全体のコード品質ガバナンスがリアルタイムに統一されていく。CI/CDパイプラインでリントエラーを出して開発者を叱責する前に、「IDEのインテンションで正しい書き方をサジェストし、間違える余地を奪う」。これが真のDevOpsシフトレフト思想だ。
—
4. パフォーマンス・チューニング：WebStormを極限まで高速に保つためのメモリ最適化
これほど高度なAST解析とインテンションの動的生成をリアルタイムで行うWebStormは、設定を誤るとメモリを大量消費し、タイピング遅延（Input Latency）を引き起こす原因になる。大規模なモノレポ（Monorepo）環境を支配するアーキテクトが実施すべき、JVMおよびIDEのチューニングハックを授ける。
A. 不要なスコープの除外（Indexの軽量化）
WebStormはプロジェクト内の全ファイルを監視・インデックス化する。 `node_modules` やビルド成果物（`dist`, `.next`, `coverage` など）が適切に Excluded（除外）されていないと、インテンションの候補生成時にメモリプレッシャーが高まる。
- ディレクトリを右クリック > `Mark Directory as` > `Excluded` に設定し、インデックス対象から完全に外す。
B. VM Optionsの極限チューニング
`Help > Edit Custom VM Options` を開き、ガベージコレクションとメモリ割り当てを最適化する。Node/TypeScriptの言語サービスを多用する現代のフロントエンド開発においては、G1GC（Garbage-First Garbage Collector）の採用が必須である。
ヒープサイズの最大値・最小値の固定（スワップ発生を防ぐため物理メモリの余裕分を指定）
-Xms2g
-Xmx4g
予約コードキャッシュサイズの拡張（プラグインやTS言語サービス用）
-XX:ReservedCodeCacheSize=512m
G1GCの有効化とレイテンシ最適化
-XX:+UseG1GC
-XX:InitiatingHeapOccupancyPercent=45
-XX:G1ReservePercent=15
OSのファイル監視制限（inotify）の競合を防ぐための設定（Linux環境の場合）
-Didea.file.watcher.disabled=false
—
結び：ツールに奉仕するな、ツールを肉体の一部にしろ
インテンション・アクションは、単なる「便利機能」ではない。
それは「思考のスピードとコードの品質を完全に同期させるための神経接続インターフェース」である。
キーボードから手を離さず、`Alt + Enter` をリズミカルに叩きながら、命令型から関数型へ、複雑なコールバックからエレガントな非同期処理へとコードを彫刻していく。その快感を知ったとき、あなたの開発スピードは次元の違う領域へと到達するはずだ。
さあ、今すぐWebStormを開き、その手でコードの構造（AST）を自在に組み替えてみせろ。