Function startServer

tests/integration/utils/dev-server.ts:71–243

({
  args = [],
  command,
  context = 'dev',
  cwd,
  debug = false,
  env = {},
  expectFailure = false,
  framework,
  offline = true,
  prompt,
  serve = false,
  skipWaitPort = false,
  targetPort,
}: DevServerOptions)

const SERVER_START_TIMEOUT = 24e4

const startServer = async ({
  args = [],
  command,
  context = 'dev',
  cwd,
  debug = false,
  env = {},
  expectFailure = false,
  framework,
  offline = true,
  prompt,
  serve = false,
  skipWaitPort = false,
  targetPort,
}: DevServerOptions): Promise<DevServer | { timeout: boolean; output: string; error?: string; report?: string }> => {
  const port = await getPort()
  const host = 'localhost'
  const url = `http://${host}:${port}`

  console.log(`Starting dev server on port: ${port} in directory ${path.basename(cwd)}`)
  const baseCommand = serve ? 'serve' : 'dev'
  const baseArgs = [
    baseCommand,
    offline ? '--offline' : '',
    '-p',
    port.toString(),
    debug ? '--debug' : '',
    skipWaitPort ? '--skip-wait-port' : '',
  ]

  if (targetPort) {
    baseArgs.push('--target-port', targetPort.toString())
  } else {
    const staticPort = await getPort()
    baseArgs.push('--staticServerPort', staticPort.toString())
  }

  if (framework) {
    baseArgs.push('--framework', framework)
  }

  if (command) {
    baseArgs.push('--command', command)
  }

  // We use `null` to override the default context and actually omit the flag
  // from the command, which is useful in some test scenarios.
  if (context !== null) {
    baseArgs.push('--context', context)
  }

  const ps = execa(cliPath, [...baseArgs, ...args], getExecaOptions({ cwd, env }))

  if (process.env.DEBUG_TESTS) {
    ps.stderr!.pipe(process.stderr)
    ps.stdout!.pipe(process.stdout)
  }