resolveResolveOptions() — vite Function Reference

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

Function typescript ViteCore ConfigEngine calls 4 called by 1

Entity Profile

ViteCore→ ConfigEngine→ resolveResolveOptions() — vite Function Reference

Dependency Diagram

graph TD
  01b194b8_315a_2e85_b615_43b3a3adada7["resolveResolveOptions()"]
  7da774f9_eca5_d54e_6e01_6bee7d460a2b["config.ts"]
  01b194b8_315a_2e85_b615_43b3a3adada7 -->|defined in| 7da774f9_eca5_d54e_6e01_6bee7d460a2b
  58c4a210_68fe_1b4d_ed49_d59203f97ef1["resolveConfig()"]
  58c4a210_68fe_1b4d_ed49_d59203f97ef1 -->|calls| 01b194b8_315a_2e85_b615_43b3a3adada7
  c5290540_7ca0_9946_2a49_16619ea18ef6["normalizeAlias()"]
  01b194b8_315a_2e85_b615_43b3a3adada7 -->|calls| c5290540_7ca0_9946_2a49_16619ea18ef6
  ffdca39a_602b_3cd5_f0cb_b04f94c0de84["mergeAlias()"]
  01b194b8_315a_2e85_b615_43b3a3adada7 -->|calls| ffdca39a_602b_3cd5_f0cb_b04f94c0de84
  1281fc07_d07b_eda1_0adf_a01736cf4431["resolveEnvironmentResolveOptions()"]
  01b194b8_315a_2e85_b615_43b3a3adada7 -->|calls| 1281fc07_d07b_eda1_0adf_a01736cf4431
  00831e67_fe39_7ed4_eed0_e29cb8e15286["warn()"]
  01b194b8_315a_2e85_b615_43b3a3adada7 -->|calls| 00831e67_fe39_7ed4_eed0_e29cb8e15286
  style 01b194b8_315a_2e85_b615_43b3a3adada7 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/vite/src/node/config.ts lines 1129–1165

function resolveResolveOptions(
  resolve: AllResolveOptions | undefined,
  logger: Logger,
): ResolvedAllResolveOptions {
  // resolve alias with internal client alias
  const alias = normalizeAlias(
    mergeAlias(clientAlias, resolve?.alias || configDefaults.resolve.alias),
  )
  const preserveSymlinks =
    resolve?.preserveSymlinks ?? configDefaults.resolve.preserveSymlinks

  if (alias.some((a) => a.find === '/')) {
    logger.warn(
      colors.yellow(
        `\`resolve.alias\` contains an alias that maps \`/\`. ` +
          `This is not recommended as it can cause unexpected behavior when resolving paths.`,
      ),
    )
  }
  if (alias.some((a) => a.customResolver)) {
    logger.warn(
      colors.yellow(
        `\`resolve.alias\` contains an alias with \`customResolver\` option. ` +
          `This is deprecated and will be removed in Vite 9. ` +
          `Please use a custom plugin with a resolveId hook and \`enforce: 'pre'\` instead.`,
      ),
    )
  }

  return resolveEnvironmentResolveOptions(
    resolve,
    alias,
    preserveSymlinks,
    logger,
    undefined,
  )
}