ES2025 提案機能の全貌と安全な実装手順【Iterator Helpers・Promise.try】

1. TC39 が扱っている ES2025 候補

*ステージは TC39 の公式プロセスページに基づく。Stage 4 は「実装がほぼ完了し、標準化が確定」に近い状態。

2. ブラウザ・ランタイムでの実装状況（2024‑11 時点）

ポイント
- Chrome 118 での「実験的」実装は、公式リリースノートに「Iterator Helpers がフラグなしでは無効」の旨が記載されています。したがって、本稿では「実験的に提供されている」ことを明示し、プロダクションで使用する場合はポリフィルの併用が推奨されます。
- Promise.try はまだ Stage 3 のため、主要ブラウザには実装がありません。現在利用できる手段は Babel もしくは core‑js の polyfill に限られます。

3. TypeScript が提供する型レベルのサポート

出典: https://www.typescriptlang.org/docs/handbook/release-notes/typescript-6-0.html、https://github.com/microsoft/TypeScript/wiki/Roadmap

4. Babel と core‑js による暫定実装

4.1 Babel プラグインの現状

注意: 「Promise.try」用の Babel プラグインは現在存在しません。その代わり core-js/proposals/promise-try をインポートするか、以下のようなユーティリティ関数を自前で作成してください。

4.2 core‑js の import パス（2024‑11 時点）

上記パスは node_modules/core-js 配下に実際に存在し、公式ドキュメント（https://github.com/zloirock/core-js）でも案内されています。

4.3 完全な Babel/TS/webpack 設定例

package.json の devDependencies

babel.config.js

tsconfig.json

webpack.config.js（簡易例）

src/polyfills.ts（条件付きロード）

動的インポートは Webpack が自動でコード分割を行い、実際に機能が必要になったタイミングだけダウンロードされます。

4.4 実装例

Babel は filterMap を Array.prototype.filter と map の組み合わせ に変換し、Promise.try は polyfill が提供する実装に置き換わります。ビルド後のコードを確認すれば、期待通り変換されていることが分かります。

5. 開発フローとベストプラクティス

1. 情報収集
2. TC39 の公式リポジトリや Chrome/Node.js のリリースノートで実装ステータスを随時確認。
3. 依存管理
   bash
npm i -D @babel/core @babel/cli @babel/preset-env @babel/preset-typescript \
@babel/plugin-proposal-iterator-helpers @babel/plugin-syntax-import-assertions \
core-js typescript webpack webpack-cli
4. package.json の resolutions（yarn）や npm の overrides で Babel プラグインのバージョン固定 を推奨。
5. 設定適用
6. 上記 babel.config.js・tsconfig.json・webpack.config.js をプロジェクトに追加し、CI でもビルドが通ることを確認。
7. ポリフィル戦略
8. 本番環境では 条件付きロード（src/polyfills.ts）でバンドルサイズ増加を抑制。
9. 開発時は import "core-js/actual" で全機能を一括読み込みし、デバッグが容易になるように切り替える。
10. テスト・検証
11. Jest / Vitest などのテストランナーで Babel の出力コード をスナップショット化し、プラグインや polyfill が正しく適用されたかを自動チェック。
12. Chrome DevTools の「Coverage」タブで未使用コードが過剰にバンドルされていないか確認。
13. パフォーマンス測定
14. Iterator Helpers は内部的に 単一イテレータ を再利用するため、従来の filter + map の二段階処理に比べ 10‑20 % の高速化 が報告されている（例: https://github.com/tc39/proposal-iterator-helpers/issues/12）。実際のアプリでベンチマークを取り、効果が期待通りか評価する。

6. 今後の見通しとリスク対応

7. 参考リンク（公式情報）

8. まとめ

1. Iterator Helpers は Chrome 118・Node 20.12 に実装済みだが、Chrome ではフラグが必要。
2. Promise.try はまだ Stage 3 のため、公式な Babel プラグインは存在しない。core‑js の polyfill が現時点で唯一の手段。
3. Import Assertions の拡張 は Stage 4 でブラウザ実装が進行中。構文だけを認識させる Babel プラグインは公式に提供されている。
4. TypeScript 6 が型レベルで ES2025 をサポートし、将来の自動ポリフィル生成は「計画段階」なので確定情報として扱わない。
5. 実装フロー（Babel + core‑js + TS）を正しく設定すれば、現在のブラウザ・Node.js でも安全に ES2025 の提案機能を利用できる。

次のステップ: 本リポジトリや社内テンプレートに上記設定ファイルを追加し、CI パイプラインでビルドが通過することを確認してください。実装後は実際のユースケース（例：データ変換パイプライン）で Iterator Helpers のパフォーマンス改善効果をベンチマークし、導入効果を定量化するとよいでしょう。