docs: setup host property and usage example (#28331)

docs/1.getting-started/11.testing.md

@@ -544,17 +544,22 @@ Please use the options below for the `setup` method.
 
 #### Features
 
+- `build`: Whether to run a separate build step.
+  - Type: `boolean`
+  - Default: `true` (`false` if `browser` or `server` is disabled, or if a `host` is provided)
+
 - `server`: Whether to launch a server to respond to requests in the test suite.
   - Type: `boolean`
-  - Default: `true`
+  - Default: `true` (`false` if a `host` is provided)
 
 - `port`: If provided, set the launched test server port to the value.
   - Type: `number | undefined`
   - Default: `undefined`
 
-- `build`: Whether to run a separate build step.
+- `host`: If provided, a URL to use as the test target instead of building and running a new server. Useful for running "real" end-to-end tests against a deployed version of your application, or against an already running local server (which may provide a significant reduction in test execution timings). See the [target host end-to-end example below](#target-host-end-to-end-example).
-  - Type: `boolean`
+  - Type: `string`
-  - Default: `true` (`false` if `browser` or `server` is disabled)
+  - Default: `undefined`
+
 - `browser`: Under the hood, Nuxt test utils uses [`playwright`](https://playwright.dev) to carry out browser testing. If this option is set, a browser will be launched and can be controlled in the subsequent test suite.
   - Type: `boolean`
   - Default: `false`
@@ -566,6 +571,31 @@ Please use the options below for the `setup` method.
   - Type: `'vitest' | 'jest' | 'cucumber'`
   - Default: `'vitest'`
 
+##### Target `host` end-to-end example
+
+A common use-case for end-to-end testing is running the tests against a deployed application running in the same environment typically used for Production.
+
+For local development or automated deploy pipelines, testing against a separate local server can be more efficient and is typically faster than allowing the test framework to rebuild between tests.
+
+To utilize a separate target host for end-to-end tests, simply provide the `host` property of the `setup` function with the desired URL.
+
+```ts twoslash
+import { setup, createPage } from '@nuxt/test-utils/e2e'
+import { describe, it, expect } from 'vitest'
+
+describe('login page', async () => {
+  await setup({
+    host: 'http://localhost:8787',
+  })
+
+  it('displays the email and password fields', async () => {
+    const page = await createPage('/login')
+    expect(await page.getByTestId('email').isVisible()).toBe(true)
+    expect(await page.getByTestId('password').isVisible()).toBe(true)
+  })
+})
+```
+
 ### APIs
 
 #### `$fetch(url)`