feat(test-utils): add option to configure test server port (#20443)

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

@@ -84,6 +84,13 @@ Whether to launch a server to respond to requests in the test suite.
 * Type: `boolean`
 * Default: `true`
 
+#### `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.

packages/test-utils/src/server.ts

@@ -13,7 +13,7 @@ const kit: typeof _kit = _kit.default || _kit
 export async function startServer () {
   const ctx = useTestContext()
   await stopServer()
-  const port = await getRandomPort()
+  const port = ctx.options.port || await getRandomPort()
   ctx.url = 'http://127.0.0.1:' + port
   if (ctx.options.dev) {
     const nuxiCLI = await kit.resolvePath('nuxi/cli')

packages/test-utils/src/types.ts

@@ -23,6 +23,7 @@ export interface TestOptions {
     launch?: LaunchOptions
   }
   server: boolean
+  port?: number
 }
 
 export interface TestContext {