できない.dev

Browserslist

別名: .browserslistrc / browserslist 設定 / npx browserslist

Browserslist は、フロントエンドのツールが対応するブラウザの範囲を 1 か所で決める設定である。
Autoprefixer や @babel/preset-env がこの一覧を読み、プレフィックスの付与や構文の変換を決める。

公開:

定義

Browserslist は、フロントエンドのツールが対応するブラウザと Node.js の範囲を 1 か所で決める設定と、それを読むライブラリである。
> 0.5% や last 2 versions のような問い合わせの文を書くと、条件に合うブラウザの一覧に展開される。

詳細

設定は package.json の browserslist キーか、.browserslistrc ファイルに書く。
設定はいまのディレクトリから親のディレクトリへ向かって探され、環境変数 BROWSERSLIST でも指定できる。
どこにも無ければ defaults が使われ、> 0.5%, last 2 versions, Firefox ESR, not dead と同じ範囲になる。

Autoprefixer や Babel の @babel/preset-env、postcss-preset-env がこの一覧を読む。
ベンダープレフィックスを付けるか、構文を古い書き方に変換するかは、ここで選ばれたブラウザで決まる。
npx browserslist を打つと、いまの設定が選ぶブラウザを一覧で確かめられる。

よくある誤解

  • 設定を書けばどのツールも必ず従うと思われがちだが、@babel/preset-env は targets か ignoreBrowserslistConfig を指定すると Browserslist の設定を読まない。
  • Browserslist は対象のブラウザを選ぶだけで、足りない API を補う働きは持たない。
    Promise のような機能を古いブラウザで使うには、別にポリフィルを入れる。

関連

対象が新しすぎて変換されない例は @babel/preset-env を入れても構文が変換されない、プレフィックスが付かない例は Autoprefixer がベンダープレフィックスを付けてくれない で扱っている。