Condividi tramite

Esercitazione: Node.js per principianti

Se non si ha familiarità con l'uso di Node.js, questa guida ti aiuterà a iniziare a usare alcune nozioni di base.

Prerequisiti

Provare NodeJS con Visual Studio Code

Se Visual Studio Code non è ancora stato installato, tornare alla sezione dei prerequisiti precedente e seguire la procedura di installazione collegata per Windows o WSL.

  1. Aprire la riga di comando e creare una nuova directory: mkdir HelloNode, quindi immettere la directory: cd HelloNode

  2. Aprire la directory in VS Code usando il comando : code .

  3. Creare un file denominato "app.js"

  4. Aggiungere una stringa semplice "Hello World" a una variabile denominata msg, quindi inviare il contenuto della stringa alla console immettendolo nel file "app.js":

    var msg = 'Hello World';
console.log(msg);

  5. Per eseguire il file "app.js" con Node.js. Aprire il terminale direttamente all'interno di VS Code selezionando Visualizza>terminale (o premere CTRL+', usando il carattere di backtick). Se è necessario modificare il terminale predefinito, selezionare il menu a discesa e scegliere Seleziona shell predefinita.

  6. Nel terminale immettere: node app.js. Dovresti vedere l'output: "Hello World".

Annotazioni

Si noti che quando si digita console nel file "app.js", VS Code visualizza le opzioni supportate correlate all'oggetto console da scegliere usando IntelliSense. Provare a sperimentare con IntelliSense usando altri oggetti JavaScript .

Creare la prima app Web NodeJS con Express

Express è un framework di Node.js minimo, flessibile e semplificato che semplifica lo sviluppo di un'app Web in grado di gestire più tipi di richieste, ad esempio GET, PUT, POST e DELETE. Express viene fornito con un generatore di applicazioni che creerà automaticamente un'architettura di file per l'app.

