buildEsbuildPlugin() — vite Function Reference

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

Function typescript PluginSystem AssetManagement calls 3 called by 1

Entity Profile

PluginSystem→ AssetManagement→ buildEsbuildPlugin() — vite Function Reference

Dependency Diagram

graph TD
  58657749_bb5a_f054_a7a7_21e9351ab0f7["buildEsbuildPlugin()"]
  926e3b98_b813_2ff8_abb3_16447ab95544["esbuild.ts"]
  58657749_bb5a_f054_a7a7_21e9351ab0f7 -->|defined in| 926e3b98_b813_2ff8_abb3_16447ab95544
  8c4db194_5dfd_4391_cc9a_833655009196["resolveBuildPlugins()"]
  8c4db194_5dfd_4391_cc9a_833655009196 -->|calls| 58657749_bb5a_f054_a7a7_21e9351ab0f7
  03745bf8_5bb3_30a3_36e5_c9422e7c13e7["resolveEsbuildTranspileOptions()"]
  58657749_bb5a_f054_a7a7_21e9351ab0f7 -->|calls| 03745bf8_5bb3_30a3_36e5_c9422e7c13e7
  bf4a41be_9dbf_35be_2072_4283cd478ae7["transformWithEsbuild()"]
  58657749_bb5a_f054_a7a7_21e9351ab0f7 -->|calls| bf4a41be_9dbf_35be_2072_4283cd478ae7
  da580d58_df79_422c_d5c0_e8caa03ae397["injectEsbuildHelpers()"]
  58657749_bb5a_f054_a7a7_21e9351ab0f7 -->|calls| da580d58_df79_422c_d5c0_e8caa03ae397
  style 58657749_bb5a_f054_a7a7_21e9351ab0f7 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/vite/src/node/plugins/esbuild.ts lines 390–427

export const buildEsbuildPlugin = (): Plugin => {
  return {
    name: 'vite:esbuild-transpile',
    applyToEnvironment(environment) {
      return environment.config.esbuild !== false
    },
    async renderChunk(code, chunk, opts) {
      // avoid on legacy chunks since it produces legacy-unsafe code
      // e.g. rewriting object properties into shorthands
      if (this.environment.config.isOutputOptionsForLegacyChunks?.(opts)) {
        return null
      }

      const config = this.environment.config
      const options = resolveEsbuildTranspileOptions(config, opts.format)

      if (!options) {
        return null
      }

      const res = await transformWithEsbuild(
        code,
        chunk.fileName,
        options,
        undefined,
        config,
        undefined,
        true,
      )

      if (config.build.lib) {
        res.code = injectEsbuildHelpers(res.code, opts.format)
      }

      return res
    },
  }
}