@chialab/esbuild-plugin-alias

中文文档
0.17.2发布于 2022/12/13MITTypeScriptES Module近 30 天下载 3074

A plugin for esbuild that resolves aliases or empty modules.

原始使用文档
文档目录3 节
  1. Install
  2. Usage
  3. License

Esbuild Plugin Alias • A plugin for esbuild that resolves aliases or empty modules.

NPM


Install

$ npm i @chialab/esbuild-plugin-alias -D
$ yarn add @chialab/esbuild-plugin-alias -D

Usage

Load path-browser.js instead of the node's path module:

import esbuild from 'esbuild';
import aliasPlugin from '@chialab/esbuild-plugin-alias';

await esbuild.build({
    plugins: [
        aliasPlugin({
            'node-fetch': false,
            'path': '../path-browser.js'
        }),
    ],
});

Load node-fetch module as an empty module:

import esbuild from 'esbuild';
import aliasPlugin from '@chialab/esbuild-plugin-alias';

await esbuild.build({
    plugins: [
        aliasPlugin({
            'node-fetch': false,
        }),
    ],
});

Load aliases from browser field in package.json:

package.json

{
    "name": "webapp",
    "version": "0.0.0",
    "browser": {
        "path": "./browser-path.js",
        "node-fetch": false,
    }
}
import esbuild from 'esbuild';
import aliasPlugin from '@chialab/esbuild-plugin-alias';

await esbuild.build({
    platform: 'browser',
    plugins: [
        aliasPlugin(),
    ],
});

License

Esbuild Plugin alias is released under the MIT license.

版本与发布记录

@chialab/esbuild-plugin-alias 共发布 65 个版本,首次发布于 2021/05/11;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.17.2latest2022/12/133 年前
0.17.12022/10/314 年前
0.16.42022/08/264 年前
0.17.02022/08/234 年前
0.16.32022/07/274 年前
0.16.22022/07/264 年前

其他发布通道:beta → 0.14.4。

关于 @chialab/esbuild-plugin-alias 的常见问题

@chialab/esbuild-plugin-alias 是什么?

A plugin for esbuild that resolves aliases or empty modules.

如何安装 @chialab/esbuild-plugin-alias?

在项目目录运行 npm install @chialab/esbuild-plugin-alias,或使用 pnpm add / yarn add / bun add。

@chialab/esbuild-plugin-alias 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chialab/esbuild-plugin-alias 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@chialab/esbuild-plugin-alias 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=13。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@chialab/esbuild-plugin-alias 可以商用吗?

@chialab/esbuild-plugin-alias 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chialab/esbuild-plugin-alias 的下载量有多少?

根据 npm 官方下载统计,@chialab/esbuild-plugin-alias 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,074 次,日均约 102 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chialab/esbuild-plugin-alias 还在维护吗?

最新版本 0.17.2 发布于 2022/12/13(3 年前);至今共发布 65 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/05/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。