Node.js staat in elke omgeving klaar: node, npm, npx en corepack werken in de terminal, in de opdrachten van je agents en in npm-scripts. Meerdere Node.js-versies kunnen naast elkaar worden geïnstalleerd en elk project gebruikt de versie waar het om vraagt.
Welke versie een project krijgt
node, npm, npx en corepack kiezen de versie in deze volgorde:
- het bestand
.nvmrcof.node-versionvan het project (opgezocht vanaf de map waarin je zit tot de root van het project in~/Code), zoals22,v22.11.0,lts/*ofnode; - de versie die in het paneel of met
rdev node usevoor het project is gekozen; - de standaardversie.
Een bestand dat om een niet-geïnstalleerde versie vraagt, stopt met een melding dat je haar moet installeren; rdev installeert haar niet zelf. Versiebereiken zoals ^20 worden niet begrepen; schrijf in plaats daarvan de hoofdversie.
In het paneel
Open de server via Servers in de zijbalk en ga dan naar Runtime. De kaart Node.js toont de geïnstalleerde versies met hun exacte release en welke projecten aan elk zijn vastgepind. Node.js-versie toevoegen installeert er nog een (de huidige release en de onderhouden LTS-lijnen: nu 26, 24 en 22); de nieuwste release van die versie wordt van nodejs.org gedownload en gecontroleerd aan de hand van de gepubliceerde checksums. Het menu ⋯ bij een versie maakt haar de standaard of verwijdert haar; de standaard en een versie waaraan een project is vastgepind kunnen niet worden verwijderd. Onder Projecten pint het potlood naast een project het vast aan een versie of stuurt het terug naar de standaard. Hiervoor is rdev 0.2.0-beta.35 of nieuwer nodig.
Op de server
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
Agents gebruiken dezelfde opdrachten, en via MCP rdev_node_list, rdev_node_install en rdev_node_project. Zolang een abonnement aandacht nodig heeft, zijn het installeren, verwijderen en wisselen van versies gepauzeerd, net als bij PHP.
Globale pakketten
npm install -g werkt zonder sudo en globale pakketten worden door elke Node.js-versie gedeeld, dus een CLI die je één keer installeert blijft op het PATH staan, welke versie een project ook gebruikt. Een pakket met een native addon wordt gebouwd voor de versie die het installeerde; installeer het opnieuw na het wisselen als het klaagt. Pakketten die vóór rdev 0.2.0-beta.35 globaal zijn geïnstalleerd, blijven bij de versie die er toen was; installeer ze eenmalig opnieuw.