Node.js — Os fundamentos

Guia 02 / 4

Os essenciais de Node.js

Sintaxe, comandos e escolhas técnicas explicados, com exemplos curtos a adaptar.

Resultado esperado :

Escolher uma instrução ou um comando e prever o seu efeito.

Leitura
0%

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.

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.

npm start
npm run dev
npm test
A reter :

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.

PORT=3001 npm start
A reter :

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.

npm install --save-dev sass@1
npm ci
A reter :

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.

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.

const url = new URL(requete.url, "http://localhost");
const q = url.searchParams.get("q") ?? "";
const duree = url.searchParams.get("duree") ?? "0";
A reter :

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.

const valide = /^\d{1,4}$/.test(dureeSaisie) && Number(dureeSaisie) <= 1440;
A reter :

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.

for await (const morceau of requete) {
  // Compter les octets et conserver les morceaux dans la limite choisie.
}
A reter :

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.

const nouvelle = {
  id: prochainId++,
  titre: valeur.titre.trim(),
  duree_minutes: valeur.duree_minutes
};
A reter :

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.

const contenu = await readFile(new URL("../public/index.html", import.meta.url));
A reter :

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.

curl -i 'http://127.0.0.1:3000/api/recettes?duree=20'
curl -i http://127.0.0.1:3000/api/recettes/9999
A reter :

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.

curl -i -X POST http://127.0.0.1:3000/api/recettes -H "Content-Type: application/json" --data-binary @compote.json
A reter :

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.

npm test
A reter :

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.