Opprett HTTP-webserver i Node.js med Code Eksempel

Ocuco node.js Rammeverket brukes hovedsakelig til å lage serverbaserte applikasjoner. Det kan enkelt brukes til å bygge webservere som leverer innhold til brukere.

Flere moduler håndterer serverrelaterte forespørsler, den innebygde http modulens fremste blant dem. Vi skal se på hvordan man lager en grunnleggende webserverapplikasjon ved hjelp av Node.js, og deretter hvordan man ber om data fra et annet nettsted.

Node som en webserver som bruker HTTP

La oss se på et eksempel på hvordan du oppretter og kjører et første Node.js-program.

Applikasjonen oppretter en enkel servermodul som lytter på port 7000. Når en forespørsel sendes gjennom nettleseren på den porten, sender serveren en Hallo verden svar til klienten.

Code Forklaring

1. Ocuco require funksjonen leser en JavaScript filen, kjører den og returnerer exports-objektet. Her laster den inn http modulen slik at funksjonaliteten er tilgjengelig i applikasjonen.
2. En serverapplikasjon opprettes fra en enkel funksjon. Funksjonen kjører hver gang en forespørsel når serveren.
3. Når en forespørsel mottas, sendes svaret med statusen 200Dette er standard statuskode i en HTTP-header for et vellykket svar.
4. Selve svarsdelen er strengen Hallo verden.
5. server.listen får applikasjonen til å lytte etter klientforespørsler på port 7000. Enhver tilgjengelig port kan brukes.

Hvis kommandoen kjøres uten problemer, vises følgende utdata i nettleseren.

Produksjon

Fra utdataene:

• Surfer til den lokale verten URL på port 7000 vises strengen Hallo verden på siden.
• Fordi koden spesifiserer port 7000, er utdataene bare synlige når man blar til den porten.

Her er koden for referanse:

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 av GET-forespørsler i Node.js

Det er enkelt å sende en GET-forespørsel for å hente data fra et annet nettsted i Node.js. Historisk sett krevde dette request modul, installert fra kommandolinjen:

npm install request

Den kommandoen ber Node-pakkebehandleren om å laste ned den nødvendige modulen og installere den. Når installasjonen er fullført, viser kommandolinjen navnet på den installerte modulen og versjonen i formen <name>@<version>.

I øyeblikksbildet ovenfor, request modulen og versjonsnummeret ble lastet ned og installert.

Code Forklaring

1. Ocuco request Modulen som ble installert i forrige trinn, inneholder funksjonene som trengs for å sende GET-forespørsler til nettsteder.
2. En GET-forespørsel sendes til et nettsted, og et tilbakekalling kjøres når et svar kommer inn. Tilbakekallingen mottar tre parametere:
   1. Feil — registrerer eventuelle feil som oppsto under forespørselen.
   2. Respons — bærer HTTP-overskriftene som returneres med svaret.
   3. Body — inneholder hele innholdet i svaret.
3. Innholdet som er mottatt i body Parameteren skrives til konsollen.

Her er koden for referanse:

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

⚠️ Varsel om avskrivning: de request modulen var fullstendig avviklet i februar 2020 og mottar ingen ytterligere oppdateringer. Den installeres og kjører fortsatt, så eksemplet ovenfor er fortsatt gyldig for eksisterende prosjekter, men npm install request skriver nå ut en advarsel om avskrivning. Ny kode bør bruke den innebygde fetch funksjonen som vises i neste avsnitt.

Slik lager du HTTP-forespørsler med Native Fetch i Node.js

Node har inkludert en global fetch funksjon siden versjon 18, som samsvarer med API-et nettlesere allerede tilbyr. Ingen pakkeinstallasjon er nødvendig, og funksjonen returnerer et løfte, slik at 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 forskjeller fra tilbakeringingsstilen er verdt å merke seg. For det første, fetch avviser bare ved feil på nettverksnivå; en HTTP 404 eller 500 løses fortsatt uten problemer, og det er derfor response.ok sjekk finnes, og hvorfor det å utelate den er den vanligste feilen når man flytter fra requestFor det andre leveres ikke kroppen med responsen – den må leses eksplisitt med response.text() for ren tekst eller response.json() for JSON, og hver av disse returnerer et eget løfte. For det tredje, fordi hele kallet er løftebasert, returnerer en enkelt try/catch dekker både forespørselen og brødteksten, og erstatter error-first callback-parameteren fullstendig.

For skript som må kjøre på Node 16 eller tidligere, installer node-fetch or axios i stedet, siden begge eksponerer et sammenlignbart løftebasert grensesnitt og bare krever en endring av importlinjen når kjøretiden er oppgradert.

forespørsel vs. hent vs. axios: Hvilken skal brukes

Tre HTTP-klienter dukker opp på tvers av mesteparten av Node-materialet, og bare én av dem er en fornuftig standard for nytt arbeid. De varierer i vedlikeholdsstatus, om en avhengighet i det hele tatt er nødvendig, og hvordan hver enkelt signaliserer en feilstatus, så tabellen nedenfor setter dem side om side.

Bruk fetch for nye prosjekter på en gjeldende Node-versjon, siden den ikke legger til noen avhengighet og samsvarer med nettleser-API-et som utviklere allerede kjenner til. Velg axios når automatisk JSON-håndtering, forespørselsavskjærere eller avvisning ved feilstatuser ville lagret ekte kode. Behold request bare i eldre applikasjoner som allerede er avhengige av den, og som planlegger å erstatte den.

Vanlige Node.js-serverfeil og hvordan du fikser dem

De fleste feilene når man starter en første Node-server kommer fra porter, stier eller manglende svar, snarere enn fra selve serverkoden.

• BRUKSANVISNING: en annen prosess holder allerede porten. Kjør netstat -ano | findstr :7000 on Windowseller lsof -i :7000 on macOS og Linux, og stopp deretter den prosessen eller velg en annen port.
• EACCES på lav havn: Porter under 1024 trenger forhøyede rettigheter. Bruk en port over 1024 under utvikling, for eksempel 3000 eller 7000.
• Nettleseren henger seg og lastes aldri: behandleren ringte aldri response.end()Forbindelsen forblir åpen til den får tidsavbrudd, så hver bane gjennom behandleren må avslutte svaret.
• Finner ikke modulen 'http': Filnavnet var feilstavet, eller skriptet kjører i en nettleser i stedet for Node. Kjernemoduler trenger ingen installasjon.
• Endringer vises ikke: Noden laster inn filen én gang ved oppstart. Start prosessen på nytt etter hver redigering, eller kjør den under en overvåker som f.eks. node --watch server.js.

Spørsmål og svar