Stabilizing --config-loader=runner / --config-loader=native

[sapphi-red]

--config-loader=runner

• Added as experimental in [email protected]
• Original PR by @sheremet-va

--config-loader=native

• Added as exprimental in [email protected]
• Original PR by @bluwy

---

Current limitations of each options

• --config-loader=bundle (default) (uses esbuild to bundle the config and execute that bundled file)
  • the bundled file is written to disk
    • There will be temporary vite.config.js.timestamp files that have not been cleaned up #13267
    • avoid writing the temporary file when evaluating the config file #9470
    • Cannot start Vite 6 due to .vite-temp directory creation in node_modules #18839
    • vite 6 breaks deno support when npm: specifer is used in config file #18822)
    • this can be solved by loading via data URL (fix: load esm vite config without a temporary file #17894)
  • __dirname / dynamic import may work differently when it's not statically analyzable
    • to avoid this happening, we externalize the dependencies: vite.config.ts can't import untranspiled ts files from other packages in the same monorepo #5370, fix: avoid externalizing plugins that resolve to local files in monorepos #17323
  • doesn't respect --conditions (Respect conditions arg from node #11838)
    • Add a way to get the enabled conditions nodejs/node#55824, module: add module.customConditions nodejs/node#57688
  • behaves slightly different from normal Node.js (can be seen as a feature though)
• --config-loader=runner (uses module runner, it will transform the files on-demand)
  • can support ESM configs that doesn't have .mjs or type=module
  • deferred dynamic imports does not work (feat: use module runner to import the config #18637 (comment))
  • doesn't respect --conditions (Respect conditions arg from node #11838)
    • Add a way to get the enabled conditions nodejs/node#55824, module: add module.customConditions nodejs/node#57688
  • behaves slightly different from normal Node.js (can be seen as a feature though)
• --config-loader=native (uses dynamic import, it will use the transform supported by the runtime or the registered Node.js loaders)
  • cannot support ESM configs that doesn't have .mjs or type=module (will be unblocked by syntax detection?)
  • does not support server restart when imported modules are changed
    • For Node.js, this can be solved by a loader (feat: track dependencies when loading config with native #19374)

---

We're creating this discussion to gather feedback about this feature, so we can later use it while moving it out of experimental. We are also considering which config loader should be the default. Also we may remove the non-default ones.