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

alan-agius4 · alan-agius4 · commit ee5c5f823c87 · 2025-09-10T21:21:49.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/build/src/builders/dev-server/vite-server.ts b/packages/angular/build/src/builders/dev-server/vite-server.ts
@@ -447,6 +447,7 @@ export async function* serveWithVite(
         browserOptions.loader as EsbuildLoaderOption | undefined,
         {
           ...browserOptions.define,
+          'ngJitMode': browserOptions.aot ? 'false' : 'true',
           'ngHmrMode': browserOptions.templateUpdates ? 'true' : 'false',
         },
         extensions?.middleware,
diff --git a/packages/angular/ssr/BUILD.bazel b/packages/angular/ssr/BUILD.bazel
@@ -30,6 +30,7 @@ ts_project(
     deps = [
         "//:node_modules/@angular/common",
         "//:node_modules/@angular/core",
+        "//:node_modules/@angular/platform-browser",
         "//:node_modules/@angular/platform-server",
         "//:node_modules/@angular/router",
         "//:node_modules/tslib",
diff --git a/packages/angular_devkit/build_angular/BUILD.bazel b/packages/angular_devkit/build_angular/BUILD.bazel
@@ -142,6 +142,7 @@ ts_project(
         "//:node_modules/@angular/compiler-cli",
         "//:node_modules/@angular/core",
         "//:node_modules/@angular/localize",
+        "//:node_modules/@angular/platform-browser",
         "//:node_modules/@angular/platform-server",
         "//:node_modules/@angular/service-worker",
         "//:node_modules/@babel/core",
diff --git a/packages/schematics/angular/server/files/application-builder/standalone-src/main.server.ts.template b/packages/schematics/angular/server/files/application-builder/standalone-src/main.server.ts.template
@@ -3,6 +3,6 @@ import { AppComponent } from './app/app.component';
 import { config } from './app/app.config.server';
 
 const bootstrap = (context: BootstrapContext) =>
-    bootstrapApplication(AppComponent, config, BootstrapContext);
+    bootstrapApplication(AppComponent, config, context);
 
 export default bootstrap;
diff --git a/packages/schematics/angular/server/files/server-builder/standalone-src/main.server.ts.template b/packages/schematics/angular/server/files/server-builder/standalone-src/main.server.ts.template
@@ -3,6 +3,6 @@ import { AppComponent } from './app/app.component';
 import { config } from './app/app.config.server';
 
 const bootstrap = (context: BootstrapContext) =>
-    bootstrapApplication(AppComponent, config, BootstrapContext);
+    bootstrapApplication(AppComponent, config, context);
 
 export default bootstrap;

Original file line number	Diff line number	Diff line change
`@@ -447,6 +447,7 @@ export async function* serveWithVite(`
`447`	`447`	`browserOptions.loader as EsbuildLoaderOption \| undefined,`
`448`	`448`	`{`
`449`	`449`	`...browserOptions.define,`
	`450`	`+ 'ngJitMode': browserOptions.aot ? 'false' : 'true',`
`450`	`451`	`'ngHmrMode': browserOptions.templateUpdates ? 'true' : 'false',`
`451`	`452`	`},`
`452`	`453`	`extensions?.middleware,`