插件 API

核心方法

ServicePluginAPI 里定义的方法。

applyPlugins({ key: string, type: api.ApplyPluginsType, initialValue?: any, args?: any })

取得 register 注册的 hooks 执行后的数据。

e.g.

const foo = await api.applyPlugins({
key: 'foo',
type: api.ApplyPluginsType.add,
initialValue: [],
});
console.log(foo); // ['a', 'b']

describe({ id?: string, key?: string, config?: { default, schema, onChange } })

注册阶段执行,用于描述插件或插件集的 id、key、配置信息、启用方式等。

e.g.

api.describe({
key: 'history',
config: {
default: 'browser',
schema(joi) {
return joi.string();
},
onChange: api.ConfigChangeType.regenerateTmpFiles,
},
enableBy: api.EnableBy.config,
});

注:

  • config.default 为配置的默认值,用户没有配置时取这个
  • config.schema 用于声明配置的类型,基于 joi如果你希望用户进行配置,这个是必须的,否则用户的配置无效
  • config.onChange 是 dev 阶段配置被修改后的处理机制,默认会重启 dev 进程,也可以修改为 api.ConfigChangeType.regenerateTmpFiles 只重新生成临时文件,还可以通过函数的格式自定义
  • enableBy 为启用方式,默认是注册启用,可更改为 api.EnableBy.config,还可以用自定义函数的方式决定其启用时机(动态生效)

register({ key: string, fn: Function, pluginId?: string, before?: string, stage?: number })

api.applyPlugins 注册可供其使用的 hook。

e.g.

// 可同步
api.register({
key: 'foo',
fn() {
return 'a';
},
});
// 可异步
api.register({
key: 'foo',
async fn() {
await delay(100);
return 'b';
},
});

然后通过 api.applyPlugins 即可拿到 ['a', 'b']

const foo = await api.applyPlugins({
key: 'foo',
type: api.ApplyPluginsType.add,
initialValue: [],
});
console.log(foo); // ['a', 'b']

注:

  • fn 支持同步和异步,异步通过 Promise,返回值为 Promise 即为异步
  • fn 里的内容需结合 api.appyPlugins 的 type 参数来看 如果是 api.ApplyPluginsType.add,需有返回值,这些返回值最终会被合成一个数组 如果是 api.ApplyPluginsType.modify,需对第一个参数做修改,并返回 * 如果是 api.ApplyPluginsType.event,无需返回值
  • stage 和 before 都是用于调整执行顺序的,参考 tapable
  • stage 默认是 0,设为 -1 或更少会提前执行,设为 1 或更多会后置执行

registerCommand({ name: string, alias?: string, fn: Function })

注册命令。

e.g.

api.registerCommand({
name: 'generate',
alias: 'g',
fn: async ({ args }) => {
await delay(100);
return `hello ${api.args.projectName}`;
},
});

注:

  • alias 为别名,比如 generate 的别名 g
  • fn 的参数为 { args },args 的格式同 yargs 的解析结果,需要注意的是 _ 里的 command 本身被去掉了,比如执行 umi generate page fooargs._['page', 'foo']

registerMethod({ name: string, fn?: Function, exitsError?: boolean })

往 api 上注册方法。可以是 api.register() 的快捷使用方式,便于调用;也可以不是,如果有提供 fn,则执行 fn 定义的函数。

e.g.

api.registerMethod({
name: 'foo',
fn() { return 'foo'; },
exitsError: false,
});

注:

  • 除 @umijs/preset-build-in 外,通常不建议注册额外的方法,因为没有 ts 提示,直接使用 api.register() 就好
  • exitsError 默认为 true,如果方法存在则报错

registerPresets(presets: string[])

注册插件集,参数为路径数组。

e.g.

api.registerPresets([
{ id: 'preset_2', key: 'preset2', apply: () => () => {} },
require.resolve('./preset_3'),
]);

registerPlugins(plugins: string[])

注册插件,参数为路径数组。

e.g.

api.registerPlugins([
{ id: 'preset_2', key: 'preset2', apply: () => () => {} },
require.resolve('./preset_3'),
]);

hasPlugins(pluginIds: string[])

判断是否有注册某个插件。

插件的 id 规则,

  • id 默认为包名
  • 文件级的插件,如果没有声明 id,默认为 name + 相对路径,比如 @umijs/preset-react/lib/plugins/crossorigin/crossorigin
  • 内置插件以 @@ 为前缀,比如 @@/registerMethod

