urlToBuiltUrl() — vite Function Reference

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

Function typescript PluginSystem AssetManagement calls 5 called by 1

Entity Profile

PluginSystem→ AssetManagement→ urlToBuiltUrl() — vite Function Reference

Dependency Diagram

graph TD
  70054416_c841_dc8b_5bd9_4793198b4325["urlToBuiltUrl()"]
  e71b94ef_3010_e358_13d8_f3b3acb0a268["asset.ts"]
  70054416_c841_dc8b_5bd9_4793198b4325 -->|defined in| e71b94ef_3010_e358_13d8_f3b3acb0a268
  39f26be8_b1d9_a756_3043_474687a6bbb7["buildHtmlPlugin()"]
  39f26be8_b1d9_a756_3043_474687a6bbb7 -->|calls| 70054416_c841_dc8b_5bd9_4793198b4325
  b1f5b07b_f692_69cd_1795_627055928bb7["getTopLevelConfig()"]
  70054416_c841_dc8b_5bd9_4793198b4325 -->|calls| b1f5b07b_f692_69cd_1795_627055928bb7
  be351481_35b7_f392_a229_ac14e1fa7efb["checkPublicFile()"]
  70054416_c841_dc8b_5bd9_4793198b4325 -->|calls| be351481_35b7_f392_a229_ac14e1fa7efb
  0d5e9fd7_88bb_e8eb_37e0_dee52752ef34["publicFileToBuiltUrl()"]
  70054416_c841_dc8b_5bd9_4793198b4325 -->|calls| 0d5e9fd7_88bb_e8eb_37e0_dee52752ef34
  a4adb1a7_cf54_091f_eb63_8217e684a8e1["normalizePath()"]
  70054416_c841_dc8b_5bd9_4793198b4325 -->|calls| a4adb1a7_cf54_091f_eb63_8217e684a8e1
  86195de2_9c12_1f7e_7a3e_0754a5695ebe["fileToBuiltUrl()"]
  70054416_c841_dc8b_5bd9_4793198b4325 -->|calls| 86195de2_9c12_1f7e_7a3e_0754a5695ebe
  style 70054416_c841_dc8b_5bd9_4793198b4325 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/vite/src/node/plugins/asset.ts lines 511–533

export async function urlToBuiltUrl(
  pluginContext: PluginContext,
  url: string,
  importer: string,
  forceInline?: boolean,
): Promise<string> {
  const topLevelConfig = pluginContext.environment.getTopLevelConfig()
  if (checkPublicFile(url, topLevelConfig)) {
    return publicFileToBuiltUrl(url, topLevelConfig)
  }
  const file = normalizePath(
    url[0] === '/'
      ? path.join(topLevelConfig.root, url)
      : path.join(path.dirname(importer), url),
  )
  return fileToBuiltUrl(
    pluginContext,
    file,
    // skip public check since we just did it above
    true,
    forceInline,
  )
}