Crie um servidor web HTTP em Node.js com Code Exemplo

O Node.js O framework é usado principalmente para criar aplicações baseadas em servidor. Ele pode ser facilmente utilizado para construir servidores web que fornecem conteúdo aos usuários.

Vários módulos lidam com solicitações relacionadas ao servidor, o módulo integrado http O módulo principal entre eles. Veremos como criar uma aplicação básica de servidor web usando Node.js e, em seguida, como solicitar dados de outro site.

Nó como servidor web usando HTTP

Vejamos um exemplo de como criar e executar uma primeira aplicação Node.js.

O aplicativo cria um módulo de servidor simples que escuta na porta 7000. Quando uma requisição é feita através do navegador nessa porta, o servidor envia um Olá Mundo resposta ao cliente.

Code Explicação

1. O require A função lê um JavaScript arquivo, executa-o e retorna seu objeto de exportações. Aqui ele carrega o http módulo para que sua funcionalidade esteja disponível no aplicativo.
2. Uma aplicação de servidor é criada a partir de uma função simples. Essa função é executada sempre que uma requisição chega ao servidor.
3. Quando uma solicitação é recebida, a resposta é enviada com o status de 200Este é o código de status padrão em um cabeçalho HTTP para uma resposta bem-sucedida.
4. O próprio corpo da resposta é a string Olá Mundo.
5. server.listen Faz com que a aplicação fique à escuta de pedidos do cliente na porta 7000. Qualquer porta disponível pode ser utilizada.

Se o comando for executado com sucesso, a seguinte saída aparecerá no navegador.

saída

A partir da saída:

• Navegando até o localhost URL na porta 7000 exibe a string Olá Mundo na página.
• Como o código especifica a porta 7000, a saída só fica visível ao acessar essa porta.

Segue o código para referência:

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

Tratamento de solicitações GET em Node.js

Fazer uma requisição GET para recuperar dados de outro site é simples em Node.js. Historicamente, isso exigia... request Módulo instalado a partir da linha de comando:

npm install request

Esse comando instrui o gerenciador de pacotes do Node a baixar e instalar o módulo necessário. Quando a instalação for concluída com sucesso, a linha de comando exibirá o nome e a versão do módulo instalado no formato <name>@<version>.

Na imagem acima, o request O módulo e seu número de versão foram baixados e instalados.

Code Explicação

1. O request O módulo instalado na etapa anterior fornece as funções necessárias para fazer solicitações GET a sites.
2. Uma requisição GET é feita a um site, e uma função de retorno (callback) é executada assim que uma resposta é recebida. A função de retorno recebe três parâmetros:
   1. erro — registra qualquer erro ocorrido durante a realização da solicitação.
   2. Automatizadas — carrega os cabeçalhos HTTP retornados com a resposta.
   3. Corpo — contém todo o conteúdo da resposta.
3. O conteúdo recebido no body O parâmetro é escrito no console.

Segue o código para referência:

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

⚠️ Aviso de descontinuação: da request módulo era totalmente descontinuado em fevereiro de 2020. e não recebe mais atualizações. Ele ainda instala e executa, então o exemplo acima continua válido para projetos existentes, mas npm install request Agora imprime um aviso de obsolescência. O novo código deve usar a função integrada. fetch função mostrada na próxima seção.

Como fazer requisições HTTP com o fetch nativo no Node.js

O Node incluiu um global fetch função disponível desde a versão 18, compatível com a API já fornecida pelos navegadores. Não requer instalação de pacotes e retorna uma promessa, funcionando diretamente com 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();

Três diferenças em relação ao estilo de retorno de chamada merecem destaque. Primeiro, fetch rejeita apenas em caso de falha no nível da rede; um erro HTTP 404 ou 500 ainda é resolvido com sucesso, razão pela qual o response.ok A verificação existe e explica por que omiti-la é o erro mais comum ao migrar de requestEm segundo lugar, o corpo da mensagem não é entregue com a resposta — ele deve ser lido explicitamente com... response.text() para texto simples ou response.json() para JSON, e cada um deles retorna uma promessa própria. Terceiro, como toda a chamada é baseada em promessas, uma única try/catch Abrange tanto a requisição quanto a leitura do corpo da mensagem, substituindo completamente o parâmetro de retorno de chamada que prioriza erros.

Para scripts que precisam ser executados no Node 16 ou anterior, instale node-fetch or axios Em vez disso, já que ambos expõem uma interface comparável baseada em promessas e exigem apenas uma alteração na linha de importação após a atualização do ambiente de execução.

request vs fetch vs axios: qual usar?

Na maioria dos materiais sobre Node.js, três clientes HTTP aparecem, mas apenas um deles é uma opção padrão sensata para novos projetos. Eles diferem em relação ao status de manutenção, à necessidade de dependências e à forma como cada um sinaliza um erro. Portanto, a tabela abaixo os compara lado a lado.

Uso fetch Para novos projetos em uma versão atual do Node, pois não adiciona dependências e é compatível com a API do navegador que os desenvolvedores já conhecem. Escolha axios Quando o tratamento automático de JSON, interceptadores de requisição ou rejeição em casos de erro economizariam código real. Mantenha. request Somente em aplicações legadas que já dependem dele e planejam substituí-lo.

Erros comuns do servidor Node.js e como corrigi-los

A maioria das falhas ao iniciar um servidor Node pela primeira vez decorre de portas, caminhos ou falta de resposta, e não do próprio código do servidor.

• USO DE ÁGUA: Outro processo já está utilizando a porta. Execute. netstat -ano | findstr :7000 on Windows, ou lsof -i :7000 on macOS e no Linux, em seguida, interrompa esse processo ou escolha uma porta diferente.
• EACCES em uma porta baixa: Portas abaixo de 1024 exigem privilégios elevados. Utilize uma porta acima de 1024 durante o desenvolvimento, como 3000 ou 7000.
• O navegador trava e não carrega. O atendente nunca ligou. response.end()A conexão permanece aberta até que o tempo limite seja atingido, portanto, cada caminho através do manipulador deve finalizar a resposta.
• Não foi possível encontrar o módulo 'http': O nome do arquivo estava escrito incorretamente ou o script está sendo executado em um navegador em vez do Node.js. Os módulos principais não precisam de instalação.
• As alterações não aparecem: O Node carrega o arquivo uma única vez na inicialização. Reinicie o processo após cada edição ou execute-o sob um observador, como por exemplo... node --watch server.js.

Perguntas Frequentes