Per creare un progetto con Express.js:

  1. Apri il terminale (Prompt dei comandi, PowerShell o quello che preferisci).

  2. Creare una nuova cartella del progetto: mkdir ExpressProjects e accedere a tale directory: cd ExpressProjects

  3. Usare Express per creare un modello di progetto HelloWorld: npx express-generator HelloWorld --view=pug

    Annotazioni

    Il comando viene usato npx qui per eseguire il pacchetto node Express.js senza installarlo effettivamente (o installandolo temporaneamente a seconda del modo in cui si vuole pensarlo). Se si tenta di usare il express comando o controllare la versione di Express installata usando : express --version, si riceverà una risposta che Non è possibile trovare Express. Se si vuole installare a livello globale Express per usare più volte e più volte, usare : npm install -g express-generator. È possibile visualizzare un elenco dei pacchetti installati da npm usando npm list. Verranno ordinati in base alla profondità (il numero di directory annidate). I pacchetti che hai installato sono al livello 0 di profondità. Le dipendenze del pacchetto saranno a profondità 1, le dipendenze successive a profondità 2 e così via. Per altre informazioni, vedere Differenza tra npx e npm? in StackOverflow.

  4. Esaminare i file e le cartelle inclusi in Express aprendo il progetto in VS Code, con: code .

    I file generati da Express creeranno un'app Web che usa un'architettura che può sembrare un po' difficile all'inizio.The files that Express generate will create a web app that uses an architecture that can appear a little overwhelming at first. Nella finestra di Visual Studio Code Explorer (Ctrl+Shift+E per visualizzare) verranno visualizzati i file e le cartelle seguenti:

    • bin. Contiene il file eseguibile che avvia l'app. Genera un server (sulla porta 3000 se non viene fornita alcuna alternativa) e configura la gestione degli errori di base.
    • public. Contiene tutti i file a cui si accede pubblicamente, inclusi i file JavaScript, i fogli di stile CSS, i file di tipo di carattere, le immagini e qualsiasi altro asset di cui hanno bisogno quando si connettono al sito Web.
    • routes. Contiene tutti i gestori di route per l'applicazione. Due file, index.js e users.js, vengono generati automaticamente in questa cartella per fungere da esempi di come separare la configurazione della route dell'applicazione.
    • views. Contiene i file usati dal motore di template. Express è configurato per cercare una vista corrispondente quando viene chiamato il metodo render. Il motore di template predefinito è Jade, ma Jade è stato reso obsoleto a favore di Pug, quindi è stato usato il flag --view per cambiare il motore di visualizzazione (template). È possibile visualizzare le opzioni del --view flag e altre usando express --help.
    • app.js. Punto di partenza della tua app. Carica tutto e inizia a gestire le richieste degli utenti. È fondamentalmente la colla che tiene insieme tutte le parti.
    • package.json. Contiene la descrizione del progetto, lo script manager e il manifesto dell'app. Il suo scopo principale è tenere traccia delle dipendenze dell'app e delle rispettive versioni.

  5. È ora necessario installare le dipendenze usate da Express per compilare ed eseguire l'app HelloWorld Express (i pacchetti usati per attività come l'esecuzione del package.json server, come definito nel file). All'interno di VS Code aprire il terminale selezionando Visualizza>terminale (o premere CTRL+', usando il carattere di backtick), assicurarsi di trovarsi ancora nella directory del progetto 'HelloWorld'. Installare le dipendenze del pacchetto Express con:

    npm install

  6. A questo punto è stato configurato il framework per un'app Web a più pagine che ha accesso a un'ampia gamma di API e metodi di utilità HTTP e middleware, semplificando la creazione di un'API affidabile. Avvia l'app Express su un server virtuale immettendo:

    npx cross-env DEBUG=HelloWorld:* npm start

    Suggerimento

    La DEBUG=myapp:* parte del comando precedente indica Node.js che si vuole attivare la registrazione a scopo di debug. Ricordarsi di sostituire "myapp" con il nome dell'app. È possibile trovare il nome della tua app nel file package.json sotto la proprietà "name". Usando npx cross-env imposta la DEBUG variabile di ambiente in qualsiasi terminale, ma è anche possibile impostarla con il terminale in modo specifico. Il npm start comando indica a npm di eseguire gli script nel package.json file.

  7. È ora possibile visualizzare l'app in esecuzione aprendo un Web browser e passando a : localhost:3000

    Screenshot dell'app Express in esecuzione in un browser

  8. Ora che l'app HelloWorld Express è in esecuzione in locale nel browser, provare a apportare una modifica aprendo la cartella "views" nella directory del progetto e selezionando il file "index.pug". Una volta aperto, cambia h1= title in h1= "Hello World!" e seleziona Salva (CTRL+S). Visualizza la modifica aggiornando l'URL localhost:3000 nel browser web.

  9. Per interrompere l'esecuzione dell'app Express, nel terminale immettere: CTRL+C

Provare a usare un modulo Node.js

Node.js include strumenti che consentono di sviluppare app Web lato server, alcune integrate e molte altre disponibili tramite npm. Questi moduli possono essere utili per molte attività:

Strumento Utilizzo
gm, tagliente Manipolazione delle immagini, tra cui modifica, ridimensionamento, compressione e così via, direttamente nel codice JavaScript
PDFKit Generazione pdf
validator.js Convalida delle stringhe
imagemin, UglifyJS2 Minificazione
spritesmith Generazione di fogli sprite
Winston Registrazione
commander.js Creazione di applicazioni da riga di comando

Si userà il modulo del sistema operativo predefinito per ottenere alcune informazioni sul sistema operativo del computer:

  1. Nella tua riga di comando, apri la CLI Node.js. Verrà visualizzato il prompt > che ti informa che stai usando Node.js dopo aver inserito: node

  2. Per identificare il sistema operativo in uso (che dovrebbe restituire una risposta che informa che si è in Windows), immettere: os.platform()

  3. Per controllare l'architettura della CPU, immettere: os.arch()

  4. Per visualizzare le CPU disponibili nel sistema, immettere: os.cpus()

  5. Uscire dall'interfaccia della riga di comando Node.js immettendo .exit o premendo Ctrl+C due volte.

    Suggerimento

    È possibile usare il modulo del sistema operativo Node.js per eseguire operazioni come controllare la piattaforma e restituire una variabile specifica della piattaforma: Win32/.bat per lo sviluppo di Windows, darwin/.sh per Mac/unix, Linux, SunOS e così via (ad esempio, var isWin = process.platform === "win32";).