Opret HTTP-webserver i Node.js med Code Eksempel

node.js Framework bruges mest til at oprette serverbaserede applikationer. Det kan nemt bruges til at bygge webservere, der leverer indhold til brugerne.

Flere moduler håndterer serverrelaterede anmodninger, den indbyggede http modul det vigtigste blandt dem. Vi vil se på, hvordan man opretter en grundlæggende webserverapplikation ved hjælp af Node.js, og derefter på, hvordan man anmoder om data fra et andet websted.

Node som en webserver ved hjælp af HTTP

Lad os se på et eksempel på, hvordan man opretter og kører en første Node.js-applikation.

Applikationen opretter et simpelt servermodul, der lytter på port 7000. Når en anmodning foretages via browseren på den port, sender serveren en Hej Verden svar til klienten.

Code Forklaring

1. require funktionen læser en JavaScript filen, udfører den og returnerer dens exports-objekt. Her indlæser den http modulet, så dets funktionalitet er tilgængelig i applikationen.
2. En serverapplikation oprettes ud fra en simpel funktion. Funktionen kører hver gang en anmodning når serveren.
3. Når en anmodning modtages, sendes svaret med status som 200Dette er standardstatuskoden i en HTTP-header for et vellykket svar.
4. Selve svarkroppen er strengen Hej Verden.
5. server.listen får applikationen til at lytte efter klientanmodninger på port 7000. Enhver tilgængelig port kan bruges.

Hvis kommandoen kører korrekt, vises følgende output i browseren.

Produktion

Fra outputtet:

• Browsing til den lokale vært URL på port 7000 vises strengen Hej Verden på siden.
• Da koden angiver port 7000, er outputtet kun synligt, når der browses til den port.

Her er koden til reference:

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);

Håndtering af GET-anmodninger i Node.js

Det er ligetil at lave en GET-anmodning for at hente data fra et andet websted i Node.js. Historisk set krævede dette request modul, installeret fra kommandolinjen:

npm install request

Den kommando beder Node-pakkehåndteringen om at downloade det nødvendige modul og installere det. Når installationen er fuldført, viser kommandolinjen det installerede modulnavn og version i formen <name>@<version>.

På ovenstående øjebliksbillede, request modulet og dets versionsnummer blev downloadet og installeret.

Code Forklaring

1. request Modulet, der blev installeret i det forrige trin, leverer de funktioner, der er nødvendige for at foretage GET-anmodninger til websteder.
2. En GET-anmodning sendes til et websted, og et callback kører, når et svar modtages. Callbacket modtager tre parametre:
   1. Fejl — registrerer eventuelle fejl, der opstår under anmodningen.
   2. Respons — bærer de HTTP-headere, der returneres med svaret.
   3. Fylde — indeholder hele indholdet af svaret.
3. Indholdet modtaget i body Parameteren skrives til konsollen.

Her er koden til reference:

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);
});

⚠️ Meddelelse om udfasning: og request modulet var fuldt udfaset i februar 2020 og modtager ingen yderligere opdateringer. Den installeres og kører stadig, så ovenstående eksempel forbliver gyldigt for eksisterende projekter, men npm install request udskriver nu en advarsel om udfasning. Ny kode skal bruge den indbyggede fetch funktionen vist i næste afsnit.

Sådan laver du HTTP-anmodninger med Native Fetch i Node.js

Node har inkluderet en global fetch funktion siden version 18, der matcher den API, som browsere allerede tilbyder. Ingen pakkeinstallation er nødvendig, og funktionen returnerer et løfte, så den fungerer direkte 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 forskelle fra callback-stilen er værd at bemærke. For det første, fetch afviser kun ved en netværksfejl; en HTTP 404 eller 500 løses stadig korrekt, hvilket er grunden til response.ok der findes en kontrol, og hvorfor det er den mest almindelige fejl at udelade den, når man flytter fra requestFor det andet leveres kroppen ikke med svaret – det skal læses eksplicit med response.text() til almindelig tekst eller response.json() for JSON, og hver af disse returnerer sit eget løfte. For det tredje, fordi hele kaldet er løftebaseret, en enkelt try/catch dækker både anmodningen og brødteksten og erstatter fuldstændigt callback-parameteren error-first.

For scripts, der skal køre på Node 16 eller tidligere, skal du installere node-fetch or axios i stedet, da begge eksponere en sammenlignelig løftebaseret grænseflade og kun kræver en ændring af importlinjen, når runtime-programmet er opgraderet.

anmodning vs. hent vs. axios: Hvilken skal bruges

Tre HTTP-klienter optræder på tværs af det meste Node-materiale, og kun én af dem er en fornuftig standard for nyt arbejde. De adskiller sig i vedligeholdelsesstatus, i om en afhængighed overhovedet er nødvendig, og i hvordan hver enkelt signalerer en fejlstatus, så tabellen nedenfor viser dem side om side.

Brug fetch for nye projekter på en aktuel Node-version, da den ikke tilføjer nogen afhængighed og matcher den browser-API, som udviklere allerede kender. Vælg axios når automatisk JSON-håndtering, anmodningsinterceptorer eller afvisning ved fejlstatusser ville gemme den rigtige kode. Behold request kun i ældre applikationer, der allerede er afhængige af det, og som planlægger at erstatte det.

Almindelige Node.js-serverfejl og hvordan man retter dem

De fleste fejl ved opstart af en første Node-server kommer fra porte, stier eller et manglende svar snarere end fra selve serverkoden.

• EADDRINUSE: en anden proces holder allerede porten. Kør netstat -ano | findstr :7000 on Windows eller lsof -i :7000 on macOS og Linux, og stop derefter processen eller vælg en anden port.
• EACCES på en lav havn: Porte under 1024 kræver forhøjede rettigheder. Brug en port over 1024 under udvikling, f.eks. 3000 eller 7000.
• Browseren hænger og indlæses aldrig: behandleren ringede aldrig response.end()Forbindelsen forbliver åben, indtil den får timeout, så hver sti gennem handleren skal afslutte svaret.
• Kan ikke finde modulet 'http': Filnavnet var stavet forkert, eller scriptet kører i en browser i stedet for Node. Core-moduler kræver ingen installation.
• Ændringer vises ikke: Noden indlæser filen én gang ved opstart. Genstart processen efter hver redigering, eller kør den under en overvåger som f.eks. node --watch server.js.

Ofte Stillede Spørgsmål