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
  1a9d71c7_36a8_4420_7070_7f1091108646["createServer()"]
  0c71ed9c_3985_f5c3_363b_bdb8df7d381b["server.js"]
  1a9d71c7_36a8_4420_7070_7f1091108646 -->|defined in| 0c71ed9c_3985_f5c3_363b_bdb8df7d381b
  style 1a9d71c7_36a8_4420_7070_7f1091108646 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

playground/optimize-missing-deps/server.js lines 8–58

export async function createServer(root = process.cwd(), hmrPort) {
  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,
      hmr: {
        port: hmrPort,
      },
    },
    appType: 'custom',
  })
  app.use(vite.middlewares)

  app.use('*all', async (req, res) => {
    try {
      let template = fs.readFileSync(resolve('index.html'), 'utf-8')
      template = await vite.transformIndexHtml(req.originalUrl, template)

      // `main.js` imports dependencies that are yet to be discovered and optimized, aka "missing" deps.
      // Loading `main.js` in SSR should not trigger optimizing the "missing" deps
      const { name } = await vite.ssrLoadModule('./main.js')

      // Loading `main.js` in the client should trigger optimizing the "missing" deps
      const appHtml = `<div id="app">${name}</div>
<script type='module'>
  import { name } from './main.js'
  document.getElementById('app').innerText = name
</script>`

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

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

  return { app, vite }
}