Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Cerrado Apto para principiantes
#3,786 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 3 días

@armando-navarro ya está trabajando en esto.

Desde el 2/10/2026.

  • #3788 de @armando-navarro — abierto

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
92/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
angular, firebase, node.js

Línea de trabajo

Abre docs/version-21-upgrade.md y lee la sección existente “Other notes” junto con los comandos ng update indicados y la salida de Node.js. Añade una nota concisa que cubra el mensaje confuso, por qué lo provoca el uso temporal de la CLI más reciente y las formas documentadas de superarlo; estará hecho cuando la guía de actualización a Angular 21 aborde este escenario sin cambiar el código de AngularFire.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
TypeScript
Estrellas
7.8k
Forks
2.2k
Merge medio
2 d 14 h
PR fusionados (30 d)
19

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de angular/angularfire

Todos los issues de angular/angularfire

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.