optimizeSafeRealPathSync() — vite Function Reference

Architecture documentation for the optimizeSafeRealPathSync() function in utils.ts from the vite codebase.

Function typescript ViteCore ConfigEngine called by 1

Entity Profile

ViteCore→ ConfigEngine→ optimizeSafeRealPathSync() — vite Function Reference

Dependency Diagram

graph TD
  49983da6_08ff_5c1b_b63f_c429d1e6b269["optimizeSafeRealPathSync()"]
  031bc221_67a8_c579_f2bf_bb30a08beeb2["utils.ts"]
  49983da6_08ff_5c1b_b63f_c429d1e6b269 -->|defined in| 031bc221_67a8_c579_f2bf_bb30a08beeb2
  b37c4caa_8852_a76d_d1fb_15d16a693604["windowsSafeRealPathSync()"]
  b37c4caa_8852_a76d_d1fb_15d16a693604 -->|calls| 49983da6_08ff_5c1b_b63f_c429d1e6b269
  style 49983da6_08ff_5c1b_b63f_c429d1e6b269 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/vite/src/node/utils.ts lines 708–735

function optimizeSafeRealPathSync() {
  // Check the availability `fs.realpathSync.native`
  // in Windows virtual and RAM disks that bypass the Volume Mount Manager, in programs such as imDisk
  // get the error EISDIR: illegal operation on a directory
  try {
    fs.realpathSync.native(path.resolve('./'))
  } catch (error) {
    if (error.message.includes('EISDIR: illegal operation on a directory')) {
      safeRealpathSync = fs.realpathSync
      return
    }
  }
  exec('net use', (error, stdout) => {
    if (error) return
    const lines = stdout.split('\n')
    // OK           Y:        \\NETWORKA\Foo         Microsoft Windows Network
    // OK           Z:        \\NETWORKA\Bar         Microsoft Windows Network
    for (const line of lines) {
      const m = parseNetUseRE.exec(line)
      if (m) windowsNetworkMap.set(m[2], m[1])
    }
    if (windowsNetworkMap.size === 0) {
      safeRealpathSync = fs.realpathSync.native
    } else {
      safeRealpathSync = windowsMappedRealpathSync
    }
  })
}