注:

  • 如果在注册阶段使用,只能判断在他之前是否有注册某个插件

e.g.

// 判断是否有注册 @umijs/plugin-dva
api.hasPlugins(['@umijs/plugin-dva']);

hasPresets(presetIds: string[])

判断是否有注册某个插件集。

插件集的 id 规则,

e.g.

// 判断是否有注册 @umijs/preset-ui
api.hasPresets(['@umijs/preset-ui']);

注:

  • 如果在注册阶段使用,只能判断在他之前是否有注册某个插件集

skipPlugins(pluginIds: string[])

声明哪些插件需要被禁用,参数为插件 id 的数组。

e.g.

// 禁用 plugin-dva 插件
api.skipPlugins(['@umijs/plugin-dva']);

扩展方法

通过 api.registerMethod() 扩展的方法。

addBeforeMiddewares

添加在 webpack compiler 中间件之前的中间件,返回值格式为 express 中间件。

e.g.

api.addBeforeMiddewares(() => {
return (req, res, next) => {
if (false) {
res.end('end');
} else {
next();
}
};
});

addDepInfo

添加依赖信息,包括 semver range 和别名信息。

api.addDepInfo((memo) => {
return {
name: 'foo',
range: pkg.dependencies.foo,
alias: [pathToFooPackage],
};
});

addEntryCode

在入口文件最后添加代码。

e.g.

api.addEntryCode(() => {
return `console.log('works!')`
})

addEntryCodeAhead

在入口文件最前面(import 之后)添加代码。

e.g.

api.addEntryCodeAhead(() => {
return `console.log('works!')`
})

addEntryImports

在入口文件现有 import 的后面添加 import。

e.g.

api.addEntryImport(() => {
return [
{
source: '/modulePath/xxx.js',
specifier: 'moduleName',
}
]
});

addEntryImportsAhead

在入口文件现有 import 的前面添加 import。

e.g.

api.addEntryImportsAhead(() => [{ source: 'anypackage' }]);

addHTMLMetas

在 HTML 中添加 meta 标签。

e.g.

api.addHTMLMetas(() => {
return [{
name: 'keywords',
content: 'umi, umijs'
},
];
});

在 HTML 中添加 Link 标签。

e.g.

api.addHTMLLinks(() => {
return [{
rel: 'shortcut icon',
type: 'image/x-icon',
href: api.config.favicon!,
},
];
});

addHTMLStyles

在 HTML 中添加 Style 标签。

e.g.

api.addHTMLStyles(() => {
return [{
content:`.className { }`
}];
});

addHTMLScripts

在 HTML 尾部添加脚本。

e.g.

api.addHTMLScript(() => {
return [
{
content: '',
src: '',
// ...attrs
},
];
});

addHTMLHeadScripts

在 HTML 头部添加脚本。

e.g.

api.addHTMLHeadScripts(() => {
return [
{
content: '',
src: '',
// ...attrs
},
];
});

addMiddewares

添加在 webpack compiler 中间件之后的中间件,返回值格式为 express 中间件。

e.g.

api.addMiddewares(async (ctx: Context, next: any) => {
// do something before request
await next();
// do something after request
});

addPolyfillImports

添加补充相关的 import,在整个应用的最前面执行。

e.g.

api.addPolyfillImports(() => [{ source: './core/polyfill' }]);

addProjectFirstLibraries

添加以项目依赖为优先的依赖库列表,返回值为 { name: string; path: string }

e.g.

api.addProjectFirstLibraries(() => ({
name: 'antd',
path: dirname(require.resolve('antd/package.json')),
}));

比如:

  • api.addProjectFirstLibraries(() => ({ name: 'antd', path: dirname(require.resolve('antd/package.json')) })),然后用户依赖 antd 时,如果项目有依赖 antd,会用项目依赖的 antd,否则用内置的 antd

addRuntimePlugin

添加运行时插件,返回值格式为表示文件路径的字符串。

e.g.

api.addRuntimePlugin(() => join(__dirname, './runtime'));

addRuntimePluginKey

添加运行时插件的 key,返回值格式为字符串。

e.g.

api.addRuntimePluginKey(() => 'some');

内置的初始值有:

  • patchRoutes
  • rootContainer
  • render
  • onRouteChange

addUmiExports

添加需要 umi 额外导出的内容,返回值格式为 { source: string, specifiers?: (string | { local: string, exported: string })[], exportAll?: boolean }

