https://github.com/nihalgonsalves/esbuild-plugin-browserslist
Configure esbuild targets based on a browserslist query
https://github.com/nihalgonsalves/esbuild-plugin-browserslist
browserslist esbuild esbuild-plugin javascript typescript
Last synced: about 1 year ago
JSON representation
Configure esbuild targets based on a browserslist query
- Host: GitHub
- URL: https://github.com/nihalgonsalves/esbuild-plugin-browserslist
- Owner: nihalgonsalves
- License: mit
- Created: 2021-04-27T21:34:23.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2025-05-05T21:32:37.000Z (about 1 year ago)
- Last Synced: 2025-05-05T21:50:17.845Z (about 1 year ago)
- Topics: browserslist, esbuild, esbuild-plugin, javascript, typescript
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/esbuild-plugin-browserslist
- Size: 2.44 MB
- Stars: 48
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# esbuild-plugin-browserslist
Configure [esbuild](https://github.com/evanw/esbuild)'s target based on a [browserslist](https://github.com/browserslist/browserslist) query
## Installation
```sh
yarn add esbuild-plugin-browserslist esbuild browserslist
```
## Usage
```ts
import esbuild from "esbuild";
import browserslist from "browserslist";
import {
esbuildPluginBrowserslist,
resolveToEsbuildTarget,
} from "esbuild-plugin-browserslist";
await esbuild.build({
entryPoints: ["./foo/bar.ts"],
// ... other options (except `target`) ...
plugins: [
esbuildPluginBrowserslist(browserslist("defaults"), {
printUnknownTargets: false,
}),
],
});
// Or:
const target = resolveToEsbuildTarget(browserslist("defaults"), {
printUnknownTargets: false,
});
await esbuild.build({
entryPoints: ["./foo/bar.ts"],
target,
});
```
:information_source: CJS usage instructions
Adjust the imports as follows:
```ts
const esbuild = require("esbuild");
const browserslist = require("browserslist");
const {
esbuildPluginBrowserslist,
resolveToEsbuildTarget,
} = 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`