ensureBuiltins() — vite Function Reference

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

Function typescript ModuleRunner SSRRuntime calls 1 called by 1

Entity Profile

ModuleRunner→ SSRRuntime→ ensureBuiltins() — vite Function Reference

Dependency Diagram

graph TD
  7ea4161b_ab41_b309_0390_3e9a8521014d["ensureBuiltins()"]
  1d3ff778_7ac6_0038_640f_997e968c3c8f["ModuleRunner"]
  7ea4161b_ab41_b309_0390_3e9a8521014d -->|defined in| 1d3ff778_7ac6_0038_640f_997e968c3c8f
  6d9a8fd8_b579_289e_b43c_8d04619aff11["getModuleInformation()"]
  6d9a8fd8_b579_289e_b43c_8d04619aff11 -->|calls| 7ea4161b_ab41_b309_0390_3e9a8521014d
  eb16f54b_f518_e287_d712_4a0d7705bdff["createIsBuiltin()"]
  7ea4161b_ab41_b309_0390_3e9a8521014d -->|calls| eb16f54b_f518_e287_d712_4a0d7705bdff
  style 7ea4161b_ab41_b309_0390_3e9a8521014d fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/vite/src/module-runner/runner.ts lines 244–270

  private ensureBuiltins(): Promise<void> | undefined {
    if (this.isBuiltin) return

    this.builtinsPromise ??= (async () => {
      try {
        this.debug?.('[module runner] fetching builtins from server')
        const serializedBuiltins = await this.transport.invoke(
          'getBuiltins',
          [],
        )
        const builtins = serializedBuiltins.map((builtin) =>
          typeof builtin === 'object' && builtin && 'type' in builtin
            ? builtin.type === 'string'
              ? builtin.value
              : new RegExp(builtin.source, builtin.flags)
            : // NOTE: Vitest returns raw values instead of serialized ones
              builtin,
        )
        this.isBuiltin = createIsBuiltin(builtins)
        this.debug?.('[module runner] builtins loaded:', builtins)
      } finally {
        this.builtinsPromise = undefined
      }
    })()

    return this.builtinsPromise
  }