Guia 03 / 4
Oficina de Node.js · À table !
Construir uma API HTTP local com os módulos nativos do Node.js: lista filtrável, ficha por identificador e adição validada; apresentar os seus dados no navegador e testar as respostas HTTP.
Reproduzir o projeto, verificar os seus comportamentos e superar uma modificação autónoma.
01 · Construir o miniblogue HTTP
Reproduzir os ficheiros completos abaixo no projeto de trabalho.
Etapa 1 · Criar a arborescência
Criar package.json, src/, public/ e test/ e depois cada ficheiro no seu caminho. O conjunto inicial é uma função que produz receitas novas a cada criação de servidor.
Exemplo
src/recettes.js : données, filtre et validation
src/server.js : routage et HTTP
src/index.js : lancement
public/ : interface du navigateur
test/api.test.js : vérification du contrat
A pasta do curso contém JSON pedagógico; os ficheiros da aplicação devem ser criados em mini-blog-node/.
Etapa 2 · Lançar sem dependência externa
Executar npm start e abrir o endereço indicado. O servidor fornece index.html, style.css, app.js e a API. A página carrega as receitas com fetch.
Exemplo
npm start
http://127.0.0.1:3000/
Esperado: três cartões completos com ingredientes e preparação; a mensagem de carregamento passa a ser um total de três receitas.
Etapa 3 · Fazer duas pesquisas
Digitar soupe e validar. Esvaziar depois o campo, escolher 20 minutos e validar. Observar os pedidos no separador Rede do navegador.
Exemplo
q=soupe → 1 recette
duree=20 → soupe et salade, 2 recettes
q=tarte&duree=20 → 0 recette
A página recarrega os dados por HTTP; não se limita a filtrar cartões já presentes.
Etapa 4 · Criar e depois encontrar uma receita
Criar compote.json com o ficheiro completo e enviá-lo depois com curl. Seguir o endereço Location recebido e recarregar a lista.
Exemplo
POST /api/recettes → 201
GET /api/recettes/{id reçu} → 200
GET /api/recettes → total 4
Parar e depois relançar o Node faz o total voltar a 3. Esta versão utiliza a memória do processo, e não o MySQL nem um ficheiro JSON persistente.
02 · Testar, corrigir e alargar
Comparar os estados tanto quanto o conteúdo.
Etapa 5 · Executar os testes do contrato
Lançar npm test. Ler o teste de criação e identificar depois o que impede uma duração negativa e o que recusa o acesso às fontes.
Exemplo
npm test
Esperado: teste bem-sucedido. Um erro faz terminar o comando com um código diferente de zero.
Exercício · Acrescentar um limite de 15 minutos
Acrescentar uma opção 15 minutos em public/index.html. Verificar que não é necessária nenhuma alteração no servidor e que só a salada aparece no conjunto inicial.
Exemplo
<option value="15">15 minutes</option>
Solução: inserir a opção em #duree-max. O contrato já aceita qualquer duração inteira entre 0 e 1440.
Exercício · Recusar uma categoria desconhecida
Criar uma cópia de compote.json com categorie: "Goûter" e enviar o pedido. Explicar onde o pedido é rejeitado.
Exemplo
Attendu : 422, aucune recette ajoutée.
Solução: validerRecette verifica a lista Entrée, Plat, Dessert. Acrescentar uma categoria implicaria uma escolha de contrato e testes adaptados.
Exercício · Reforçar o teste dos formatos
Acrescentar ao teste um pedido POST com Content-Type: text/plain e outro contendo um JSON mal formado. Verificar os estados esperados.
Exemplo
Format text/plain → 415
Corps "{" avec application/json → 400
Comparar com a solução seguinte depois de ter tentado.
Solução · Duas falhas HTTP distintas
Inserir estas asserções no teste antes do seu fecho, com a função appeler já definida.
Exemplo
assert.equal((await appeler("/api/recettes", { method: "POST", headers: { "Content-Type": "text/plain" }, body: "test" })).status, 415);
assert.equal((await appeler("/api/recettes", { method: "POST", headers: { "Content-Type": "application/json" }, body: "{" })).status, 400);