feat(optimizer): allow users to specify their esbuild platform option (#18611)

Co-authored-by: 翠 / green <green@sapphi.red>

Author: dario-piotrowicz

packages/vite/src/node/optimizer/esbuildDepPlugin.ts

@@ -304,7 +304,7 @@ const matchesEntireLine = (text: string) => `^${escapeRegex(text)}$`
 // https://github.com/evanw/esbuild/issues/566#issuecomment-735551834
 export function esbuildCjsExternalPlugin(
   externals: string[],
-  platform: 'node' | 'browser',
+  platform: 'node' | 'browser' | 'neutral',
 ): Plugin {
   return {
     name: 'cjs-external',

packages/vite/src/node/optimizer/index.ts

@@ -761,7 +761,15 @@ async function prepareEsbuildOptimizerRun(
     ),
   }
 
-  const platform = environment.config.consumer === 'client' ? 'browser' : 'node'
+  const platform =
+    optimizeDeps.esbuildOptions?.platform ??
+    // We generally don't want to use platform 'neutral', as esbuild has custom handling
+    // when the platform is 'node' or 'browser' that can't be emulated by using mainFields
+    // and conditions
+    (environment.config.consumer === 'client' ||
+    environment.config.ssr.target === 'webworker'
+      ? 'browser'
+      : 'node')
 
   const external = [...(optimizeDeps?.exclude ?? [])]
 
@@ -775,9 +783,6 @@ async function prepareEsbuildOptimizerRun(
     absWorkingDir: process.cwd(),
     entryPoints: Object.keys(flatIdDeps),
     bundle: true,
-    // We can't use platform 'neutral', as esbuild has custom handling
-    // when the platform is 'node' or 'browser' that can't be emulated
-    // by using mainFields and conditions
     platform,
     define,
     format: 'esm',