resolveBaseUrl() — vite Function Reference

Architecture documentation for the resolveBaseUrl() function in config.ts from the vite codebase.

Function typescript ViteCore ConfigEngine calls 2 called by 1

Entity Profile

ViteCore→ ConfigEngine→ resolveBaseUrl() — vite Function Reference

Dependency Diagram

graph TD
  7de0d4f8_218f_327e_dfe8_e59e3875d508["resolveBaseUrl()"]
  7da774f9_eca5_d54e_6e01_6bee7d460a2b["config.ts"]
  7de0d4f8_218f_327e_dfe8_e59e3875d508 -->|defined in| 7da774f9_eca5_d54e_6e01_6bee7d460a2b
  58c4a210_68fe_1b4d_ed49_d59203f97ef1["resolveConfig()"]
  58c4a210_68fe_1b4d_ed49_d59203f97ef1 -->|calls| 7de0d4f8_218f_327e_dfe8_e59e3875d508
  23257aa1_5e3f_7e6e_1b43_875b139e4ec5["isExternalUrl()"]
  7de0d4f8_218f_327e_dfe8_e59e3875d508 -->|calls| 23257aa1_5e3f_7e6e_1b43_875b139e4ec5
  00831e67_fe39_7ed4_eed0_e29cb8e15286["warn()"]
  7de0d4f8_218f_327e_dfe8_e59e3875d508 -->|calls| 00831e67_fe39_7ed4_eed0_e29cb8e15286
  style 7de0d4f8_218f_327e_dfe8_e59e3875d508 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/vite/src/node/config.ts lines 2167–2205

export function resolveBaseUrl(
  base: UserConfig['base'] = configDefaults.base,
  isBuild: boolean,
  logger: Logger,
): string {
  if (base[0] === '.') {
    logger.warn(
      colors.yellow(
        colors.bold(
          `(!) invalid "base" option: "${base}". The value can only be an absolute ` +
            `URL, "./", or an empty string.`,
        ),
      ),
    )
    return '/'
  }

  // external URL flag
  const isExternal = isExternalUrl(base)
  // no leading slash warn
  if (!isExternal && base[0] !== '/') {
    logger.warn(
      colors.yellow(
        colors.bold(`(!) "base" option should start with a slash.`),
      ),
    )
  }

  // parse base when command is serve or base is not External URL
  if (!isBuild || !isExternal) {
    base = new URL(base, 'http://vite.dev').pathname
    // ensure leading slash
    if (base[0] !== '/') {
      base = '/' + base
    }
  }

  return base
}