docs(en): merging all conflicts

Author: docschina-bot

advanced/api/vitest.md

@@ -317,7 +317,7 @@ This method doesn't trigger `onWatcherRerun`, `onWatcherStart` and `onTestsRerun
 ## rerunTestSpecifications
 
 ```ts
-function runTestSpecifications(
+function rerunTestSpecifications(
   specifications: TestSpecification[],
   allTestsRun = false
 ): Promise<TestRunResult>

config/index.md

@@ -1073,15 +1073,23 @@ export default defineConfig({
 - **默认值:** `5_000` in Node.js, `15_000` if `browser.enabled` is `true`
 - **命令行终端:** `--test-timeout=5000`, `--testTimeout=5000`
 
+<<<<<<< HEAD
 测试的默认超时时间（以毫秒为单位）。
+=======
+Default timeout of a test in milliseconds. Use `0` to disable timeout completely.
+>>>>>>> 19b0a4337b6dcae4c9e5f1792b087e8323194ec1
 
 ### hookTimeout
 
 - **类型:** `number`
 - **默认值:** `10_000` in Node.js, `30_000` if `browser.enabled` is `true`
 - **命令行终端:** `--hook-timeout=10000`, `--hookTimeout=10000`
 
+<<<<<<< HEAD
 钩子(hook)的默认超时时间（以毫秒为单位）。
+=======
+Default timeout of a hook in milliseconds. Use `0` to disable timeout completely.
+>>>>>>> 19b0a4337b6dcae4c9e5f1792b087e8323194ec1
 
 ### teardownTimeout<NonProjectOption />
 

guide/browser/config.md

@@ -101,7 +101,7 @@ List of available `browser` options:
 - [`browser.screenshotDirectory`](#browser-screenshotdirectory)
 - [`browser.screenshotFailures`](#browser-screenshotfailures)
 
-By default, Vitest creates an array with a single element which uses the [`browser.name`](#browser-name) field as a `browser`. Note that this behaviour will be removed with Vitets 4.
+By default, Vitest creates an array with a single element which uses the [`browser.name`](#browser-name) field as a `browser`. Note that this behaviour will be removed with Vitest 4.
 
 Under the hood, Vitest transforms these instances into separate [test projects](/advanced/api/test-project) sharing a single Vite server for better caching performance.
 

guide/browser/locators.md

@@ -387,6 +387,69 @@ It is recommended to use this only after the other locators don't work for your
 
 - [testing-library's `ByTestId`](https://testing-library.com/docs/queries/bytestid/)
 
+## nth
+
+```ts
+function nth(index: number): Locator
+```
+
+This method returns a new locator that matches only a specific index within a multi-element query result. Unlike `elements()[n]`, the `nth` locator will be retried until the element is present.
+
+```html
+<div aria-label="one"><input/><input/><input/></div>
+<div aria-label="two"><input/></div>
+```
+
+```tsx
+page.getByRole('textbox').nth(0) // ✅
+page.getByRole('textbox').nth(4) // ❌
+```
+
+::: tip
+Before resorting to `nth`, you may find it useful to use chained locators to narrow down your search.
+Sometimes there is no better way to distinguish than by element position; although this can lead to flake, it's better than nothing.
+:::
+
+```tsx
+page.getByLabel('two').getByRole('input') // ✅ better alternative to page.getByRole('textbox').nth(3)
+page.getByLabel('one').getByRole('input') // ❌ too ambiguous
+page.getByLabel('one').getByRole('input').nth(1) // ✅ pragmatic compromise
+```
+
+## first
+
+```ts
+function first(): Locator
+```
+
+This method returns a new locator that matches only the first index of a multi-element query result.
+It is sugar for `nth(0)`.
+
+```html
+<input/> <input/> <input/>
+```
+
+```tsx
+page.getByRole('textbox').first() // ✅
+```
+
+## last
+
+```ts
+function last(): Locator
+```
+
+This method returns a new locator that matches only the last index of a multi-element query result.
+It is sugar for `nth(-1)`.
+
+```html
+<input/> <input/> <input/>
+```
+
+```tsx
+page.getByRole('textbox').last() // ✅
+```
+
 ## Methods
 
 All methods are asynchronous and must be awaited. Since Vitest 3, tests will fail if a method is not awaited.

guide/cli-generated.md

@@ -390,6 +390,13 @@ High and low watermarks for functions in the format of `<high>,<low>`
 
 浏览器测试文件是否应并行运行。使用 `--browser.fileParallelism=false` 可禁用 (默认值: `true`)
 
+### browser.connectTimeout
+
+- **CLI:** `--browser.connectTimeout <timeout>`
+- **Config:** [browser.connectTimeout](/guide/browser/config#browser-connecttimeout)
+
+If connection to the browser takes longer, the test suite will fail (default: `60_000`)
+
 ### pool
 
 - **CLI:** `--pool <pool>`
@@ -654,14 +661,22 @@ VM forks pool 的内存限制。如果你观察到内存泄漏问题，可以尝
 - **CLI:** `--testTimeout <timeout>`
 - **Config:** [testTimeout](/config/#testtimeout)
 
+<<<<<<< HEAD
 测试的默认超时（毫秒）（默认值：`5000`）。
+=======
+Default timeout of a test in milliseconds (default: `5000`). Use `0` to disable timeout completely.
+>>>>>>> 19b0a4337b6dcae4c9e5f1792b087e8323194ec1
 
 ### hookTimeout
 
 - **CLI:** `--hookTimeout <timeout>`
 - **Config:** [hookTimeout](/config/#hooktimeout)
 
+<<<<<<< HEAD
 默认钩子超时（以毫秒为单位）（默认值：`10000`）
+=======
+Default hook timeout in milliseconds (default: `10000`). Use `0` to disable timeout completely.
+>>>>>>> 19b0a4337b6dcae4c9e5f1792b087e8323194ec1
 
 ### bail
 

guide/debugging.md

@@ -20,7 +20,15 @@ ndb npm run test
 ```
 
 :::tip
+<<<<<<< HEAD
 在调试测试时，你可能使用 `--test-timeout` CLI 参数来防止测试在断点处停止时超时。
+=======
+When debugging tests you might want to use following options:
+
+- [`--test-timeout=0`](/guide/cli#testtimeout) to prevent tests from timing out when stopping at breakpoints
+- [`--no-file-parallelism`](/guide/cli#fileparallelism) to prevent test files from running parallel
+
+>>>>>>> 19b0a4337b6dcae4c9e5f1792b087e8323194ec1
 :::
 
 ## VS Code