Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Versões do Node.js

O Node.js vem pronto em todos os ambientes: node, npm, npx e corepack funcionam no terminal, nos comandos dos seus agentes e nos scripts do npm. Várias versões do Node.js podem ser instaladas lado a lado, e cada projeto usa a que pede.

Qual versão um projeto recebe

node, npm, npx e corepack escolhem a versão nesta ordem:

  1. o arquivo .nvmrc ou .node-version do projeto (procurado da pasta em que você está até a raiz do projeto em ~/Code), como 22, v22.11.0, lts/* ou node;
  2. a versão escolhida para o projeto no painel ou com rdev node use;
  3. a versão padrão.

Um arquivo que pede uma versão que não está instalada para com uma mensagem pedindo que você a instale; o rdev não a instala por conta própria. Intervalos de versão como ^20 não são entendidos; escreva a versão principal em vez disso.

No painel

Abra o servidor em Servidores na barra lateral e depois em Runtime. O card Node.js lista as versões instaladas com a versão exata e quais projetos estão fixados em cada uma. Adicionar versão do Node.js instala outra (a versão atual e as linhas LTS mantidas: 26, 24 e 22 hoje); a versão mais recente dessa linha é baixada de nodejs.org e verificada com os checksums publicados. O menu ⋯ de uma versão a define como padrão ou a remove; a versão padrão e uma versão à qual um projeto está fixado não podem ser removidas. Em Projetos, o lápis ao lado de um projeto o fixa em uma versão ou o devolve ao padrão. Isso exige o rdev 0.2.0-beta.35 ou posterior.

No servidor

rdev node list            # installed and available versions, the default and the pinned projects
rdev node install 22      # the newest Node 22
rdev node default 22
rdev node use shop 22     # pin a project; rdev node use shop default undoes it
rdev node remove 24
rdev node update          # the newest release of every installed version

Os agentes usam os mesmos comandos, e por MCP rdev_node_list, rdev_node_install e rdev_node_project. Enquanto uma assinatura precisa de atenção, instalar, remover e trocar versões ficam pausados, como no PHP.

Pacotes globais

O npm install -g funciona sem sudo, e os pacotes globais são compartilhados por todas as versões do Node.js, então uma CLI que você instala uma vez permanece no PATH seja qual for a versão que um projeto usa. Um pacote com um addon nativo é compilado para a versão que o instalou; reinstale-o após trocar se ele reclamar. Os pacotes instalados globalmente antes do rdev 0.2.0-beta.35 permanecem com a versão que existia então; instale-os de novo uma vez.