angular/integration/platform-server
Alan Agius 9d1fb33f5e fix(core): introduce BootstrapContext for improved server bootstrapping (#63640)
This commit introduces a number of changes to the server bootstrapping process to make it more robust and less error-prone, especially for concurrent requests.

Previously, the server rendering process relied on a module-level global platform injector. This could lead to issues in server-side rendering environments where multiple requests are processed concurrently, as they could inadvertently share or overwrite the global injector state.

The new approach introduces a `BootstrapContext` that is passed to the `bootstrapApplication` function. This context provides a platform reference that is scoped to the individual request, ensuring that each server-side render has an isolated platform injector. This prevents state leakage between concurrent requests and makes the overall process more reliable.

BREAKING CHANGE:
The server-side bootstrapping process has been changed to eliminate the reliance on a global platform injector.

Before:
```ts
const bootstrap = () => bootstrapApplication(AppComponent, config);
```

After:
```ts
const bootstrap = (context: BootstrapContext) =>
  bootstrapApplication(AppComponent, config, context);
```

A schematic is provided to automatically update `main.server.ts` files to pass the `BootstrapContext` to the `bootstrapApplication` call.

In addition, `getPlatform()` and `destroyPlatform()` will now return `null` and be a no-op respectively when running in a server environment.

(cherry picked from commit 8bf80c9d2314b4f2bcf3df83ae01552a6fc49834)

PR Close #63640
2025-09-09 10:46:27 -07:00
..
e2e refactor: update license text to point to angular.dev (#57902) 2024-09-24 15:28:46 +02:00
projects fix(core): introduce BootstrapContext for improved server bootstrapping (#63640) 2025-09-09 10:46:27 -07:00
.editorconfig test: update platform-server integration tests to use the Angular CLI (#49900) 2023-04-18 19:47:02 +00:00
.gitignore test: update platform-server integration tests to use the Angular CLI (#49900) 2023-04-18 19:47:02 +00:00
angular.json test: disable cache and analytics (#57863) 2024-09-19 11:14:23 +02:00
BUILD.bazel build: trigger error when size-tracking is enabled but not in limit file (#55708) 2024-05-07 13:39:56 -07:00
package.json build: remove tslint and codelyzer deps from integration tests (#55658) 2024-05-03 08:15:41 -07:00
README.md test: update platform-server integration tests to use the Angular CLI (#49900) 2023-04-18 19:47:02 +00:00
tsconfig.json test: refactor platform-server integration tests to use application builder (#53205) 2023-11-28 11:07:01 +01:00
yarn.lock build: update cross-repo angular dependencies (#56364) 2024-06-11 12:35:47 -07:00

PlatformServer

This project was generated with Angular CLI version 16.0.0-rc.0.

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The application will automatically reload if you change any of the source files.

Code scaffolding

Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.

Build

Run ng build to build the project. The build artifacts will be stored in the dist/ directory.

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via a platform of your choice. To use this command, you need to first add a package that implements end-to-end testing capabilities.

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI Overview and Command Reference page.