Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

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

Fermée Adaptée aux débutants
  • Quelque chose ne va pas ?
#3,786 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 3 jours

@armando-navarro y travaille déjà.

Depuis le 2/10/2026.

  • #3788 par @armando-navarro — ouverte

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
92/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
angular, firebase, node.js
Domaine
documentation

Piste de recherche

Ouvrez docs/version-21-upgrade.md et lisez la section existante « Other notes » avec les commandes ng update signalées et la sortie de Node.js. Ajoutez une note concise couvrant le message déroutant, la raison pour laquelle la CLI la plus récente utilisée temporairement le provoque et les moyens documentés de le contourner ; c’est terminé lorsque le guide de mise à niveau vers Angular 21 traite ce scénario sans modifier le code AngularFire.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.

Langage dominant
TypeScript
Étoiles
7.8k
Forks
2.2k
Merge moyen
2 j 14 h
PR mergées (30 j)
19

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de angular/angularfire

Toutes les issues de angular/angularfire

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.