Node.js — Os fundamentos

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.

Resultado esperado :

Reproduzir o projeto, verificar os seus comportamentos e superar uma modificação autónoma.

Leitura
0%

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.

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 reter :

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.

npm start
http://127.0.0.1:3000/
A reter :

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.

q=soupe → 1 recette
duree=20 → soupe et salade, 2 recettes
q=tarte&duree=20 → 0 recette
A reter :

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.

POST /api/recettes → 201
GET /api/recettes/{id reçu} → 200
GET /api/recettes → total 4
A reter :

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.

npm test
A reter :

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.

<option value="15">15 minutes</option>
A reter :

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.

Attendu : 422, aucune recette ajoutée.
A reter :

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.

Format text/plain → 415
Corps "{" avec application/json → 400
A reter :

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.

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);