browserslist-load-config

Introduction

This package is a fork of browserslist.loadConfig with some modifications to make it faster.

Compare to browserslist, this package has the following improvements and differences:

• 27 times smaller bundle size
• 140 times smaller install size.
• Zero dependencies.
• Written in TypeScript.
• Smaller and faster.
• Does not support env variables.

See bundlephobia - browserslist-load-config vs bundlephobia - browserslist for bundle size comparison.

See packagephobia - browserslist-load-config vs packagephobia - browserslist for install size comparison.

Credits

Thanks Andrey Sitnik for creating the Browserslist which is under MIT License.

Usage

Install:

1npm add browserslist-load-config -D

loadConfig

1import { loadConfig } from "browserslist-load-config";
2
3// Pass a path to the configuration file
4const config = loadConfig({
5  /**
6   * Specify the directory where the configuration file is located
7   */
8  path: "./path/to/project/root",
9
10  /**
11   * Specify the environment to load
12   * @default "production"
13   */
14  env: "production",
15});
16
17// Pass a browserslist config directly
18const config = loadConfig({
19  /**
20   * Specify the directory where the configuration file is located
21   */
22  path: "./path/to/project/root",
23
24  /**
25   * Specify the environment to load
26   * @default "production"
27   */
28  env: "production",
29});
30
31console.log(config);
32/**
33 * [
34 *   // browserslist config
35 * ]
36 */

If both config and path are provided, config will be used.

findConfig

1import { findConfig } from "browserslist-load-config";
2
3const config = findConfig("./path/to/project/root");
4
5console.log(config);
6/**
7 * {
8 *   defaults: [
9 *     // default browserslist config
10 *   ],
11 *   development: [
12 *     // development browserslist config
13 *   ],
14 *   production: [
15 *     // production browserslist config
16 *   ],
17 * }
18 */

License

MIT.