Skip to main content

Node.js Testing

Test your Node.js applications with AI-powered remote browsers. No code installation required.

How It Works​

DebuggAI connects to your running Node.js development server and tests it using remote browsers. Our AI agents understand Express.js routes, API endpoints, authentication flows, and complex server-side functionality.

Quick Setup​

1. Start Your Node.js App​

npm start          # Standard Node.js app
npm run dev        # Development with nodemon
node app.js        # Express.js application

2. Create a Test​

  • Press Cmd+Alt+C in VS Code
  • Describe what to test: "Test user login form with session handling"
  • DebuggAI runs the test using remote browsers

3. Get Results​

  • Screenshots and recordings in VS Code Test Results panel
  • Pass/fail status with detailed analysis
  • AI insights about Node.js-specific functionality

Common Test Examples​

Express.js & APIs​

"Test user registration form creates account via API"
"Check login form authenticates and redirects properly"
"Verify file upload form processes and stores files"

Authentication & Sessions​

"Test JWT authentication login and logout flow"
"Check OAuth integration redirects to correct dashboard"
"Verify session management persists across page reloads"

Real-time Features​

"Test chat application sends and receives messages"
"Check real-time notifications appear when events occur"
"Verify WebSocket connection handles disconnection gracefully"

Node.js Features Supported​

DebuggAI automatically handles:

  • Express.js & Fastify - Tests routes, middleware, and API endpoints through web interface
  • Authentication - Tests JWT, OAuth, sessions, and role-based access control
  • Real-time Features - Tests WebSocket, Socket.io, and server-sent events
  • Database Integration - Tests MongoDB, PostgreSQL, Redis through user interactions
  • TypeScript - Full support for TypeScript Node.js applications
  • Microservices - Tests service communication through main application interface

Package Managers Supported​

  • npm - Standard Node.js package manager
  • yarn - Alternative package manager with workspace support
  • pnpm - Fast, disk space efficient package manager
  • bun - All-in-one toolkit for JavaScript and TypeScript

Troubleshooting​

Common Issues​

  • Port mismatch: Ensure extension is configured for your Node.js server port (usually 3000)
  • Server not running: Verify your Node.js development server is active
  • Environment variables: Check .env file loading and database connections

Getting Help​

  • Check Troubleshooting Guide for common solutions
  • Review test results and screenshots for debugging hints
  • Contact support through debugg.ai if needed

CI with Debugg CLI​

Use the Debugg CLI to run Node.js app tests in CI:

  • See templates in Debugg CLI Workflows
  • Start your app: node server.js or pnpm start and set TEST_URL
  • Provide DEBUGGAI_API_KEY via repository secrets

Next: Explore Python Testing for backend scripting applications.