ng add @angular/ssr fails with TypeError when an NgModule in the app module file has no bootstrap array

Offen Anfängerfreundlich
#34,761 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

@0z5a arbeitet bereits daran.

Seit 19.11.2026.

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
90/100
Issue-Typ
Bug
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
angular, typescript

Rechercherichtung

Beginne in packages/schematics/angular/utility/standalone/app_component.ts, in resolveNgModuleBasedData, und untersuche, wie @NgModule-Dekoratoren ohne ein bootstrap-Feld behandelt werden. Lies die vorhandenen Prüfungen in der Nähe und überprüfe anschließend die Abdeckung des Server-Schematics in server/index_spec.ts. Fertig ist die Änderung, wenn Dekoratoren ohne bootstrap übersprungen werden, sich die beiden gemeldeten Fälle wie beschrieben verhalten und die gezielten Tests bestehen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

area: @schematics/angular
Command

add

Is this a regression?
  • Yes, this behavior used to work in the previous version
The previous version in which this bug was not present was

I think before the server schematic started inferring the app component name (commit ea1143dd, April 2025). I have not run an older release to confirm.

Description

ng add @angular/ssr (and ng generate server) crashes on an NgModule-based app when one of the @NgModule decorators in the file that main.ts bootstraps has no bootstrap array. The cases I hit:

  1. The root module uses ngDoBootstrap() instead of bootstrap: [...] (Angular Elements apps, AngularJS hybrid apps that bootstrap through UpgradeModule).
  2. The file declares another @NgModule without bootstrap (for example a small shared module) before the root module.

In packages/schematics/angular/utility/standalone/app_component.ts, resolveNgModuleBasedData loops over the module's @NgModule decorators and does:

const bootstrapProp = getMetadataField(node, 'bootstrap').find(...);
const componentIdentifier = (bootstrapProp?.initializer as ts.ArrayLiteralExpression)
  .elements[0] as ts.Identifier | undefined;

When bootstrapProp is undefined, the optional chain stops at initializer and .elements is read from undefined. The function is meant to return null in that case: the caller in server/index.ts already falls back to App / AppModule when nothing is found. So the schematic stops with a TypeError instead of using the fallback (case 1) or the right module (case 2).

Minimal Reproduction
  1. ng new demo --no-standalone
  2. In src/app/app-module.ts, remove bootstrap: [App] and add ngDoBootstrap() {} to AppModule.
  3. ng add @angular/ssr

Or, for case 2, keep bootstrap: [App] and put this above AppModule in the same file:

@NgModule({ exports: [] })
export class SharedModule {}

I reproduced this with SchematicTestRunner against @schematics/angular 22.3.0 (workspace -> application --standalone=false -> edit the module -> server and ssr schematics). Both schematics throw for case 1, and server throws for case 2. The unmodified app works.

Exception or Error
TypeError: Cannot read properties of undefined (reading 'elements')
    at resolveNgModuleBasedData (node_modules/@schematics/angular/utility/standalone/app_component.js:65:14)
Your Environment
@schematics/angular 22.3.0
@angular-devkit/schematics 22.3.0
Node.js 22.23.5
Anything else relevant?

Skipping decorators that have no bootstrap field (continue, like the ts.isObjectLiteralExpression check just above it) is enough to fix both cases: case 2 then finds AppModule, and case 1 falls through to the existing fallback. I have a patch with two tests in server/index_spec.ts and can open a PR.

Vorherrschende Sprache
TypeScript
Sterne
27k
Forks
11.8k
Ø Merge
1 T. 2 Std.
Gemergte PRs (30 T.)
225

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus angular/angular-cli

Alle Issues in angular/angular-cli

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.