Versione di Node.js

Autore:Esadax
Aggiornato:6 apr 2025

L'impostazione Versione Node.js determina quale versione di Node.js viene utilizzata durante il Passaggio di compilazione del progetto e per l'esecuzione di Funzioni serverless.


Perché impostare la versione Node.js?

  • Assicura la compatibilità con le dipendenze e la base di codice del progetto.
  • Consente di evitare errori di runtime imprevisti causati da discrepanze di versione.
  • Controlla l'ambiente in cui vengono eseguite la build e le funzioni serverless.

Cambiare la versione di Node.js

Per cambiare la versione di Node.js, è sufficiente selezionare la versione desiderata tra le opzioni disponibili. Dopo aver aggiornato questa impostazione, è necessaria una nuova distribuzione affinché la modifica abbia effetto.


Importante: specificare il motore Node.js in package.json

Per assicurarti che il tuo progetto utilizzi sempre la versione corretta di Node.js, specifica sempre la versione del motore Node.js nel file package.json:

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

Questo aiuta sia Esadax che altri ambienti a sapere quale versione di Node.js si aspetta il tuo progetto.


Supporto per le versioni precedenti di Node.js

Se il tuo progetto dipende da versioni precedenti di Node.js, Esadax le supporta attraverso versioni di motore preimpostate. Puoi specificare versioni legacy nel tuo package.json per mantenere la compatibilità con codebase o dipendenze precedenti.


Ecco come funziona

  • L'ambiente di compilazione utilizza la versione Node.js selezionata per installare le dipendenze ed eseguire gli script di compilazione.
  • Le funzioni serverless vengono eseguite utilizzando la stessa versione di Node.js per garantire la coerenza.

Esempi di casi d'uso

  • Stai utilizzando un framework moderno che richiede Node.js 18+.
  • Il tuo progetto si basa su pacchetti legacy compatibili solo con Node.js 12 o 14.