Adicionando Express a um projeto em Node.js

Neste artigo daremos continuidade a publicação anterior, em que explicamos como iniciar uma aplicação em Node.js. Se você não viu o artigo e não sabe como começar um projeto em Node.js, dá uma olhadinha lá no post!

O Express é um framework Node.js para a construção de aplicações web e APIs. Ele acrescenta funcionalidades ao Node.js e encapsula outras do próprio Node.js, disponibilizando-as de uma forma mais simples. Pode-se dizer que o Express é um dos frameworks Node.js mais populares, sendo utilizado por grandes empresas, tais como Uber, IBM, Accenture e Fox Sports.

E como adicionar o Express a um projeto Node.js?

Para adicionar o Express a um projeto Node.js, basta executar o seguinte comando no terminal, na raíz do projeto:

npm install express --save

Se você abrir o arquivo “package.json”, você verá que o Express agora aparece listado como dependência do projeto:

{
  "name": "meuapp",
  "version": "1.0.0",
  "description": "Meu primeiro app em Node.js",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "Mais Um Blog",
  "license": "ISC",
  "dependencies": {
    "express": "^4.17.1"
  }
}

Agora que o Express já foi adicionado ao seu projeto, vamos utilizá-lo!

Lembra do arquivo “index.js” que criamos no artigo anterior? Neste arquivo a gente criava um servidor web que sempre retornava a mensagem “Hello World” quando era requisitado. Agora, vamos fazer o mesmo, porém usando o Express.

O arquivo “index.js” original apresentava este conteúdo:

//importando o modulo http do node
const http = require('http');

//endereço da app
const hostname = '127.0.0.1';
//porta em que a app será executada
const port = 3000;

//criando o nosso servidor web com resposta padrão
const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello World');
});

//executando nosso servidor web
server.listen(port, hostname, () => {
  console.log(`O servidor está sendo executado em http://${hostname}:${port}/`);
});

Vamos substituir todo o conteúdo do arquivo “index.js” pelo conteúdo a seguir:

//importando o express
const express = require('express')

//cria uma aplicação express
const app = express()

//porta em que a app será executada
const port = 3000

//define que, qualquer requisição HTTP GET que chegue na rota "/",
//será respondida com "Hello World"
app.get('/', (req, res) => {
  res.send('Hello World!')
})

//executando a aplicação na porta definida
app.listen(port, () => {
  console.log(`O servidor está sendo executado em http://localhost:${port}`)
})

Como você pode ver, a ideia nos dois arquivos é a mesma, inclusive têm funções semelhantes, como a “listen()”. De acordo com a documentação do Express, o método “listen()” dele é idêntico ao método do Node.js. Porém, na minha opinião, ao utilizar o Express o código fica mais limpo e mais legível.

Para iniciar a aplicação e ver o resultado, basta digitar o comando a seguir no terminal, na raíz do seu projeto.

node index.js

É importante lembrar que este comando deve ser executado no diretório raíz porque é onde está o arquivo “index.js”.

Se a aplicação foi iniciada com sucesso, você verá a seguinte mensagem no seu terminal:

Prontinho! Agora acesse http://localhost:3000 no seu navegador para ver a mágica acontecer!

Nos próximos artigos veremos como adicionar outras rotas ao nosso projeto.

Até a próxima!