Version de Node.js

Auteur:Esadax
Mise à jour:6 avr. 2025

Le paramètre Version Node.js détermine quelle version de Node.js est utilisée lors de l'étape Build de votre projet ainsi que pour l'exécution de Serverless Functions.


Pourquoi définir la version Node.js?

  • Assure la compatibilité avec les dépendances et la base de code de votre projet.
  • Aide à éviter les erreurs d'exécution inattendues causées par des incompatibilités de version.
  • Contrôle l'environnement dans lequel votre compilation et vos fonctions sans serveur s'exécutent.

Changer la version de Node.js

Pour modifier la version Node.js, il suffit de sélectionner la version souhaitée parmi les options disponibles. Après avoir mis à jour ce paramètre, un nouveau déploiement est requis pour que la modification prenne effet.


Important: Spécifiez le moteur Node.js dans package.json

Pour vous assurer que votre projet utilise toujours la bonne version de Node.js, spécifiez toujours la version du moteur Node.js dans votre fichier package.json :

{
  "engines": {
    "node": ">=14.0.0 <19.0.0"
  }
}

Cela aide Esadax et les autres environnements à savoir quelle version de Node.js votre projet attend.


Prise en charge des anciennes versions de Node.js

Si votre projet dépend d'anciennes versions de Node.js, Esadax les prend en charge via des versions de moteur prédéfinies. Vous pouvez spécifier des versions héritées dans votre package.json pour maintenir la compatibilité avec les anciennes bases de code ou dépendances.


Comment ça marche?

  • L'environnement de construction utilise la version Node.js sélectionnée pour installer les dépendances et exécuter les scripts de construction.
  • Serverless Functions s'exécute en utilisant la même version de Node.js pour assurer la cohérence.

Exemples de cas d'utilisation

  • Vous utilisez un framework moderne qui nécessite Node.js 18+.
  • Votre projet repose sur des packages hérités uniquement compatibles avec Node.js 12 ou 14.