How goldbergyoni/nodejs-testing-best-practices works
This repository is a Node.js testing-practices guide, with a showcase order-service component and smaller recipes illustrating other frameworks and testing topics. The central example workflow accepts HTTP or queue input, applies order logic, accesses persistence and collaborators, and reports errors. The README documents broader coverage of component tests, infrastructure, data, integrations, queues, and mocking; recipe and anti-pattern branches represent those topics without mapping test/build machinery. Relationships in the showcase follow sampled source; broader topic links are documented by the README.
Main entry points: order-service.js Order logic · error-handling.js Error handling · message-queue-client.js Queue client · api.ts HTTP routes
Components 19
Testing guide
- Best practices
README.md - Anti-pattern examples
anti-patterns - Testing recipes
recipes
Order showcase
- HTTP routes
example-application/entry-points/api.ts - Authentication
example-application/libraries/authentication-middleware.js - Order logic
example-application/business-logic/order-service.js - Queue consumer
example-application/entry-points/message-queue-consumer.js - Error handling
example-application/error-handling.js - Order repository
example-application/data-access/order-repository.js
Showcase integrations
- Order database
- User service
- Mailer service
example-application/libraries/mailer.js - Logger
example-application/libraries/logger.js - Queue client
example-application/libraries/message-queue-client.js - Queue provider
example-application/libraries/fake-message-queue-provider.js
Platform recipes
- Nest server setup
recipes/nestjs/main.ts - Nest app module
recipes/nestjs/app/app.module.ts - Nest sample route
recipes/nestjs/app/app.controller.ts
Other components
- Guide reader
Connections 20
- Guide reader → Best practices: learns from
README.md - Best practices → Anti-pattern examples: covers pitfalls
README.md - Best practices → Testing recipes: offers examples
README.md - HTTP routes → Authentication: applies middleware
example-application/entry-points/api.ts - HTTP routes → Order logic: routes orders
example-application/entry-points/api.ts - HTTP routes → Error handling: forwards errors
example-application/entry-points/api.ts - Queue consumer → Queue client: consumes messages
example-application/entry-points/message-queue-consumer.js - Queue consumer → Order logic: deletes orders
example-application/entry-points/message-queue-consumer.js - Queue consumer → Error handling: handles process errors
example-application/entry-points/message-queue-consumer.js - Order logic → Order repository: reads and writes
example-application/business-logic/order-service.js - Order repository → Order database: persists orders
example-application/data-access/order-repository.js - Order logic → User service: verifies user
example-application/business-logic/order-service.js - Order logic → Mailer service: sends order mail
example-application/business-logic/order-service.js - Order logic → Queue client: publishes event
example-application/business-logic/order-service.js - Error handling → Logger: logs errors
example-application/error-handling.js - Error handling → Mailer service: sends alerts
example-application/error-handling.js - Queue client → Queue provider: uses fake provider
example-application/libraries/message-queue-client.js - Queue client → Error handling: reports failures
example-application/libraries/message-queue-client.js - Nest server setup → Nest app module: starts module
recipes/nestjs/main.ts - Nest app module → Nest sample route: registers controller
recipes/nestjs/app/app.module.ts