Merge pull request #790 from lxKylin/env-1

docs: update env & test-module

Author: lxKylin

advanced/api/test-module.md

@@ -26,7 +26,7 @@ if (task.type === 'module') {
 
 ## relativeModuleId
 
-Module id relative to the project. This is the same as `task.name` in the deprecated API.
+相对于项目的模块 ID。这与已弃用 API 中的 `task.name` 相同。
 
 ```ts
 'project/example.test.ts' // ✅
@@ -54,12 +54,12 @@ function meta(): TaskMeta
 import { test } from 'vitest'
 
 describe('the validation works correctly', (task) => {
-  // assign "decorated" during collection
+  // 在收集阶段分配 "decorated"
   task.file.meta.decorated = false
 
   test('some test', ({ task }) => {
-    // assign "decorated" during test run, it will be available
-    // only in onTestCaseReady hook
+    // 在测试运行期间分配 "decorated"，它将可用
+    // 仅在 onTestCaseReady 钩子中
     task.file.meta.decorated = false
   })
 })
@@ -80,43 +80,43 @@ function diagnostic(): ModuleDiagnostic
 ```ts
 interface ModuleDiagnostic {
   /**
-   * The time it takes to import and initiate an environment.
+   * 导入和初始化环境所需的时间。
    */
   readonly environmentSetupDuration: number
   /**
-   * The time it takes Vitest to setup test harness (runner, mocks, etc.).
+   * Vitest 设置测试运行环境（运行器、模拟等）所需的时间。
    */
   readonly prepareDuration: number
   /**
-   * The time it takes to import the test module.
-   * This includes importing everything in the module and executing suite callbacks.
+   * 导入测试模块所需的时间。
+   * 这包括导入模块中的所有内容以及执行套件回调函数。
    */
   readonly collectDuration: number
   /**
-   * The time it takes to import the setup module.
+   * 导入设置模块所需的时间。
    */
   readonly setupDuration: number
   /**
-   * Accumulated duration of all tests and hooks in the module.
+   * 模块中所有测试和钩子函数的累计持续时间。
    */
   readonly duration: number
   /**
-   * The amount of memory used by the module in bytes.
-   * This value is only available if the test was executed with `logHeapUsage` flag.
+   * 模块使用的内存量（以字节为单位）。
+   * 此值仅在使用 `logHeapUsage` 标志执行测试时才可用。
    */
   readonly heap: number | undefined
   /**
-   * The time spent importing every non-externalized dependency that Vitest has processed.
+   * Vitest处理的每个非外部化依赖项的导入时间。
    */
   readonly importDurations: Record<string, ImportDuration>
 }
 
-/** The time spent importing & executing a non-externalized file. */
+/** 导入和执行非外部化文件所花费的时间。 */
 interface ImportDuration {
-  /** The time spent importing & executing the file itself, not counting all non-externalized imports that the file does. */
+  /** 导入和执行文件本身所花费的时间，不包括该文件所依赖的所有非外部化导入。 */
   selfTime: number
 
-  /** The time spent importing & executing the file and all its imports. */
+  /** 导入和执行文件及其所有导入项所花费的时间。 */
   totalTime: number
 }
 ```

guide/environment.md

@@ -16,7 +16,7 @@ Vitest 提供 [`environment`](/config/#environment) 选项以在特定环境中
 ::: info
 当使用 `jsdom` 或 `happy-dom` 环境时，Vitest 在导入 [CSS](https://vitejs.dev/guide/features.html#css) 和 [资源文件](https://vitejs.dev/guide/features.html#static-assets) 时遵循与 Vite 相同的规则。如果在导入外部依赖时出现 `unknown extension .css` 错误，则需要通过将所有相关包添加到 [`server.deps.inline`](/config/#server-deps-inline) 中，手动内联整个导入链。例如，在以下导入链中：`源代码 -> package-1 -> package-2 -> package-3`，如果错误发生在 `package-3`，你需要将这三个包都添加到 `server.deps.inline` 中。
 
-外部依赖中的CSS和资源文件的 `require` 调用会自动解析。
+外部依赖中的 CSS 和资源文件的 `require` 调用会自动解析。
 :::
 
 ::: warning
@@ -58,15 +58,15 @@ export default <Environment>{
         return context
       },
       teardown() {
-        // called after all tests with this env have been run
+        // 在所有使用此环境的测试运行完毕后调用
       },
     }
   },
   setup() {
-    // custom setup
+    // 自定义设置
     return {
       teardown() {
-        // called after all tests with this env have been run
+        // 在所有使用此环境的测试运行完毕后调用
       },
     }
   },
@@ -89,15 +89,15 @@ Vitest 还提供了 `populateGlobal` 实用函数，可用于将属性从对象
 
 ```ts
 interface PopulateOptions {
-  // should non-class functions be bind to the global namespace
+  // 非类函数是否应该绑定到全局命名空间
   bindFunctions?: boolean
 }
 
 interface PopulateResult {
-  // a list of all keys that were copied, even if value doesn't exist on original object
+  // 所有被复制的键的列表，即使原始对象上不存在该值
   keys: Set<string>
-  // a map of original object that might have been overridden with keys
-  // you can return these values inside `teardown` function
+  // 可能已被键覆盖的原始对象的映射
+  // 你可以在 `teardown` 函数中返回这些值
   originals: Map<string | symbol, any>
 }