From fbee37fc2a6c509974ba7c2da5df25e26d5aed54 Mon Sep 17 00:00:00 2001 From: wanchun <445436867@qq.com> Date: Sat, 6 Mar 2021 16:09:22 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20jest=E6=8F=92=E4=BB=B6=E3=80=81?= =?UTF-8?q?=E8=BF=90=E8=A1=8C=E6=97=B6=E9=85=8D=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/.vuepress/config.ts | 2 + docs/.vuepress/configs/sidebar/en.ts | 2 + docs/.vuepress/configs/sidebar/zh.ts | 2 + docs/README.md | 10 +- docs/guide/config.md | 52 +-- docs/guide/css.md | 27 ++ docs/guide/mock.md | 2 +- docs/guide/route.md | 2 +- docs/guide/runtime-config.md | 139 ++++++++ docs/reference/plugin/plugins/jest.md | 351 ++++++++++++++++++++- docs/reference/plugin/plugins/locale.md | 2 +- docs/zh/README.md | 10 +- docs/zh/guide/config.md | 52 +-- docs/zh/guide/css.md | 27 ++ docs/zh/guide/mock.md | 2 +- docs/zh/guide/route.md | 2 +- docs/zh/guide/runtime-config.md | 139 ++++++++ docs/zh/reference/plugin/plugins/jest.md | 351 ++++++++++++++++++++- docs/zh/reference/plugin/plugins/locale.md | 2 +- 19 files changed, 1122 insertions(+), 54 deletions(-) create mode 100644 docs/guide/css.md create mode 100644 docs/guide/runtime-config.md create mode 100644 docs/zh/guide/css.md create mode 100644 docs/zh/guide/runtime-config.md diff --git a/docs/.vuepress/config.ts b/docs/.vuepress/config.ts index 750d966b..18b1b3a0 100644 --- a/docs/.vuepress/config.ts +++ b/docs/.vuepress/config.ts @@ -30,6 +30,8 @@ const config: UserConfig = { docsDir: 'docs', + docsBranch: 'vue3', + // theme-level locales config locales: { /** diff --git a/docs/.vuepress/configs/sidebar/en.ts b/docs/.vuepress/configs/sidebar/en.ts index 307af7c2..75ca9764 100644 --- a/docs/.vuepress/configs/sidebar/en.ts +++ b/docs/.vuepress/configs/sidebar/en.ts @@ -16,11 +16,13 @@ export const en: SidebarConfig = { children: [ '/guide/directory-structure.md', '/guide/config.md', + '/guide/runtime-config.md', '/guide/route.md', '/guide/plugin.md', '/guide/template.md', '/guide/mock.md', '/guide/env.md', + '/guide/css.md', ] }, { diff --git a/docs/.vuepress/configs/sidebar/zh.ts b/docs/.vuepress/configs/sidebar/zh.ts index 28bf909c..a264f047 100644 --- a/docs/.vuepress/configs/sidebar/zh.ts +++ b/docs/.vuepress/configs/sidebar/zh.ts @@ -16,11 +16,13 @@ export const zh: SidebarConfig = { children: [ '/zh/guide/directory-structure.md', '/zh/guide/config.md', + '/zh/guide/runtime-config.md', '/zh/guide/route.md', '/zh/guide/plugin.md', '/zh/guide/template.md', '/zh/guide/mock.md', '/zh/guide/env.md', + '/zh/guide/css.md', ] }, { diff --git a/docs/README.md b/docs/README.md index 4ce085d6..32b6fa76 100644 --- a/docs/README.md +++ b/docs/README.md @@ -11,15 +11,17 @@ actions: type: secondary features: - title: Fast - details: Fes内置了路由、开发、构建等，并且提供测试、布局、权限、国际化、状态管理、API请求、数据字典、SvgIcon等插件，可以满足大部分日常开发需求。 + details: Fes.js 内置路由、构建、插件管理，提供测试、布局、权限、国际化、状态管理、请求、数据字典、Svg等插件，可以满足大部分日常开发需求。 - title: Easy - details: 基于Vue.js 3.0，上手简单。贯彻“约定优于配置”思想，设计插件上尽可能用约定替代配置，同时提供统一的插件配置入口，简单简洁又不失灵活。提供一致性的API入口，一致化的体验，学习起来更轻松。 + details: 基于Vue.js 3.0，上手简单。贯彻 “约定优于配置” 思想，在设计插件上尽可能用约定替代配置，依然提供统一的插件配置入口，简单简洁又不失灵活。提供一致性的API入口，一致化的体验，学习起来更轻松。 - title: Strong - details: 只需要关心页面内容，减少犯错的机会！提供单元测试、覆盖测试的能力保障项目质量。 + details: 仅仅需要关心页面内容，减少犯错的机会！提供单元测试、覆盖测试的能力保障项目质量。 - title: 可扩展 - details: 借鉴Umi实现了完整的生命周期和插件化机制，插件可以管理项目的编译时和运行时，能力均可以通过插件封装进来，在 Fes.js 中协调有序的运行。 + details: 借鉴 UMI 实现完整的生命周期和插件化机制，插件可以管理项目的编译时和运行时，能力均可以通过插件封装进来，在 Fes.js 中协调有序的运行。 - title: 面向未来 details: 在满足需求的同时，我们也不会停止对新技术的探索。已使用Vue3.0来提升应用性能，已使用webpack5提升构建性能和实现微服务，未来会探索vite等新技术。 + - title: 令人愉悦 + details: 我们的主要重点是开发人员体验。我们喜欢 Fes.js，并且会不断改进框架，所以您也喜欢它！期待有吸引力的解决方案，描述性的错误消息，强大的默认值和详细的文档。如果有问题或疑问，我们有用的社区将为您提供帮助。 footer: MIT Licensed | Copyright © 2020-present Webank --- diff --git a/docs/guide/config.md b/docs/guide/config.md index 206bc963..f6d8912d 100644 --- a/docs/guide/config.md +++ b/docs/guide/config.md @@ -1,6 +1,7 @@ # 配置 Fes.js 约定 `.fes.js` 文件为项目基础配置文件，一份常见的配置示例如下： + ```js export default { base: '/foo/', @@ -34,8 +35,8 @@ export default { } ``` -## 配置文件 -可以新建 `.fes.local.js` 作为本地临时配置文件。这份配置会和 `.fes.js` 做 deep merge 后形成最终配置。 +## 本地临时配置文件 +可以新建 `.fes.local.js` 作为本地临时配置文件。这份配置会和 `.fes.js` 做 `deep merge` 后形成最终配置。 ```js // .fes.js export default { mock: false }; @@ -54,26 +55,39 @@ export default { }; ``` ::: tip -`.fes.local.js` 仅在 fes dev 时有效。 - -`.fes.local.js` 是本地验证使用的临时配置，请将其添加到 `.gitignore`，务必不要提交到 git 仓库中。 - -`.fes.local.js` 配置的优先级最高，比 `FES_ENV` 指定的配置更高。 +`.fes.local.js` 是本地验证使用的临时配置，仅在 `fes dev` 时有效，请将其添加到 `.gitignore`，务必不要提交到 `git` 仓库中。 ::: ## 多环境多份配置 -可以通过环境变量 `FES_ENV` 区分不同环境，来指定配置文件。 -```js - // .fes.js - export default { mock: false }; +可以通过环境变量 `FES_ENV` 区分不同环境，来指定当前环境的配置文件，这份配置会和 `.fes.js` 做 `deep merge` 后形成最终配。 - // .fes.local.js - export default { - mock: true, - dvServer: { port: 8080 } - }; +比如配置如下： +```js +// .fes.js +export default { mock: false }; + +// .fes.uat.js +export default { + mock: true, + dvServer: { port: 8080 } +}; ``` -根据指定的 `FES_ENV` 拿对应的配置，这份配置会和 `.fes.js` 做 deep merge 后形成最终配。 +当我们运行： +```bash +FES_ENV=uat fes dev +``` +这时候会命中 `.fes.uat.js` 这份环境配置，最终配置是： +```js +{ + mock: true, + devServer: { port: 8080 } +}; +``` + +## 优先级 + +本地临时配置 > 环境配置 > 基础配置 + ::: tip -`FES_ENV` 指定的配置优先级高于 `.fes.js` 文件的配置 -::: \ No newline at end of file +如果多份配置中存在相同的配置项，**则优先级高的会覆盖优先级低的**。 +::: diff --git a/docs/guide/css.md b/docs/guide/css.md new file mode 100644 index 00000000..e5968698 --- /dev/null +++ b/docs/guide/css.md @@ -0,0 +1,27 @@ +# 样式 + +:::tip +本文档以 css 为示例，把后缀换成 `.less` 同样适用。 +::: + +## 全局样式 +Fes.js 中约定 `src/global.css` 为全局样式，如果存在此文件，会被自动引入到入口文件最前面。 + +比如用于覆盖样式， +```css +.layout-content { + max-width: 1000px; +} +``` + +## Vue单文件 +```vue + +``` + +## CSS 预处理器 +Fes.js 内置支持 `less`，不支持 `sass` 和 `stylus`，但如果有需求，可以通过 `chainWebpack` 配置或者 `fes-plugin` 插件的形式支持。 \ No newline at end of file diff --git a/docs/guide/mock.md b/docs/guide/mock.md index a2147e6c..789e3d33 100644 --- a/docs/guide/mock.md +++ b/docs/guide/mock.md @@ -17,7 +17,7 @@ Fes.js 约定 `src/mock.js` 为 mock 文件。 ## 编写 Mock 文件 -可以参考如下例子： +可以参考如下 🌰： ``` js module.exports = function ({ cgiMock, mockjs, utils }) { const { Random } = mockjs; diff --git a/docs/guide/route.md b/docs/guide/route.md index d684ca77..642929d8 100644 --- a/docs/guide/route.md +++ b/docs/guide/route.md @@ -182,7 +182,7 @@ const router = new VueRouter({ ] }) ``` -在 Fes.js 里约定在 `.vue` 文件中的 `config` 为 `meta` 配置。如果 `pages/a.vue` 中有如下配置： +在 Fes.js 里约定在 `.vue`单文件组件中的 `config`区块 为 `meta` 配置。如果 `pages/a.vue` 中有如下配置： ```vue { diff --git a/docs/guide/runtime-config.md b/docs/guide/runtime-config.md new file mode 100644 index 00000000..80dd36a0 --- /dev/null +++ b/docs/guide/runtime-config.md @@ -0,0 +1,139 @@ +# 运行时配置 + +运行时配置和配置的区别是他跑在浏览器端，基于此，我们可以在这里写函数、`import` 浏览器端依赖等等，注意不要引入 `node` 依赖。 + +## 配置方式 +约定 `src/app.js` 为运行时配置。运行时配置的类型有三种，具体查看[applypluginstype](../reference/api/#applypluginstype)。 + +## 配置项 + +### beforeRender(lastOpts) + +在渲染之前执行，执行`action`过程中显示 `loading` 配置的组件，执行结果作为参数 `initialState` 传给 `modifyClientRenderOpts`。 + +示例： +```js +// app.js +import { access } from '@fesjs/fes'; +import PageLoading from '@/components/PageLoading'; +import UserCenter from '@/components/UserCenter'; + +export function beforeRender(lastOpts) { + return { + ...lastOpts, + loading: , + action() { + const { setRole } = access; + return new Promise((resolve) => { + setTimeout(() => { + setRole('admin'); + resolve({ + userName: 'harrywan' + }); + }, 1000); + }); + } + } +}; +``` + +### patchRoutes({routes }) +修改路由。 + +比如在最前面添加一个 /foo 路由： +``` +export function patchRoutes({ routes }) { + routes.unshift({ + path: '/foo', + component: require('@/extraRoutes/foo').default, + }); +} +``` +:::tip +直接修改 `routes`, 不需要返回 +::: + +### modifyClientRenderOpts(lastOpts) +修改 `clientRender` 参数。参数是一个对象： +- routes，路由配置信息 +- rootElement， 渲染的根节点，默认是 `#app`，可通过配置 `mountElementId` 修改。 +- initialState， 初始化数据，`beforeRender` 运行得到的数据。 + +比如在微前端里动态修改渲染根节点： +```js +let isSubApp = false; +export function modifyClientRenderOpts(lastOpts) { + return { + ...lastOpts, + rootElement: isSubApp ? 'sub-root' : lastOpts.rootElement, + }; +} +``` + +### rootContainer(LastRootContainer, args) +修改交给 Vue 渲染时的根组件，默认是 ``。 + +- LastRootContainer，上一个插件修改后的结果。 +- args，包含： + - routes，全量路由配置 + - plugin，运行时插件机制 + +比如在可以包一层DIV： +```js +export function rootContainer(container) { + return () => () => { + return ( +
+ +
+ ) + } +} + +``` + +### onAppCreated({app}) +创建 app 实例后触发。 + +比如用于安装 Vue 插件： +```js +import { createRouter } from "vue-router"; + +export function onAppCreated({ app }) { + const router = createRouter(); + app.use(router); +} + +``` + +### render(oldRender: Function) +覆写 render。 + +比如用于渲染之前做权限校验: +```js +import { history } from 'umi'; + +export function render(oldRender) { + fetch('/api/auth').then(auth => { + if (auth.isLogin) { oldRender() } + else { + history.push('/login'); + oldRender() + } + }); +} +``` + + + +### onRouterCreated({router}) +生成router时触发。 + +比如用于收集切换路由的记录： +```js +export function onRouterCreated({ router }) { + router.afterEach((to, from) => { + console.log(to) + }); +} +``` diff --git a/docs/reference/plugin/plugins/jest.md b/docs/reference/plugin/plugins/jest.md index eaaa5f85..af11dc31 100644 --- a/docs/reference/plugin/plugins/jest.md +++ b/docs/reference/plugin/plugins/jest.md @@ -1,6 +1,355 @@ # @fesjs/plugin-jest + +集成 [Jest](https://www.jestjs.cn/) 测试框架，目前只支持单元测试和覆盖测试。 + ## 启用方式 +在 `package.json` 中引入依赖： +```json +{ + "dependencies": { + "@fesjs/fes": "^2.0.0", + "@fesjs/plugin-jest": "^2.0.0" + }, +} +``` + +## 约定 + +- 项目根目录下 `tests` 和 `__tests__` 文件夹中的 `js` 或者 `jsx` 文件为测试文件。 +- 需要覆盖测试的文件范围是`src/index.{js,jsx,ts,tsx,vue}` + +例如测试文件 `add.js`： +``` +fes-template +├── __tests__ +│ └── add.js +└── src + ├── .fes + └── utils + └── sum.js +``` +内容如下： +```js +import sum from '@/utils/sum'; +test('adds 1 + 2 to equal 3', () => { + expect(sum(1, 2)).toBe(3); +}); + +``` + +## 命令 +在 `fes` 上注册 `test` 命令： +```bash +$ fes test +``` ## 配置 +插件实现 Jest 的全部配置，具体请查看 [文档-configuration](https://www.jestjs.cn/docs/configuration#reference)。 也可以使用 `-h` 打印配置帮助信息： -## 命令 \ No newline at end of file +### args 变量 + +```bash +$ fes test -h +``` +打印配置帮助信息: +``` +$ fes test -h +Usage: fes test [options] + +run unit tests with jest + +Options: + --all The opposite of `onlyChanged`. If `onlyChanged` + is set by default, running jest with `--all` + will force Jest to run all tests instead of + running only tests related to changed files. + --automock Automock all files by default. + -b --bail Exit the test suite immediately after `n` + number of failing tests. + --browser Respect the "browser" field in package.json + when resolving modules. Some packages export + different versions based on whether they are + operating in node.js or a browser. + --cache Whether to use the transform cache. Disable the + cache using --no-cache. + --cacheDirectory The directory where Jest should store its + cached dependency information. + --changedFilesWithAncestor Runs tests related to the current changes and + the changes made in the last commit. Behaves + similarly to `--onlyChanged`. + --changedSince Runs tests related to the changes since the + provided branch. If the current branch has + diverged from the given branch, then only + changes made locally will be tested. Behaves + similarly to `--onlyChanged`. + --ci Whether to run Jest in continuous integration + (CI) mode. This option is on by default in most + popular CI environments. It will prevent + snapshots from being written unless explicitly + requested. + --clearCache Clears the configured Jest cache directory and + then exits. Default directory can be found by + calling jest --showConfig + --clearMocks Automatically clear mock calls and instances + between every test. Equivalent to calling + jest.clearAllMocks() between each test. + --collectCoverage Alias for --coverage. + --collectCoverageFrom A glob pattern relative to matching + the files that coverage info needs to be + collected from. + --collectCoverageOnlyFrom Explicit list of paths coverage will be + restricted to. + --color Forces test results output color highlighting + (even if stdout is not a TTY). Set to false if + you would like to have no colors. + --colors Alias for `--color`. + -c --config The path to a jest config file specifying how + to find and execute tests. If no rootDir is set + in the config, the directory containing the + config file is assumed to be the rootDir for + the project.This can also be a JSON encoded + value which Jest will use as configuration. + --coverage Indicates that test coverage information should + be collected and reported in the output. + --coverageDirectory The directory where Jest should output its + coverage files. + --coveragePathIgnorePatterns An array of regexp pattern strings that are + matched against all file paths before executing + the test. If the file pathmatches any of the + patterns, coverage information will be skipped. + --coverageProvider Select between Babel and V8 to collect coverage + --coverageReporters A list of reporter names that Jest uses when + writing coverage reports. Any istanbul reporter + can be used. + --coverageThreshold A JSON string with which will be used to + configure minimum threshold enforcement for + coverage results + --debug Print debugging info about your jest config. + --detectLeaks **EXPERIMENTAL**: Detect memory leaks in tests. + After executing a test, it will try to garbage + collect the global object used, and fail if it + was leaked + --detectOpenHandles Print out remaining open handles preventing + Jest from exiting at the end of a test run. + Implies `runInBand`. + --env The test environment used for all tests. This + can point to any file or node module. Examples: + `jsdom`, `node` or `path/to/my-environment.js` + --errorOnDeprecated Make calling deprecated APIs throw helpful + error messages. + -e --expand Use this flag to show full diffs instead of a + patch. + --filter Path to a module exporting a filtering + function. This method receives a list of tests + which can be manipulated to exclude tests from + running. Especially useful when used in + conjunction with a testing infrastructure to + filter known broken tests. + --findRelatedTests Find related tests for a list of source files + that were passed in as arguments. Useful for + pre-commit hook integration to run the minimal + amount of tests necessary. + --forceExit Force Jest to exit after all tests have + completed running. This is useful when + resources set up by test code cannot be + adequately cleaned up. + --globalSetup The path to a module that runs before All + Tests. + --globalTeardown The path to a module that runs after All Tests. + --globals A JSON string with map of global variables that + need to be available in all test environments. + --haste A JSON string with map of variables for the + haste module system + --init Generate a basic configuration file + --injectGlobals Should Jest inject global variables or not + --json Prints the test results in JSON. This mode will + send all other test output and user messages to + stderr. + --lastCommit Run all tests affected by file changes in the + last commit made. Behaves similarly to + `--onlyChanged`. + --listTests Lists all tests Jest will run given the + arguments and exits. Most useful in a CI system + together with `--findRelatedTests` to determine + the tests Jest will run based on specific files + --logHeapUsage Logs the heap usage after every test. Useful to + debug memory leaks. Use together with + `--runInBand` and `--expose-gc` in node. + --mapCoverage Maps code coverage reports against original source code when transformers supply source maps. + + DEPRECATED + --maxConcurrency Specifies the maximum number of tests that are + allowed to runconcurrently. This only affects + tests using `test.concurrent`. + -w --maxWorkers Specifies the maximum number of workers the + worker-pool will spawn for running tests. This + defaults to the number of the cores available + on your machine. (its usually best not to + override this default) + --moduleDirectories An array of directory names to be searched + recursively up from the requiring module's + location. + --moduleFileExtensions An array of file extensions your modules use. + If you require modules without specifying a + file extension, these are the extensions Jest + will look for. + --moduleNameMapper A JSON string with a map from regular + expressions to module names or to arrays of + module names that allow to stub out resources, + like images or styles with a single module + --modulePathIgnorePatterns An array of regexp pattern strings that are + matched against all module paths before those + paths are to be considered "visible" to the + module loader. + --modulePaths An alternative API to setting the NODE_PATH env + variable, modulePaths is an array of absolute + paths to additional locations to search when + resolving modules. + --noStackTrace Disables stack trace in test results output + --notify Activates notifications for test results. + --notifyMode Specifies when notifications will appear for + test results. + -o --onlyChanged Attempts to identify which tests to run based + on which files have changed in the current + repository. Only works if you're running tests + in a git or hg repository at the moment. + -f --onlyFailures Run tests that failed in the previous + execution. + --outputFile Write test results to a file when the --json + option is also specified. + --passWithNoTests Will not fail if no tests are found (for + example while using `--testPathPattern`.) + --preset A preset that is used as a base for Jest's + configuration. + --prettierPath The path to the "prettier" module used for + inline snapshots. + --projects A list of projects that use Jest to run all + tests of all projects in a single instance of + Jest. + --reporters A list of custom reporters for the test suite. + --resetMocks Automatically reset mock state between every + test. Equivalent to calling + jest.resetAllMocks() between each test. + --resetModules If enabled, the module registry for every test + file will be reset before running each + individual test. + --resolver A JSON string which allows the use of a custom + resolver. + --restoreMocks Automatically restore mock state and + implementation between every test. Equivalent + to calling jest.restoreAllMocks() between each + test. + --rootDir The root directory that Jest should scan for + tests and modules within. + --roots A list of paths to directories that Jest should + use to search for files in. + -i --runInBand Run all tests serially in the current process + (rather than creating a worker pool of child + processes that run tests). This is sometimes + useful for debugging, but such use cases are + pretty rare. + --runTestsByPath Used when provided patterns are exact file + paths. This avoids converting them into a + regular expression and matching it against + every single file. + --runner Allows to use a custom runner instead of Jest's + default test runner. + --selectProjects Run only the tests of the specified + projects.Jest uses the attribute `displayName` + in the configuration to identify each project. + --setupFiles A list of paths to modules that run some code + to configure or set up the testing environment + before each test. + --setupFilesAfterEnv A list of paths to modules that run some code + to configure or set up the testing framework + before each test + --showConfig Print your jest config and then exits. + --silent Prevent tests from printing messages through + the console. + --skipFilter Disables the filter provided by --filter. + Useful for CI jobs, or local enforcement when + fixing tests. + --snapshotSerializers A list of paths to snapshot serializer modules + Jest should use for snapshot testing. + --testEnvironment Alias for --env + --testEnvironmentOptions Test environment options that will be passed to + the testEnvironment. The relevant options + depend on the environment. + --testFailureExitCode Exit code of `jest` command if the test run + failed + --testLocationInResults Add `location` information to the test results + --testMatch The glob patterns Jest uses to detect test + files. + -t --testNamePattern Run only tests with a name that matches the + regex pattern. + --testPathIgnorePatterns An array of regexp pattern strings that are + matched against all test paths before executing + the test. If the test path matches any of the + patterns, it will be skipped. + --testPathPattern A regexp pattern string that is matched against + all tests paths before executing the test. + --testRegex A string or array of string regexp patterns + that Jest uses to detect test files. + --testResultsProcessor Allows the use of a custom results processor. + This processor must be a node module that + exports a function expecting as the first + argument the result object. + --testRunner Allows to specify a custom test runner. The + default is `jasmine2`. A path to a custom test + runner can be provided: + `/path/to/testRunner.js`. + --testSequencer Allows to specify a custom test sequencer. The + default is `@jest/test-sequencer`. A path to a + custom test sequencer can be provided: + `/path/to/testSequencer.js` + --testTimeout This option sets the default timeouts of test + cases. + --testURL This option sets the URL for the jsdom + environment. + --timers Setting this value to fake allows the use of + fake timers for functions such as setTimeout. + --transform A JSON string which maps from regular + expressions to paths to transformers. + --transformIgnorePatterns An array of regexp pattern strings that are + matched against all source file paths before + transformation. + --unmockedModulePathPatterns An array of regexp pattern strings that are + matched against all modules before the module + loader will automatically return a mock for + them. + -u --updateSnapshot Use this flag to re-record snapshots. Can be + used together with a test suite pattern or with + `--testNamePattern` to re-record snapshot for + test matching the pattern + --useStderr Divert all output to stderr. + --verbose Display individual test results with the test + suite hierarchy. + --watch Watch files for changes and rerun tests related + to changed files. If you want to re-run all + tests when a file has changed, use the + `--watchAll` option. + --watchAll Watch files for changes and rerun all tests. If + you want to re-run only the tests related to + the changed files, use the `--watch` option. + --watchPathIgnorePatterns An array of regexp pattern strings that are + matched against all paths before trigger test + re-run in watch mode. If the test path matches + any of the patterns, it will be skipped. + --watchman Whether to use watchman for file crawling. + Disable using --no-watchman. + -h, --help display help for command + +``` + +比如覆盖测试： +``` +fes test --coverage +``` + +### 配置文件 +除了插件内置的默认配置之外，插件遵循 `Jest`的配置文件规范，约定项目根目录下的 `jest.config.js` 为用户配置文件，约定 `packages.json` 的 `jest` 属性内容也是配置。 + + +### 优先级 + +`args` 配置 > `package.json`中的 `jest` > `jest.config.js` > 默认配置 \ No newline at end of file diff --git a/docs/reference/plugin/plugins/locale.md b/docs/reference/plugin/plugins/locale.md index f67b9aa4..c5253b9e 100644 --- a/docs/reference/plugin/plugins/locale.md +++ b/docs/reference/plugin/plugins/locale.md @@ -176,7 +176,7 @@ console.log(locale.getAllLocales()); ### useI18n Composition API, 只能在 `setup` 函数中使用，更多细节参考 [Vue I18n](https://vue-i18n.intlify.dev/api/composition.html#usei18n)。 -举个例子： +举个 🌰： ```vue