fix(@angular/ssr): manage unhandled errors in zoneless applications

Implement the `attachNodeGlobalErrorHandlers` function to handle 'unhandledRejection' and 'uncaughtException' events in Node.js. This function logs errors to the console, preventing unhandled errors from crashing the server. It is particularly useful for zoneless apps, ensuring error handling without relying on zones.

Closes #28581

Author: alan-agius4

goldens/public-api/angular/ssr/node/index.api.md

@@ -12,6 +12,7 @@ import { Type } from '@angular/core';
 
 // @public
 export class AngularNodeAppEngine {
+    constructor();
     getPrerenderHeaders(request: IncomingMessage): ReadonlyMap<string, string>;
     render(request: IncomingMessage, requestContext?: unknown): Promise<Response | null>;
 }

packages/angular/ssr/node/public_api.ts

@@ -13,7 +13,6 @@ export {
 } from './src/common-engine/common-engine';
 
 export { AngularNodeAppEngine } from './src/app-engine';
-
 export { createNodeRequestHandler } from './src/handler';
 export { writeResponseToNodeResponse } from './src/response';
 export { createWebRequestFromNodeRequest } from './src/request';

packages/angular/ssr/node/src/app-engine.ts

@@ -8,6 +8,7 @@
 
 import { AngularAppEngine } from '@angular/ssr';
 import type { IncomingMessage } from 'node:http';
+import { attachNodeGlobalErrorHandlers } from './errors';
 import { createWebRequestFromNodeRequest } from './request';
 
 /**
@@ -23,6 +24,10 @@ import { createWebRequestFromNodeRequest } from './request';
 export class AngularNodeAppEngine {
   private readonly angularAppEngine = new AngularAppEngine();
 
+  constructor() {
+    attachNodeGlobalErrorHandlers();
+  }
+
   /**
    * Renders an HTTP response based on the incoming request using the Angular server application.
    *

packages/angular/ssr/node/src/common-engine/common-engine.ts

@@ -11,6 +11,7 @@ import { renderApplication, renderModule, ɵSERVER_CONTEXT } from '@angular/plat
 import * as fs from 'node:fs';
 import { dirname, join, normalize, resolve } from 'node:path';
 import { URL } from 'node:url';
+import { attachNodeGlobalErrorHandlers } from '../errors';
 import { CommonEngineInlineCriticalCssProcessor } from './inline-css-processor';
 import {
   noopRunMethodAndMeasurePerf,
@@ -63,7 +64,9 @@ export class CommonEngine {
   private readonly inlineCriticalCssProcessor = new CommonEngineInlineCriticalCssProcessor();
   private readonly pageIsSSG = new Map<string, boolean>();
 
-  constructor(private options?: CommonEngineOptions) {}
+  constructor(private options?: CommonEngineOptions) {
+    attachNodeGlobalErrorHandlers();
+  }
 
   /**
    * Render an HTML document for a specific URL with specified

packages/angular/ssr/node/src/errors.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+
+/**
+ * Attaches listeners to the Node.js process to capture and handle unhandled rejections and uncaught exceptions.
+ * Captured errors are logged to the console. This function logs errors to the console, preventing unhandled errors
+ * from crashing the server. It is particularly useful for Zoneless apps, ensuring error handling without relying on Zone.js.
+ *
+ * @developerPreview
+ */
+export function attachNodeGlobalErrorHandlers(): void {
+  // Ensure that the listeners are registered only once.
+  // Otherwise, multiple instances may be registered during edit/refresh.
+  const gThis: typeof globalThis & { ngAttachNodeGlobalErrorHandlersCalled?: boolean } = globalThis;
+  if (gThis.ngAttachNodeGlobalErrorHandlersCalled) {
+    return;
+  }
+
+  gThis.ngAttachNodeGlobalErrorHandlersCalled = true;
+
+  process
+    // eslint-disable-next-line no-console
+    .on('unhandledRejection', (error) => console.error('unhandledRejection', error))
+    // eslint-disable-next-line no-console
+    .on('uncaughtException', (error) => console.error('uncaughtException', error));
+}