Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

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

Fechada Para iniciantes
  • Algo errado?
#3,786 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 3 dias

@armando-navarro já está trabalhando nisso.

Desde 2/10/2026.

  • #3788 de @armando-navarro — aberto

Avaliação

Dificuldade
1/5
Tempo estimado
Menos de uma hora
Facilidade para iniciantes
92/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
angular, firebase, node.js
Domínio
documentation

Direção de pesquisa

Abra docs/version-21-upgrade.md e leia a seção existente “Other notes” junto com os comandos ng update relatados e a saída do Node.js. Adicione uma nota concisa que cubra a mensagem confusa, por que a CLI mais recente usada temporariamente a causa e as formas documentadas de contorná-la; estará concluído quando o guia de atualização do Angular 21 abordar esse cenário sem alterar o código do AngularFire.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.

Linguagem predominante
TypeScript
Estrelas
7.8k
Forks
2.2k
Merge médio
2d 14h
PRs com merge (30d)
19

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de angular/angularfire

Todas as issues de angular/angularfire

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.