esbuild-plugin-browserslist

Configure esbuild's target based on a browserslist query

Installation

1yarn add esbuild-plugin-browserslist esbuild browserslist

Usage

1import esbuild from "esbuild";
2import browserslist from "browserslist";
3import {
4  esbuildPluginBrowserslist,
5  resolveToEsbuildTarget,
6} from "esbuild-plugin-browserslist";
7
8await esbuild.build({
9  entryPoints: ["./foo/bar.ts"],
10  // ... other options (except `target`) ...
11  plugins: [
12    esbuildPluginBrowserslist(browserslist("defaults"), {
13      printUnknownTargets: false,
14    }),
15  ],
16});
17
18// Or:
19
20const target = resolveToEsbuildTarget(browserslist("defaults"), {
21  printUnknownTargets: false,
22});
23
24await esbuild.build({
25  entryPoints: ["./foo/bar.ts"],
26  target,
27});

1const esbuild = require("esbuild");
2const browserslist = require("browserslist");
3const {
4  esbuildPluginBrowserslist,
5  resolveToEsbuildTarget,
6} = require("esbuild-plugin-browserslist");

Caveats

• Only edge, firefox, chrome, safari, ios_saf, and node have direct equivalents for esbuild targets.
• android and and_chr are mapped to the chrome target, and and_ff is mapped to the firefox target.
• All other browsers are ignored (and_qq, samsung, opera, op_mini, op_mob, ie, ie_mob, bb, baidu, and kaios)

Debugging

You can turn on debug logs (which will print all resolutions or failures) using DEBUG=esbuild-plugin-browserslist