Självstudie: Node.js för nybörjare

Om du är helt ny på att använda Node.jshjälper den här guiden dig att komma igång med några grunderna.

Förutsättningar

Prova NodeJS med Visual Studio Code

Om du inte har installerat Visual Studio Code än går du tillbaka till avsnittet för förhandskrav ovan och följer installationsstegen som är länkade för Windows eller WSL.

  1. Öppna kommandoraden och skapa en ny katalog: mkdir HelloNodeoch ange sedan katalogen: cd HelloNode

  2. Öppna katalogen i VS Code med kommandot : code .

  3. Skapa en fil med namnet "app.js"

  4. Lägg till en enkel sträng "Hello World" i en variabel med namnet msgoch skicka sedan innehållet i strängen till konsolen genom att ange detta i filen "app.js" :

    var msg = 'Hello World';
    console.log(msg);
    
  5. Så här kör du filen "app.js" med Node.js. Öppna terminalen direkt i VS Code genom att välja Visa>terminal (eller välj Ctrl+' med hjälp av backtick-tecknet). Om du behöver ändra standardterminalen väljer du den nedrullningsbara menyn och väljer Välj standardgränssnitt.

  6. I terminalen skriver du: node app.js. Du bör se resultatet: "Hej Världen".

Anmärkning

Observera att när du skriver console i filen "app.js" visar VS Code relaterade alternativ för objektet console, som du kan välja från med hjälp av IntelliSense. Prova att experimentera med Intellisense med andra JavaScript-objekt.

Skapa din första NodeJS-webbapp med Express

Express är ett minimalt, flexibelt och effektiviserat Node.js ramverk som gör det enklare att utveckla en webbapp som kan hantera flera typer av begäranden, till exempel GET, PUT, POST och DELETE. Express levereras med en programgenerator som automatiskt skapar en filarkitektur för din app.

Så här skapar du ett projekt med Express.js:

  1. Öppna kommandoraden (Kommandotolken, PowerShell eller vad du vill).

  2. Skapa en ny projektmapp: mkdir ExpressProjects och ange den katalogen: cd ExpressProjects

  3. Använd Express för att skapa en HelloWorld-projektmall: npx express-generator HelloWorld --view=pug

    Anmärkning

    Vi använder npx kommandot här för att köra Express.js Node-paketet utan att installera det (eller genom att tillfälligt installera det beroende på hur du vill tänka på det). Om du försöker använda express kommandot eller kontrollera versionen av Express installerat med: express --versionfår du ett svar om att Express inte kan hittas. Om du vill installera Express globalt för att använda om och om igen använder du: npm install -g express-generator. Du kan visa en lista över de paket som har installerats av npm med hjälp av npm list. De kommer att listas efter djupet (antalet kapslade kataloger). Paket som du har installerat finns på djup 0. Paketets beroenden kommer att vara på djup 1, ytterligare beroenden på djup 2 och så vidare. Mer information finns i Skillnaden mellan npx och npm? på StackOverflow.

  4. Granska de filer och mappar som Express inkluderade genom att öppna projektet i VS Code med: code .

    Filerna som Express genererar skapar en webbapp som använder en arkitektur som kan verka lite överväldigande till en början. I VS Code Explorer-fönstret (Ctrl+Skift+E att visa) ser du att följande filer och mappar har genererats:

    • bin. Innehåller den körbara fil som startar appen. Den startar en server (på port 3000 om inget alternativ anges) och konfigurerar grundläggande felhantering.
    • public. Innehåller alla offentligt använda filer, inklusive JavaScript-filer, CSS-formatmallar, teckensnittsfiler, bilder och andra tillgångar som personer behöver när de ansluter till din webbplats.
    • routes. Innehåller alla routningshanterare för programmet. Två filer och index.jsusers.js, genereras automatiskt i den här mappen för att fungera som exempel på hur du separerar programmets routningskonfiguration.
    • views. Innehåller de filer som används av mallmotorn. Express har konfigurerats för att söka efter en matchande vy när återgivningsmetoden anropas. Standardmallmotorn är Jade, men Jade har blivit inaktuell till förmån för Pug, så vi använde --view flaggan för att ändra vymotorn (mallen). Du kan se alternativen för flaggan --view och andra med hjälp av express --help.
    • app.js. Startpunkten för din app. Den läser in allt och börjar hantera användarbegäranden. Det är i princip limmet som håller ihop alla delar.
    • package.json. Innehåller projektbeskrivningen, skripthanteraren och appmanifestet. Dess huvudsakliga syfte är att spåra appens beroenden och deras respektive versioner.
  5. Nu måste du installera de beroenden som Express använder för att kunna skapa och köra din HelloWorld Express-app (paketen som används för uppgifter som att köra servern enligt definitionen i package.json filen). Öppna terminalen i VS Code genom att välja Visa>terminal (eller välj Ctrl+ med hjälp av backtick-tecknet) och se till att du fortfarande är i projektkatalogen "HelloWorld". Installera Express-paketberoenden med:

    npm install
    
  6. Nu har du ramverket konfigurerat för en webbapp med flera sidor som har åtkomst till en mängd olika API:er och HTTP-verktygsmetoder och mellanprogram, vilket gör det enklare att skapa ett robust API. Starta Express-appen på en virtuell server genom att ange:

    npx cross-env DEBUG=HelloWorld:* npm start
    

    Tips/Råd

    Den DEBUG=myapp:* del av kommandot ovan innebär att du berättar för Node.js att du vill aktivera loggning i felsökningssyfte. Kom ihåg att ersätta "myapp" med ditt appnamn. Du hittar ditt appnamn i package.json filen under egenskapen "name". Om du använder npx cross-env anges DEBUG miljövariabeln i valfri terminal, men du kan också ange den på ett terminalspecifikt sätt. Kommandot npm start uppmanar npm att köra skripten i package.json filen.

  7. Nu kan du visa appen som körs genom att öppna en webbläsare och gå till: localhost:3000

    Skärmbild av Express-appen som körs i en webbläsare

  8. Nu när Din HelloWorld Express-app körs lokalt i webbläsaren kan du försöka göra en ändring genom att öppna mappen vyer i projektkatalogen och välja filen "index.pug". När den är öppen, ändra h1= title till h1= "Hello World!" och välj Spara (Ctrl+S). Visa ändringen genom att uppdatera url :en localhost:3000 i webbläsaren.

  9. Om du vill sluta köra Express-appen i terminalen anger du: Ctrl+C

Prova att använda en Node.js-modul

Node.js har verktyg som hjälper dig att utveckla webbappar på serversidan, vissa inbyggda och många fler tillgängliga via npm. De här modulerna kan hjälpa dig med många uppgifter:

Verktyg Används för
gm, skarp Bildmanipulering, inklusive redigering, storleksändring, komprimering och så vidare, direkt i JavaScript-koden
PDFKit PDF-generering
validator.js Strängverifiering
imagemin, UglifyJS2 Minifiering
spritesmith Generering av sprite-ark
Winston Loggning / Skogsavverkning
commander.js Skapa kommandoradsprogram

Vi använder den inbyggda OS-modulen för att få lite information om datorns operativsystem:

  1. Öppna Node.js CLI på kommandoraden. Du ser >-frågan som meddelar dig att du använder Node.js efter att du har angett: node

  2. Om du vill identifiera det operativsystem som du använder för närvarande (vilket bör returnera ett svar som låter dig veta att du är i Windows) anger du: os.platform()

  3. Om du vill kontrollera cpu-arkitekturen anger du: os.arch()

  4. Om du vill visa de processorer som är tillgängliga i systemet anger du: os.cpus()

  5. Lämna Node.js CLI genom att ange .exit eller genom att välja Ctrl +C två gånger.

    Tips/Råd

    Du kan använda modulen Node.js OS för att göra saker som att kontrollera plattformen och returnera en plattformsspecifik variabel: Win32/.bat för Windows-utveckling, darwin/.sh för Mac/unix, Linux, SunOS och så vidare (till exempel var isWin = process.platform === "win32";).