比如 api.addUmiExports(() => { source: 'dva', specifiers: ['connect'] }),然后就可以通过 import { connect } from 'umi' 使用 dvaconnect 方法了。

addTmpGenerateWatcherPaths

添加重新临时文件生成的监听路径。

e.g.

api.addTmpGenerateWatcherPaths(() => [
'./app.ts',
]);

chainWebpack(config, { webpack })

通过 webpack-chain 的方式修改 webpack 配置。

比如:

api.chainWebpack((config, { webpack, env, createCSSRule }) => {
// Set alias
config.resolve.alias.set('a', 'path/to/a');
// Delete progress bar plugin
config.plugins.delete('progress');
return config;
});

注:

  • 需要有返回值

getPort()

获取端口号,dev 时有效。

e.g.

const Port = api.getPort()

getHostname()

获取 hostname,dev 时有效。

e.g.

const hostname = api.getHostname()

modifyBabelOpts

修改 babel 配置项。

e.g.

api.modifyBabelOpts(babelOpts => {
const hmr = api.config.dva?.hmr;
if (hmr) {
const hmrOpts = lodash.isPlainObject(hmr) ? hmr : {};
babelOpts.plugins.push([
require.resolve('babel-plugin-dva-hmr'),
hmrOpts,
]);
}
return babelOpts;
});

modifyBabelPresetOpts

修改 @umijs/babel-preset-umi 的配置项。

e.g.

api.modifyBabelPresetOpts(opts => {
return {
...opts,
import: (opts.import || []).concat([
{ libraryName: 'antd', libraryDirectory: 'es', style: true },
{ libraryName: 'antd-mobile', libraryDirectory: 'es', style: true },
]),
};
});

modifyBundleConfig

修改 bundle 配置。

e.g.

api.modifyBundleConfig((bundleConfig, { env, type, bundler: { id } }) => {
// do something
return bundleConfig;
});

参数:

  • initialValue:bundleConfig,可能是 webpack 的配置,通过 bundler.id 区分
  • args type:现在有两个,ssr 和 csr env:即 api.env * bundler:包含 id 和 version,比如:{ id: 'webpack': version: 4 }

modifyBundleConfigs

修改 bundle 配置数组,比如可用于 dll、modern mode 的处理。

e.g.

api.modifyBundleConfigs(async (memo, { getConfig }) => {
return [...memo];
});

参数:

  • args getConfig():用于获取额外的一份配置 env:即 api.env * bundler:包含 id 和 version,比如:{ id: 'webpack': version: 4 }

modifyBundleConfigOpts

修改获取 bundleConfig 的函数参数。

e.g.

api.modifyBundleConfigOpts(memo => {
memo.miniCSSExtractPluginPath = require.resolve('mini-css-extract-plugin');
memo.miniCSSExtractPluginLoaderPath = require.resolve(
'mini-css-extract-plugin/dist/loader',
);
return memo;
});

modifyBundleImplementor

比如用于切换到 webpack@5 或其他。

e.g.

import webpack from 'webpack';
// 换成 webpack@5
api.modifyBundleImplementor(() => {
return webpack;
});

modifyBundler

比如用于切换到 parcel 或 rollup 做构建。

e.g.

api.modifyBundler(() => {
return require('@umijs/bundler-rollup').Bundler;
});

modifyConfig

修改最终配置。

e.g.

api.modifyConfig((memo) => {
return {
...memo,
...defaultOptions,
};
});

注:

  • 修改后的值不会再做 schema 校验

modifyDefaultConfig

修改默认配置。

e.g.

api.modifyDefaultConfig((memo) => {
return {
...memo,
...defaultOptions,
};
});

modifyHTML

修改 HTML,基于 cheerio 的 ast。

e.g.

api.modifyHTML(($, { routs }) => {
$('h2').addClass('welcome');
return $;
});

modifyHTMLChunks

修改 html 中的js文件引入,可以用于不同的页面使用,不同的 chunks 配置。

e.g.

api.modifyHTMLChunks(async (memo, opts) => {
const { route } = opts;
// do something
return memo;
});

modifyExportRouteMap 3.2+

修改导出路由对象 routeMap(路由与输出 HTML 的映射关系),触发时机在 HTML 文件生成之前,默认值为 [{ route: { path: '/' }, file: 'index.html' }]

参数:

  • html:HTML 工具类实例

注:

  • 只在 umi build 时起效

例如 exportStatic 插件根据路由生成对应 HTML:

