Aprenda a iniciar um servidor Node.js pelo terminal: verifique o ambiente, entre na pasta do projeto, execute node index.js e teste no navegador.
Em resumo:
Quem está começando a testar aplicações Node.js localmente costuma travar num ponto simples: o projeto existe, os arquivos estão na pasta certa, mas falta saber qual comando digitar no terminal para colocar o servidor no ar.
Este guia resolve exatamente essa etapa, sem exigir conhecimento avançado de programação.
Antes de tentar rodar qualquer projeto, é recomendável confirmar que o ambiente está pronto. No terminal, os comandos node -v e npm -v mostram, respectivamente, a versão instalada do Node.js e a versão do npm, o gerenciador de pacotes que acompanha a instalação.
Se esses comandos retornarem uma mensagem de erro em vez de um número de versão, o Node.js provavelmente não está instalado no computador.
Nesse caso, o download deve ser feito pelo site oficial do projeto, e não por pacotes de terceiros ou tutoriais que prometam atalhos.
Todo projeto Node.js organizado costuma ter um arquivo package.json, criado normalmente com o comando npm init -y.
Esse arquivo descreve o projeto: nome, versão, dependências instaladas e, quando configurado, os scripts de execução.
As bibliotecas instaladas via npm ficam guardadas na pasta node_modules, e é o package.json que registra quais delas o projeto usa.
O arquivo responsável por iniciar o servidor, porém, não tem nome fixo: pode ser index.js, server.js ou app.js, dependendo de como quem criou o projeto organizou os arquivos.
Antes de rodar qualquer comando, é importante abrir a pasta do projeto e identificar visualmente esse arquivo.
Com o arquivo de entrada identificado, o próximo passo é abrir o terminal e navegar até a pasta do projeto usando o comando cd, seguido do caminho da pasta. Executar o comando de início em uma pasta errada é uma causa comum de erro nessa etapa.
Dentro da pasta correta, o servidor é iniciado com o comando node seguido do nome do arquivo de entrada, como em node index.js.
Se o arquivo do projeto tiver outro nome, o comando muda na mesma proporção: node server.js ou node app.js, por exemplo. O terminal deve permanecer aberto e sem mensagens de erro para indicar que o processo continua em execução.
Digitar o caminho do arquivo a cada execução funciona, mas projetos mais organizados costumam definir um script chamado start dentro do package.json.
Quando esse script existe, basta executar npm start no terminal, e o npm se encarrega de chamar o arquivo correto por trás dos panos
Outra ferramenta útil nessa fase é o nodemon, que reinicia o servidor automaticamente sempre que um arquivo do projeto é alterado. Isso evita o trabalho manual de parar o terminal com Ctrl+C e digitar o comando de início de novo a cada mudança no código.
Depois que o terminal mostra o processo em execução, sem erros, o passo seguinte é abrir o navegador e acessar o endereço local configurado no projeto.
Se o servidor responder com uma página, um texto ou uma mensagem definida no código, a execução foi bem-sucedida.
Em projetos que já usam o Express, framework comum para organizar rotas em aplicações Node.js, essa resposta costuma vir de uma rota definida explicitamente no código, como a rota principal do site.
Se o projeto não usa nenhum framework, a resposta pode ser mais simples, gerada diretamente pelo módulo nativo de servidor do Node.js.
Na maioria dos casos, não. O npm já vem junto com a instalação do Node.js, e o comando npm -v confirma isso no terminal.
Se o projeto ainda não tiver um package.json, ele pode ser criado com npm init -y antes de instalar qualquer dependência adicional que o servidor exija.
As duas causas mais comuns são o nome do arquivo e a pasta de execução. Se o arquivo de entrada do projeto se chama server.js ou app.js, o comando precisa refletir esse nome. Da mesma forma, o terminal precisa estar posicionado dentro da pasta do projeto antes de executar o comando.
Esse atalho só funciona quando o package.json do projeto já tem um script chamado start apontando para o arquivo correto. Sem esse script configurado, o npm start retorna erro, e o comando node com o nome do arquivo continua sendo necessário.
A porta usada pelo servidor é definida dentro do próprio arquivo de entrada, no trecho de código que inicia a escuta de conexões. Por isso, abrir esse arquivo e localizar esse trecho é a forma mais confiável de confirmar o número da porta antes de testar no navegador.
Quando o terminal indica que a porta já está ocupada, geralmente outro processo Node.js ainda está em execução em segundo plano. Encerrar esse processo no terminal ou reiniciar o computador libera a porta; outra opção é alterar o número da porta no código do arquivo de entrada antes de tentar novamente.
A ferramenta nodemon foi criada justamente para isso: ela observa os arquivos do projeto e reinicia o servidor automaticamente sempre que detecta uma alteração salva, sem exigir que o terminal seja interrompido e o comando digitado de novo.
Se você quer ingressar ou crescer no mercado da tecnologia, a Allevo Tech oferece formações práticas em áreas de alta demanda, como Engenharia de Software, Ciência de Dados e Inteligência Artificial.
As trilhas são estruturadas para desenvolver competências técnicas e preparar você para os desafios do mercado de trabalho.
Clique no botão abaixo e conheça as formações da Allevo Tech que podem impulsionar a sua trajetória profissional.
A tecnologia mudou a maneira como pesquisamos, estudamos e consumimos cultura. Entenda a evolução do acesso à informação, da biblioteca tradicional à inteligência artificial.
Oferta prevista para novembro e dezembro contempla oito formações. Inscrições e requisitos devem ser consultados nas instituições responsáveis.
Conheça 7 invenções que revolucionaram a tecnologia, da computação à inteligência artificial, e entenda como elas influenciam as profissões do futuro.
