createServer() — vite Function Reference

Architecture documentation for the createServer() function in server.js from the vite codebase.

Function javascript ViteCore DevServer

Entity Profile

ViteCore→ DevServer→ createServer() — vite Function Reference

Dependency Diagram

graph TD
  700543dd_9e00_9f2e_1f17_fc61adf02ebb["createServer()"]
  a3d84c64_915f_7330_2056_f4c872e19179["server.js"]
  700543dd_9e00_9f2e_1f17_fc61adf02ebb -->|defined in| a3d84c64_915f_7330_2056_f4c872e19179
  style 700543dd_9e00_9f2e_1f17_fc61adf02ebb fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

playground/ssr/server.js lines 7–65

export async function createServer(
  root = process.cwd(),
  hmrPort,
  customLogger,
) {
  const resolve = (p) => path.resolve(import.meta.dirname, p)

  const app = express()

  /**
   * @type {import('vite').ViteDevServer}
   */
  const vite = await (
    await import('vite')
  ).createServer({
    root,
    logLevel: isTest ? 'error' : 'info',
    server: {
      middlewareMode: true,
      watch: {
        // During tests we edit the files too fast and sometimes chokidar
        // misses change events, so enforce polling for consistency
        usePolling: true,
        interval: 100,
      },
      hmr: {
        port: hmrPort,
      },
    },
    appType: 'custom',
    customLogger,
  })
  // use vite's connect instance as middleware
  app.use(vite.middlewares)

  app.use('*all', async (req, res, next) => {
    try {
      const url = req.originalUrl

      let template
      template = fs.readFileSync(resolve('index.html'), 'utf-8')
      template = await vite.transformIndexHtml(url, template)
      const render = (await vite.ssrLoadModule('/src/app.js')).render

      const appHtml = await render(url, import.meta.dirname)

      const html = template.replace(`<!--app-html-->`, appHtml)

      res.status(200).set({ 'Content-Type': 'text/html' }).end(html)
    } catch (e) {
      vite && vite.ssrFixStacktrace(e)
      if (isTest) throw e
      console.log(e.stack)
      res.status(500).end(e.stack)
    }
  })

  return { app, vite }
}