できない.dev

ポリフィル (polyfill)

別名: polyfill / ポリフィル / core-js

ポリフィルは、実行環境がまだ持っていない機能を、後から読み込むコードで補う仕組みである。
Babel は core-js で API を補い、webpack 5 は Node.js コアモジュールの自動の補完をやめた。

公開:

定義

ポリフィル(polyfill)は、実行環境がまだ持っていない機能を、後から読み込むコードで補う仕組みである。
MDN は、古いブラウザに新しい機能を提供するコードと定義している。
Promise が無いブラウザでも、同じ振る舞いの実装を先に読み込めば、新しいブラウザ向けのコードがそのまま動く。

詳細

Babel の @babel/preset-env は、useBuiltIns と core-js を組み合わせて、対象ブラウザに足りない API のポリフィルを差し込む。
Babel 8 ではこの 2 つの設定が削除され、公式ドキュメントは babel-plugin-polyfill-corejs3 を勧めている。

webpack 4 は、crypto や stream のような Node.js のコアモジュールを、ブラウザ向けのポリフィルに自動で置き換えていた。
webpack 5 はこれをやめたので、必要なものだけを resolve.fallback で指定する。
使わないモジュールに false を指定すると、バンドルから外せる。

よくある誤解

  • 構文の変換で補えると思われがちだが、変換が扱うのはアロー関数のような書き方である。
    Array.prototype.includes のような API は変換では増えないので、ポリフィルが要る。
  • ポリフィルはネイティブの実装と同じには動かない。
    MDN も、ネイティブの実装のほうが機能が多く速いと書いている。

関連

webpack 5 で process is not defined が出る例は webpack 5 で「process is not defined」やコアモジュールの解決に失敗する にある。
補う対象のブラウザの決め方は Browserslist で説明している。