fix(@angular-devkit/build-angular): avoid extra tick in SSR builds

alan-agius4 · alan-agius4 · commit 700e6bc0177a · 2025-09-10T21:42:22.000+02:00
In SSR applications, an unnecessary event loop tick during server startup could lead to an incorrect platform being initialized.

This change introduces an `ngJitMode` define, which is set to `false` during AOT builds. This allows for the JIT-specific code paths to not be followed, preventing the async operations that caused the extra tick. This ensures that the server platform is correctly and synchronously initialized.
diff --git a/packages/angular_devkit/build_angular/src/builders/server/index.ts b/packages/angular_devkit/build_angular/src/builders/server/index.ts
@@ -212,7 +212,18 @@ async function initialize(
         wco.buildOptions.supportedBrowsers ??= [];
         wco.buildOptions.supportedBrowsers.push(...browserslist('maintained node versions'));
 
-        return [getPlatformServerExportsConfig(wco), getCommonConfig(wco), getStylesConfig(wco)];
+        return [
+          getPlatformServerExportsConfig(wco),
+          getCommonConfig(wco),
+          getStylesConfig(wco),
+          {
+            plugins: [
+              new webpack.DefinePlugin({
+                'ngJitMode': false,
+              }),
+            ],
+          },
+        ];
       },
     );
 
