meu-app-mocking/
├── src/
│   ├── services/
│   │   └── userService.js
│   └── app.js
├── __tests__/
│   └── app.test.js
├── package.json
└── .env

📋 Copiar

mkdir meu-app-mocking
cd meu-app-mocking
npm init -y
npm install express axios dotenv winston
npm install --save-dev jest nock supertest

📋 Copiar

.env



    
📚 Informações da Aula

    
Curso: API Completo - Node.js & Express

    
Tempo estimado: 25 minutos

    
Pré-requisitos: JavaScript básico



EXTERNAL_API_BASE_URL=https://jsonplaceholder.typicode.com
PORT=3000

📋 Copiar

// src/config/logger.js
const winston = require('winston');

// Define os formatos de log
const logFormat = winston.format.printf(({ level, message, timestamp, stack }) => {
  return ${timestamp} ${level}: ${stack || message};
});
// Cria uma instância do logger
const logger = winston.createLogger({
  level: 'info', // Nível de log mínimo
  format: winston.format.combine(
    winston.format.colorize(), // Cores para o console
    winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), // Timestamp
    winston.format.errors({ stack: true }), // Inclui stack trace para erros
    logFormat // Formato personalizado
  ),
  transports: [
    new winston.transports.Console(), // Log para o console
    // Adicionar outros transports, como arquivos, se necessário para produção
    // new winston.transports.File({ filename: 'error.log', level: 'error' }),
    // new winston.transports.File({ filename: 'combined.log' }),
  ],
});
module.exports = logger;

📋 Copiar

// src/services/userService.js
const axios = require('axios');
const logger = require('../config/logger'); // Importa o logger
require('dotenv').config(); // Carrega as variáveis de ambiente

const EXTERNAL_API_BASE_URL = process.env.EXTERNAL_API_BASE_URL;
/* @class UserService
  @description Gerencia operações relacionadas a usuários externos.
 /
class UserService {
    /* Busca todos os usuários da API externa.
      @returns {Promise} Uma promessa que resolve para um array de usuários.
      @throws {Error} Se a requisição à API externa falhar.
     /
    static async getAllUsers() {
        try {
            logger.info('Iniciando busca por todos os usuários na API externa.');
            const response = await axios.get(${EXTERNAL_API_BASE_URL}/users);
            logger.info('Usuários obtidos com sucesso da API externa.');
            return response.data;
        } catch (error) {
            logger.error(Erro ao obter usuários da API externa: ${error.message}, { stack: error.stack });
            // Melhores práticas enterprise: Lançar um erro customizado para melhor tratamento
            throw new Error(Falha ao recuperar usuários: ${error.message});
        }
    }

    / Busca um único usuário pelo ID da API externa.
      @param {number} userId - O ID do usuário a ser buscado.
      @returns {Promise