fes.js/docs/zh/guide/plugin.md

插件

插件的 id 和 key

每个插件都会对应一个 id 和一个 key，id 是路径的简写，key 是进一步简化后用于配置的唯一值。

比如插件 /node_modules/@webank/fes-plugin-foo/index.js，通常来说，其 id 为 @webank/fes-plugin-foo，key 为 foo。

启用插件

插件有多种启用方式

package.json 依赖

Fes.js 会自动检测 dependencies 和 devDependencies 里的 fes 插件，比如：

{
  "dependencies": {
    "@webank/fes-plugin-request": "^2.0.0"
  }
}

那么 @webank/fes-plugin-request 会自动被注册，无需在配置里重复声明。

配置

在配置里可通过 presets 和 plugins 配置插件，比如：

export default {
    presets: ['./preset', 'foo/presets'],
    plugins: ['./plugin'],
}

通常用于几种情况：

1. 项目相对路径的插件
2. 非 npm 包入口文件的插件

注意：

• 请不要配置 npm 包的插件，否则会报重复注册的错误

环境变量

还可通过环境变量 FES_PRESETS 和 FES_PLUGINS 注册额外插件。

比如：

$ FES_PRESETS=/a/b/preset.js fes dev

禁用插件

通过配置插件的 key 为 false，比如：

export default {
    mock: false,
}

会禁用 Fes.js 内置的 mock 插件及其功能。

配置插件

通过插件的 key 来配置插件，比如：

export default {
    mock: { 
        prefix: '/v2'
    }
}

这里的 mock 是 mock 插件的 key。