Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

The upgrade guide does not cover `ng update` stopping on a Node.js version message

Geschlossen Anfängerfreundlich
#3,786 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 3 Tagen

@armando-navarro arbeitet bereits daran.

Seit 02.10.2026.

  • #3788 von @armando-navarro — offen

Bewertung

Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Anfängerfreundlichkeit
92/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
angular, firebase, node.js
Bereich
documentation

Rechercherichtung

Öffne docs/version-21-upgrade.md und lies den vorhandenen Abschnitt „Other notes“ zusammen mit den gemeldeten ng update-Befehlen und der Node.js-Ausgabe. Füge eine prägnante Notiz hinzu, die die verwirrende Meldung, den Grund, aus dem die vorübergehende Verwendung der neuesten CLI sie verursacht, und die dokumentierten Wege daran vorbei abdeckt; fertig ist es, wenn der Angular 21-Upgrade-Leitfaden dieses Szenario behandelt, ohne den AngularFire-Code zu ändern.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

comp: docs type: chore version: current (v17+)

In an app that is already on Angular 21, ng update @angular/fire@next can stop before it updates anything:

Installing a temporary Angular CLI versioned latest to perform the update.
Node.js version v22.22.1 detected.
The Angular CLI requires a minimum Node.js version of v22.22.3 or v24.15.0 or v26.0.0.

Node.js 22.22.1 is a version Angular 21 supports, so the message is confusing, and docs/version-21-upgrade.md does not mention it.

Why it happens
  • ng update chooses which Angular CLI runs the update from the first @angular/ package in the command. If that package has no version number, it downloads @angular/cli@latest.
  • @angular/cli@latest is 22.2.1, which requires Node.js ^22.22.3 || ^24.15.0 || >=26.0.0. Angular CLI 21 accepts ^20.19.0 || ^22.12.0 || >=24.0.0.
  • On a Node.js version in between, the downloaded CLI refuses to start. This is Angular CLI behavior, and it happens before any AngularFire code runs.
What I ran

On Node.js 22.22.1, on 2026-10-02:

  • ng update @angular/fire and ng update @angular/fire@next in an Angular 21 app both stop with the message above.
  • ng update @angular/[email protected] in the same app does not.
  • The guide's own command, ng update @angular/core@21 @angular/cli@21 @angular/fire@next, is not affected. It ran with a temporary Angular CLI 21.2.24 and completed.
Proposed change

A bullet under "Other notes" naming the message, the cause, and the two ways past it: update Node.js, or give the first @angular/ package a version number.

Vorherrschende Sprache
TypeScript
Sterne
7.8k
Forks
2.2k
Ø Merge
2 T. 14 Std.
Gemergte PRs (30 T.)
19

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/angularfire

Alle Issues in angular/angularfire

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

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