serve() — vite Function Reference

Architecture documentation for the serve() function in serve.ts from the vite codebase.

Function typescript ViteCore ConfigEngine

Entity Profile

ViteCore→ ConfigEngine→ serve() — vite Function Reference

Dependency Diagram

graph TD
  c88fed39_e256_daf6_2732_93a04547b2fa["serve()"]
  33b1e6aa_e6e3_b00a_669d_b356ad3b2203["serve.ts"]
  c88fed39_e256_daf6_2732_93a04547b2fa -->|defined in| 33b1e6aa_e6e3_b00a_669d_b356ad3b2203
  style c88fed39_e256_daf6_2732_93a04547b2fa fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

playground/ssr-noexternal/__tests__/serve.ts lines 10–52

export async function serve(): Promise<{ close(): Promise<void> }> {
  if (isBuild) {
    // build first
    const { build } = await import('vite')
    // server build
    await build({
      root: rootDir,
      logLevel: 'silent',
      build: {
        ssr: 'src/entry-server.js',
      },
    })
  }

  await kill(port)

  const { createServer } = await import(path.resolve(rootDir, 'server.js'))
  const { app, vite } = await createServer(
    rootDir,
    isBuild,
    hmrPorts['ssr-noexternal'],
  )

  return new Promise((resolve, reject) => {
    try {
      const server = app.listen(port, () => {
        resolve({
          // for test teardown
          async close() {
            await new Promise((resolve) => {
              server.close(resolve)
            })
            if (vite) {
              await vite.close()
            }
          },
        })
      })
    } catch (e) {
      reject(e)
    }
  })
}