Guia 02 / 4
Os essenciais de Node.js
Sintaxe, comandos e escolhas técnicas explicados, com exemplos curtos a adaptar.
Escolher uma instrução ou um comando e prever o seu efeito.
01 · Preparar e lançar o projeto
Executar os comandos a partir de mini-blog-node/.
Verificar o ambiente
Verificar a versão e o acesso aos executáveis. Esta oficina visa o Node 24.x para manter um ambiente preciso.
Exemplo
node --version
npm --version
Definir os scripts npm
Os scripts agrupam os comandos do projeto. start lança o servidor, dev reinicia-o em caso de modificações, test executa os testes nativos.
Exemplo
npm start
npm run dev
npm test
Criar o package.json completo da oficina antes de executar estes comandos.
Paragem e configuração local
Ctrl+C pára o servidor. PORT é uma variável de ambiente opcional; o seu valor é uma cadeia antes da conversão e da validação.
Exemplo
PORT=3001 npm start
A sintaxe acima é a do Bash. Noutra shell, definir PORT com a sua sintaxe própria.
Dependências e scripts npm, como prolongamento
Uma dependência de desenvolvimento serve para construir ou verificar o projeto. Uma instalação normal atualiza o ficheiro de bloqueio; npm ci utiliza um ficheiro de bloqueio existente sem o recalcular.
Exemplo
npm install --save-dev sass@1
npm ci
O primeiro exemplo prepara o curso de SCSS. npm ci exige um package-lock.json coerente.
02 · Ler e escrever os tratamentos HTTP
Os excertos pressupõem as importações e variáveis correspondentes; os ficheiros completos estão na oficina.
createServer e listen
createServer recebe uma função chamada para cada pedido. listen abre a escuta. A oficina separa a criação do servidor do seu arranque para poder testá-lo.
Exemplo
import { createServer } from "node:http";
const serveur = createServer((req, res) => {
res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
res.end("À table !");
});
serveur.listen(3000, "127.0.0.1");
URL e parâmetros de pesquisa
URL decompõe o caminho e os parâmetros. searchParams evita cortar o endereço à mão.
Exemplo
const url = new URL(requete.url, "http://localhost");
const q = url.searchParams.get("q") ?? "";
const duree = url.searchParams.get("duree") ?? "0";
A base fixa serve apenas para analisar um URL relativo. Os parâmetros continuam a ter de ser validados.
Validar os filtros
A oficina aceita uma duração inteira de 0 a 1440; 0 significa todas as durações. Verifica-se o texto antes da conversão para recusar abc, -1 e 2.5.
Exemplo
const valide = /^\d{1,4}$/.test(dureeSaisie) && Number(dureeSaisie) <= 1440;
A pesquisa normaliza a capitalização e os espaços de extremidade, mas não retira os acentos.
Ler um corpo JSON
Um pedido HTTP é um fluxo de pedaços. O servidor lê-os de forma assíncrona, limita o que guarda em memória e interpreta depois o JSON.
Exemplo
for await (const morceau of requete) {
// Compter les octets et conserver les morceaux dans la limite choisie.
}
O ficheiro completo limita o corpo a 16 KiB. Este limite de memória e um prazo não substituem uma política completa contra um grande número de pedidos.
Copiar os campos autorizados
Depois da validação, construir um novo objeto apenas com os campos do contrato. Não aceitar o id enviado pelo cliente e não copiar todas as suas propriedades.
Exemplo
const nouvelle = {
id: prochainId++,
titre: valeur.titre.trim(),
duree_minutes: valeur.duree_minutes
};
O ficheiro completo verifica também as porções, a categoria e as tabelas de linhas.
Servir os ficheiros públicos
readFile lê os ficheiros de forma assíncrona. Uma lista fixa associa os URL autorizados aos ficheiros públicos; os ficheiros de src/ e o package.json não são servidos.
Exemplo
const contenu = await readFile(new URL("../public/index.html", import.meta.url));
Não concatenar diretamente um caminho pedido pelo utilizador ao caminho do disco.
03 · Interrogar e testar
Começar por uma resposta simples e testar depois os casos-limite.
curl para uma leitura
curl apresenta o conteúdo recebido. -i acrescenta os cabeçalhos e permite verificar o estado.
Exemplo
curl -i 'http://127.0.0.1:3000/api/recettes?duree=20'
curl -i http://127.0.0.1:3000/api/recettes/9999
Esperado: 200 e duas receitas, depois 404.
curl para uma criação
Enviar um ficheiro JSON torna o corpo legível e evita erros de escape da shell. Criar compote.json a partir do exemplo completo.
Exemplo
curl -i -X POST http://127.0.0.1:3000/api/recettes -H "Content-Type: application/json" --data-binary @compote.json
Esperado: 201 e um cabeçalho Location. As adições desaparecem quando o processo reinicia.
node:test e assert
O teste lança um servidor isolado numa porta disponível, envia pedidos reais e fecha o servidor no fim. As asserções verificam comportamentos úteis ao cliente.
Exemplo
npm test
O ficheiro api.test.js testa a pesquisa, a criação, a rejeição e o acesso aos ficheiros. Nenhum servidor manual deve estar lançado para ele.