docs: update env & test-module

Author: lxKylin

advanced/api/test-module.md

@@ -5,8 +5,8 @@
 `TestModule` 实例始终具有一个 `type` 属性，其值为 `module`。你可以使用它来区分不同的任务类型：
 
 ```ts
-if (task.type === 'module') {
-  task // TestModule
+if (task.type === "module") {
+  task; // TestModule
 }
 ```
 
@@ -19,50 +19,50 @@ if (task.type === 'module') {
 这通常是一个绝对的 Unix 文件路径（即使在 Windows 上也是如此）。如果文件不在磁盘上，它可以是一个虚拟 ID。此值对应于 Vite 的 `ModuleGraph` ID。
 
 ```ts
-'C:/Users/Documents/project/example.test.ts' // ✅
-'/Users/mac/project/example.test.ts' // ✅
-'C:\\Users\\Documents\\project\\example.test.ts' // ❌
+"C:/Users/Documents/project/example.test.ts"; // ✅
+"/Users/mac/project/example.test.ts"; // ✅
+"C:\\Users\\Documents\\project\\example.test.ts"; // ❌
 ```
 
 ## 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' // ✅
-'example.test.ts' // ✅
-'project\\example.test.ts' // ❌
+"project/example.test.ts"; // ✅
+"example.test.ts"; // ✅
+"project\\example.test.ts"; // ❌
 ```
 
 ## state
 
 ```ts
-function state(): TestModuleState
+function state(): TestModuleState;
 ```
 
 与 [`testSuite.state()`](/advanced/api/test-suite#state) 的工作方式相同，但如果模块尚未执行，还可以返回 `queued`。
 
 ## meta <Version>3.1.0</Version> {#meta}
 
 ```ts
-function meta(): TaskMeta
+function meta(): TaskMeta;
 ```
 
 在模块执行或收集过程中附加到模块的自定义[元数据](/advanced/metadata)。在测试运行期间，可以通过向 `task.meta` 对象分配属性来附加 meta：
 
 ```ts {5,10}
-import { test } from 'vitest'
-
-describe('the validation works correctly', (task) => {
-  // assign "decorated" during collection
-  task.file.meta.decorated = false
-
-  test('some test', ({ task }) => {
-    // assign "decorated" during test run, it will be available
-    // only in onTestCaseReady hook
-    task.file.meta.decorated = false
-  })
-})
+import { test } from "vitest";
+
+describe("the validation works correctly", (task) => {
+  // 在收集阶段分配 "decorated"
+  task.file.meta.decorated = false;
+
+  test("some test", ({ task }) => {
+    // 在测试运行期间分配 "decorated"，它将可用
+    // 仅在 onTestCaseReady 钩子中
+    task.file.meta.decorated = false;
+  });
+});
 ```
 
 :::tip
@@ -72,51 +72,51 @@ describe('the validation works correctly', (task) => {
 ## diagnostic
 
 ```ts
-function diagnostic(): ModuleDiagnostic
+function diagnostic(): ModuleDiagnostic;
 ```
 
 关于模块的有用信息，例如持续时间、内存使用等。如果模块尚未执行，所有诊断值将返回 `0`。
 
 ```ts
 interface ModuleDiagnostic {
   /**
-   * The time it takes to import and initiate an environment.
+   * 导入和初始化环境所需的时间。
    */
-  readonly environmentSetupDuration: number
+  readonly environmentSetupDuration: number;
   /**
-   * The time it takes Vitest to setup test harness (runner, mocks, etc.).
+   * Vitest 设置测试运行环境（运行器、模拟等）所需的时间。
    */
-  readonly prepareDuration: number
+  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
+  readonly collectDuration: number;
   /**
-   * The time it takes to import the setup module.
+   * 导入设置模块所需的时间。
    */
-  readonly setupDuration: number
+  readonly setupDuration: number;
   /**
-   * Accumulated duration of all tests and hooks in the module.
+   * 模块中所有测试和钩子函数的累计持续时间。
    */
-  readonly duration: number
+  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
+  readonly heap: number | undefined;
   /**
-   * The time spent importing every non-externalized dependency that Vitest has processed.
+   * Vitest处理的每个非外部化依赖项的导入时间。
    */
-  readonly importDurations: Record<string, ImportDuration>
+  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
+  /** 导入和执行文件本身所花费的时间，不包括该文件所依赖的所有非外部化导入。 */
+  selfTime: number;
 
-  /** The time spent importing & executing the file and all its imports. */
-  totalTime: number
+  /** 导入和执行文件及其所有导入项所花费的时间。 */
+  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
@@ -32,45 +32,45 @@ Vitest 并不将 `browser` 视作一种测试环境。如果你想让部分测
 ```ts
 // @vitest-environment jsdom
 
-import { expect, test } from 'vitest'
+import { expect, test } from "vitest";
 
-test('test', () => {
-  expect(typeof window).not.toBe('undefined')
-})
+test("test", () => {
+  expect(typeof window).not.toBe("undefined");
+});
 ```
 
 ## 自定义环境 {#custom-environment}
 
 你可以创建自己的包来扩展 Vitest 环境。为此，请创建一个名为 `vitest-environment-${name}` 的包，或者指定一个有效的 JS/TS 文件路径。该包应该导出一个形状为 `Environment` 的对象。
 
 ```ts
-import type { Environment } from 'vitest/environments'
+import type { Environment } from "vitest/environments";
 
 export default <Environment>{
-  name: 'custom',
-  viteEnvironment: 'ssr',
+  name: "custom",
+  viteEnvironment: "ssr",
   // optional - only if you support "experimental-vm" pool
   async setupVM() {
-    const vm = await import('node:vm')
-    const context = vm.createContext()
+    const vm = await import("node:vm");
+    const context = vm.createContext();
     return {
       getVmContext() {
-        return context
+        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
+        // 在所有使用此环境的测试运行完毕后调用
       },
-    }
+    };
   },
-}
+};
 ```
 
 ::: warning
@@ -80,30 +80,30 @@ Vitest 要求环境对象显式提供 `viteEnvironment` 字段（若省略则取
 你还可以通过 `vitest/environments` 访问默认的 Vitest 环境：
 
 ```ts
-import { builtinEnvironments, populateGlobal } from 'vitest/environments'
+import { builtinEnvironments, populateGlobal } from "vitest/environments";
 
-console.log(builtinEnvironments) // { jsdom, happy-dom, node, edge-runtime }
+console.log(builtinEnvironments); // { jsdom, happy-dom, node, edge-runtime }
 ```
 
 Vitest 还提供了 `populateGlobal` 实用函数，可用于将属性从对象移动到全局命名空间：
 
 ```ts
 interface PopulateOptions {
-  // should non-class functions be bind to the global namespace
-  bindFunctions?: boolean
+  // 非类函数是否应该绑定到全局命名空间
+  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
-  originals: Map<string | symbol, any>
+  // 所有被复制的键的列表，即使原始对象上不存在该值
+  keys: Set<string>;
+  // 可能已被键覆盖的原始对象的映射
+  // 你可以在 `teardown` 函数中返回这些值
+  originals: Map<string | symbol, any>;
 }
 
 export function populateGlobal(
   global: any,
   original: any,
   options: PopulateOptions
-): PopulateResult
+): PopulateResult;
 ```