api.modifyExportRouteMap(async (defaultRouteMap, { html }) => {
return await html.getRouteMap();
});

modifyDevHTMLContent 3.2+

umi dev 时修改输出的 HTML 内容。

参数:

  • req:Request 对象,可获取当前访问路径

例如希望 /404 路由直接返回 Not Found

api.modifyDevHTMLContent(async (defaultHtml, { req }) => {
if (req.path === '/404') {
return 'Not Found';
}
return defaultHtml;
})

modifyProdHTMLContent 3.2+

umi build 时修改输出的 HTML 内容。

参数(相当于一个 RouteMap 对象):

  • route:路由对象
  • file:输出 HTML 名称

例如可以在生成 HTML 文件前,做预渲染:

api.modifyProdHTMLContent(async (content, args) => {
const { route } = args;
const render = require('your-renderer');
return await render({
path: route.path,
})
});

modifyPaths

修改 paths 对象。

e.g.

api.modifyPaths(async (paths) => {
return memo;
});

参数:

  • initialValue: paths 对象

modifyRendererPath

修改 renderer 路径,用于使用自定义的 renderer。

e.g.

api.modifyRendererPath(() => {
return dirname(require.resolve('@umijs/renderer-mpa/package.json'));
});

modifyPublicPathStr

修改 publicPath 字符串。

e.g.

api.modifyPublicPathStr(() => {
return api.config.publicPath || '/';
});

参数:

  • route: 当前路由

注:

  • 仅在配置了 runtimePublicPath 或 exportStatic?.dynamicRoot 时有效

modifyRoutes

修改路由。

e.g.

api.modifyRoutes((routes: any[]) => {
return resetMainPath(routes, api.config.mainPath);
});

onPatchRoute({ route, parentRoute })

修改路由项。

e.g.

api.onPatchRoute(({ route }) => {
if (!api.config.exportStatic?.htmlSuffix) return;
if (route.path) {
route.path = addHtmlSuffix(route.path, !!route.routes);
}
});

onPatchRouteBefore({ route, parentRoute })

修改路由项。

e.g.

api.onPatchRouteBefore(({ route }) => {
if (!api.config.exportStatic?.htmlSuffix) return;
if (route.path) {
route.path = addHtmlSuffix(route.path, !!route.routes);
}
});

onPatchRoutes({ routes, parentRoute })

修改路由数组。

e.g.

api.onPatchRoutes(({ routes }) => {
// copy / to /index.html
let rootIndex = null;
routes.forEach((route, index) => {
if (route.path === '/' && route.exact) {
rootIndex = index;
}
});
if (rootIndex !== null) {
routes.splice(rootIndex, 0, {
...routes[rootIndex],
path: '/index.html',
});
}
});

onPatchRoutesBefore({ routes, parentRoute })

修改路由数组。

e.g.

api.onPatchRoutesBefore(({ routes }) => {
// copy / to /index.html
let rootIndex = null;
routes.forEach((route, index) => {
if (route.path === '/' && route.exact) {
rootIndex = index;
}
});
if (rootIndex !== null) {
routes.splice(rootIndex, 0, {
...routes[rootIndex],
path: '/index.html',
});
}
});

onBuildComplete({ err?, stats? })

构建完成时可以做的事。

e.g.

api.onBuildComplete(({ err }) => {
if (!err) {
// do something
}
});

注:

  • 可能是失败的,注意判断 err 参数

onDevCompileDone({ isFirstCompile: boolean, stats: webpack.Stats })

编译完成时可以做的事。

e.g.

api.onDevCompileDone(({ stats, type }) => {
// don't need ssr bundler chunks
if (type === BundlerConfigType.ssr) {
return;
}
// store client build chunks
sharedMap.set('chunks', stats.compilation.chunks);
});

注:

  • 不包含编译失败

onGenerateFiles

生成临时文件,触发时机在 webpack 编译之前。

e.g.

api.onGenerateFiles(() => {
api.writeTmpFile({
path: 'any.ts',
content: '',
});
});

onPluginReady()

在插件初始化完成触发。在 onStart 之前,此时还没有 config 和 paths,他们尚未解析好。

e.g.

api.onPluginReady(() => {
// do something
});

onStart()

在命令注册函数执行前触发。可以使用 config 和 paths。

e.g.

api.onStart(() => {
// do something
});

onExit()

dev 退出时触发。

e.g.

api.onExit(() => {
// do something
});

