Skapa HTTP-webbserver i Node.js med Code Exempelvis

Ocuco-landskapet node.js Ramverket används mestadels för att skapa serverbaserade applikationer. Det kan enkelt användas för att bygga webbservrar som levererar innehåll till användare.

Flera moduler hanterar serverrelaterade förfrågningar, den inbyggda http modulens främsta bland dem. Vi kommer att titta på hur man skapar en grundläggande webbserverapplikation med Node.js, och sedan hur man begär data från en annan webbplats.

Nod som en webbserver som använder HTTP

Låt oss titta på ett exempel på hur man skapar och kör en första Node.js-applikation.

Applikationen skapar en enkel servermodul som lyssnar på port 7000. När en begäran görs via webbläsaren på den porten skickar servern en Hej Världen svar till klienten.

Code Förklaring

1. Ocuco-landskapet require funktionen läser en JavaScript filen, kör den och returnerar dess exports-objekt. Här laddar den http modulen så att dess funktionalitet är tillgänglig i applikationen.
2. En serverapplikation skapas från en enkel funktion. Funktionen körs varje gång en begäran når servern.
3. När en begäran tas emot skickas svaret med statusen 200Detta är standardstatuskoden i en HTTP-header för ett lyckat svar.
4. Själva svarstexten är strängen Hej Världen.
5. server.listen gör att applikationen lyssnar efter klientförfrågningar på port 7000. Alla tillgängliga portar kan användas.

Om kommandot körs korrekt visas följande utdata i webbläsaren.

Produktion

Från utgången:

• Surfar till den lokala värden URL på port 7000 visas strängen Hej Världen på sidan.
• Eftersom koden anger port 7000 syns utdata bara när man bläddrar till den porten.

Här är koden för referens:

var http = require('http');

var server = http.createServer(function(request, response) {
    response.writeHead(200, { "Content-Type": "text/plain" });
    response.end("Hello World\n");
});

server.listen(7000);

Hantera GET-förfrågningar i Node.js

Att göra en GET-förfrågan för att hämta data från en annan webbplats är enkelt i Node.js. Historiskt sett behövde detta request modul, installerad från kommandoraden:

npm install request

Det kommandot ber Node-pakethanteraren att ladda ner den nödvändiga modulen och installera den. När installationen lyckas visar kommandoraden den installerade modulens namn och version i formuläret <name>@<version>.

På ögonblicksbilden ovan, request modulen och dess versionsnummer laddades ner och installerades.

Code Förklaring

1. Ocuco-landskapet request Modulen som installerades i föregående steg tillhandahåller de funktioner som behövs för att göra GET-förfrågningar till webbplatser.
2. En GET-förfrågan görs till en webbplats, och en återanropning körs när ett svar anländer. Återanropet tar emot tre parametrar:
   1. Fel — registrerar eventuella fel som uppstod när begäran gjordes.
   2. Svar — bär HTTP-rubrikerna som returneras med svaret.
   3. Kaross — innehåller hela innehållet i svaret.
3. Innehållet som mottagits i body parametern skrivs till konsolen.

Här är koden för referens:

var request = require("request");

request("https://example.com", function(error, response, body) {
    // Always check the error parameter before using the body
    if (error) {
        console.error("Request failed:", error.message);
        return;
    }
    console.log(body);
});

⚠️ Meddelande om utfasning: d request modulen var helt avvecklad i februari 2020 och får inga ytterligare uppdateringar. Den installeras och körs fortfarande, så exemplet ovan förblir giltigt för befintliga projekt, men npm install request skriver nu ut en varning om utfasning. Ny kod bör använda den inbyggda fetch funktionen som visas i nästa avsnitt.

Hur man gör HTTP-förfrågningar med Native Fetch i Node.js

Noden har inkluderat en global fetch funktion sedan version 18, vilket matchar API:et som webbläsare redan tillhandahåller. Ingen paketinstallation krävs, och funktionen returnerar ett löfte, så den fungerar direkt med async/await.

// No require and no npm install needed on Node 18 or later

async function getData() {
    try {
        const response = await fetch("https://example.com");

        // fetch does NOT reject on 404 or 500 — check ok yourself
        if (!response.ok) {
            throw new Error("HTTP status " + response.status);
        }

        const body = await response.text();
        console.log(body);

    } catch (err) {
        // Network failures and the throw above both land here
        console.error("Request failed:", err.message);
    }
}

getData();

Tre skillnader från återuppringningsstilen är värda att notera. För det första, fetch avvisar endast vid ett fel på nätverksnivå; en HTTP 404 eller 500 löses fortfarande utan problem, vilket är anledningen till att response.ok kontrollen finns och varför det vanligaste misstaget vid övergång från att utelämna den requestFör det andra levereras inte kroppen med svaret – den måste läsas explicit med response.text() för vanlig text eller response.json() för JSON, och var och en av dessa returnerar ett eget löfte. För det tredje, eftersom hela anropet är löftesbaserat, en enda try/catch täcker både begäran och brödtexten, och ersätter helt och hållet callback-parametern error-first.

För skript som måste köras på Node 16 eller tidigare, installera node-fetch or axios istället, eftersom båda exponerar ett jämförbart löftesbaserat gränssnitt och bara kräver en ändring av importraden när körningen har uppgraderats.

begäran vs hämta vs axios: Vilken ska man använda

Tre HTTP-klienter förekommer i det mesta Node-materialet, och endast en av dem är en rimlig standard för nytt arbete. De skiljer sig åt i underhållsstatus, i huruvida ett beroende alls behövs och i hur var och en signalerar en felstatus, så tabellen nedan placerar dem sida vid sida.

Använda fetch för nya projekt på en aktuell Node-version, eftersom den inte lägger till något beroende och matchar det webbläsar-API som utvecklare redan känner till. Välj axios när automatisk JSON-hantering, förfrågningsavlyssnande åtgärder eller avslag vid felstatus skulle spara riktig kod. Behåll request endast inuti äldre applikationer som redan är beroende av det, och planerar att ersätta det.

Vanliga Node.js-serverfel och hur man åtgärdar dem

De flesta fel när man startar en första nodserver kommer från portar, sökvägar eller ett saknat svar snarare än från själva serverkoden.

• EADDRINUSE: en annan process har redan porten. Kör netstat -ano | findstr :7000 on Windows, eller lsof -i :7000 on macOS och Linux, stoppa sedan den processen eller välj en annan port.
• EACCES på låg hamn: Portar under 1024 behöver utökade rättigheter. Använd en port över 1024 under utveckling, till exempel 3000 eller 7000.
• Webbläsaren hänger sig och laddas aldrig: handläggaren ringde aldrig response.end()Anslutningen förblir öppen tills den når tidsgränsen, så varje väg genom hanteraren måste avsluta svaret.
• Kan inte hitta modulen 'http': Filnamnet stavades fel, eller så körs skriptet i en webbläsare istället för Node. Kärnmoduler behöver ingen installation.
• Ändringar visas inte: Noden laddar filen en gång vid uppstart. Starta om processen efter varje redigering, eller kör den under en bevakare som t.ex. node --watch server.js.

Vanliga frågor