angular/packages/core/schematics/migrations.json
Alan Agius 6117ccee2e feat(core): introduce BootstrapContext for improved server bootstrapping (#63636)
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 #63636
2025-09-09 10:45:02 -07:00

36 lines
1.4 KiB
JSON

{
"schematics": {
"inject-flags": {
"version": "20.0.0",
"description": "Replaces usages of the deprecated InjectFlags enum",
"factory": "./bundles/inject-flags.cjs#migrate"
},
"test-bed-get": {
"version": "20.0.0",
"description": "Replaces usages of the deprecated TestBed.get method with TestBed.inject",
"factory": "./bundles/test-bed-get.cjs#migrate"
},
"control-flow-migration": {
"version": "20.0.0",
"description": "Converts the entire application to block control flow syntax",
"factory": "./bundles/control-flow-migration.cjs#migrate",
"optional": true
},
"document-core": {
"version": "20.0.0",
"description": "Moves imports of `DOCUMENT` from `@angular/common` to `@angular/core`",
"factory": "./bundles/document-core.cjs#migrate"
},
"router-current-navigation": {
"version": "20.2.0",
"description": "Replaces usages of the deprecated Router.getCurrentNavigation method with the Router.currentNavigation signal",
"factory": "./bundles/router-current-navigation.cjs#migrate",
"optional": true
},
"add-bootstrap-context-to-server-main": {
"version": "20.3.0",
"description": "Adds `BootstrapContext` to `bootstrapApplication` calls in `main.server.ts` to support server rendering.",
"factory": "./bundles/add-bootstrap-context-to-server-main.cjs#migrate"
}
}
}