参数:

  • signal: 值为 SIGINT、SIGQUIT 或 SIGTERM

注:

  • 只针对 dev 命令有效

writeTmpFile({ path: string, content: string, skipTSCheck?: boolean })

写临时文件。

e.g.

api.onGenerateFiles(() => {
api.writeTmpFile({
path: 'any.ts',
content: '',
});
});

参数:

  • path:相对于临时文件夹的路径
  • content:文件内容
  • skipTSCheck:默认为 truepath 为 ts 或 tsx 文件,不检查 TypeScript 类型错误,如果希望插件对用户项目进行 TypeScript 类型检查,可以设置为 false

注:

  • 不能在注册阶段使用,通常放在 api.onGenerateFiles() 里,这样能在需要时重新生成临时文件
  • 临时文件的写入做了缓存处理,如果内容一致,不会做写的操作,以减少触发 webpack 的重新编译

属性

args

命令行参数。

babelRegister.setOnlyMap({ key: string, value: string[] })

设置需要走 babel 编译的文件列表。

注:

  • 如果有 watch 操作,每次重复设置时请保持 key 相同

config

用户配置。

注:

  • 注册阶段不能获取到,所以不能在外面 const { config } = api; 然后在函数体里使用,而是需要在里面通过 api.paths.cwd 使用

cwd

当前路径。

env

即 process.env.NODE_ENV,可能有 developmentproductiontest

比如,

  • 命令行 umi dev --foo,args 为 { _: [], foo: true }
  • 命令行 umi g page index --typescript --less,args 为 { _: ['page', 'index'], typescript: true, less: true }

id

插件 id,通常是包名。

logger

插件日志类,包含 api.logger.(log|info|debug|error|warn|profile)

其中 api.logger.profile 可用于性能耗时记录,例如:

export default api => {
api.logger.profile('barId');
setTimeout(() => {
api.logger.profile('barId');
});
};
// => [PROFILE] Completed in *ms

key

插件的配置 key,通常是包名的简写。

比如 @umijs/plugin-dva,其 key 为 dva;比如 umi-plugin-antd,其 key 为 antd

paths

相关路径,包含:

  • cwd,当前路径
  • absSrcPath,src 目录绝对路径,需注意 src 目录是可选的,如果没有 src 目录,absSrcPath 等同于 cwd
  • absPagesPath,pages 目录绝对路径
  • absTmpPath,临时目录绝对路径
  • absOutputPath,输出路径,默认是 ./dist
  • absNodeModulesPath,node_modules 目录绝对路径
  • aliasedTmpPath,以 @ 开头的临时路径,通常用于

注:

  • 注册阶段不能获取到,所以不能在外面 const { paths } = api; 然后在函数体里 paths.cwd 使用,而是需要在里面通过 api.paths.cwd 使用

pkg

当前项目的 package.json,格式为 Object。

service

Service 实例。通常不需要用到,除非你知道为啥要用。

stage

Service 运行阶段。

userConfig

纯用户配置,就是 .umircconfig/config 里的内容,没有经过 defaultConfig 以及插件的任何处理。

注:

  • 和 config 的区别是,可以在注册阶段取到

utils

utils 方法,详见 @umijs/utils/src/index.ts。 包含外部库:

  • lodash : 导出自 lodash, 实用的 js 工具库。
  • got : 导出自 got, 轻量级的请求库。
  • deepmerge : 导出自 deepmerge, 将两个对象的可以枚举属性深度合并。
  • semver : 导出自 semver, 用于实现版本号的解析和比较,规范版本号的格式。常见于版本过低提示用户升级等场景。
  • Mustache : 导出自 mustache, 无逻辑的模版语法,是 JavaScript 中的 mustache 模板系统的零依赖实现。
  • address : 导出自 address, 用于获取当前计算机的 IP ,MAC 和 DNS 服务器地址等。
  • cheerio : 导出自 cheerio, 用于方便的处理爬取到的网页内容,在服务端对 DOM 结构进行方便的操作。
  • clipboardy : 导出自 clipboardy, 用于对剪贴板内容写入与读取的处理。
  • chokidar : 导出自 chokidar, 用于监听文件的变化。
  • createDebug, Debugger : 导出自 debug, 用于控制调试日志的输出。
  • chalk : 导出自 chalk, 常用于在终端中输出彩色文字,支持链式调用,能够设置文本样式、颜色、背景色等。
  • signale : 导出自 signale, 用于日志记录、状态报告以及处理其他 Node 模块和应用的输出渲染方式。
  • portfinder : 导出自 portfinder, 常用于在判断端口是否被占用或者获取没有被占用的端口等场景。
  • glob : 导出自 glob, 用于获取匹配对应规则的文件。
  • pkgUp : 导出自 pkg-up, 查找最近的 package.json 文件。
  • resolve : 导出自 resolve, 实现了 node 的 require.resolve() 算法, 提供了方便处理获取模块完整路径相关需求的方法。
  • spawn : 导出自 cross-spawn , 已经封装好了 Node.js 子进程(child_process)模块下 spawn 函数的跨平台写法的相关细节, 直接使用其调用系统上的命令如 npm 即可。
  • execa: 导出自 execa, 更好的子进程管理工具。相当于衍生一个 shell,传入的 command 字符串在该 shell 中直接处理。
  • mkdirp : 导出自 mkdirp, node 中 mkdir -p 功能的实现, 用于在 Node.js 中递归式创建目录及其子目录。
  • rimraf : 导出自 rimraf, node 中 rm -rf 功能的实现,
  • yargs : 导出自 yargs, 用于创建交互式命令行工具,能够方便的处理命令行参数。
  • yParser : 导出自 yargs-parser, yargs 使用的强大 option 解析器, 用于解析命令行参数。
  • parser : 导出自 @babel/parser, 解析代码生成 AST 抽象语法树。
  • traverse : 导出自 @babel/traverse, 对 AST 节点进行递归遍历。
  • t : 导出自 @babel/types, 用于 AST 节点的 Lodash 式工具库。它包含了构造、验证以及变换 AST 节点的方法。 该工具库包含考虑周到的工具方法,对编写处理 AST 逻辑非常有用。

内部工具方法

  • isBrowser, 判断是否在浏览器环境。
  • isWindows, 判断当前是否是 windows 系统。
  • isSSR, whether SSR success in client。
  • isLernaPackage, 判断是否存在 lerna.json 文件。
  • winPath, 将文件路径转换为兼容 window 的路径,用于在代码中添加 require('/xxx/xxx.js') 之类的代码。
  • winEOL, 在 windows 环境下,很多工具都会把换行符 lf 自动改成 crlf, 为了测试精准需要将换行符转化一下。
  • compatESModuleRequire, 兼容 ESModule 以及 Require 为 Require。
  • mergeConfig, 对象合并。
  • randomColor, 随机生成颜色。
  • delay, 延迟函数。
  • Generator, mustache 模版代码生成。
  • BabelRegister, @babel/register 的简易封装。
  • parseRequireDeps, 获取特定文件的本地依赖。
  • cleanRequireCache, 清理特定 Module 在 require cache 以及 parent.children 中的引用。
  • getWindowInitialProps, 获取 window.g_initialProps。
  • getFile, 获取特定目录中文件的完整扩展名,javascript 文件的匹配顺序 ['.ts', '.tsx', '.js', '.jsx'],css 文件的匹配顺序 ['.less', '.sass', '.scss', '.stylus', '.css']
  • routeToChunkName, transform route component into webpack chunkName。

类型

  • ArgsType<T extends (...args: any[]) => any>, 获取函数参数数组类型。
  • PartialKeys<T>, 找出 T 中类型是 undefined 的 key。
  • PartialProps<T>, 取出 T 中类型是 undefined 的属性。
  • NodeEnv: 联合类型 'development' | 'production' | 'test'。
  • Omit<T, U>, 排除 T 中的 U key。

注:

  • 原则上同类功能的方法不允许使用其他的,以降低整体尺寸,比如请求用 got,参数处理用 yargs
  • 编写插件时,除了 api.utils,还可通过 import { utils } from 'umi' 取到,通常用于非插件主入口的文件

ApplyPluginsType

api.applyPlugins() 提供 type 参数的类型,包含三种:

  • add
  • modify
  • event

ConfigChangeType

api.describe() 提供 config.onChange 的类型,目前包含两种:

  • restart,重启 dev 进程,默认是这个
  • regenerateTmpFiles,重新生成临时文件

EnableBy

插件的启用方式,包含三种,

  • register
  • config
  • Function

Html

ServiceStage

stage 的枚举类型,通常用于和 stage 的比较。

环境变量

可以用到的环境变量。

  • UMI_VERSION,umi 版本号
  • UMI_DIR,umi/package.json 所在的文件夹路径