Express API Mocker

Express API Mocker is a simple npm package that allows you to mock APIs using Express and TLS.

Installation

You can install the package via npm:

Bash

npm install express-api-mocker

Features

• Mock GET, POST, PUT, and DELETE endpoints
• Add custom headers to responses
• Enable CORS with customizable options
• TLS/SSL support for secure connections
• Easy to set up and configure

API

addCustomHeaders(headers)

Adds custom headers to all responses.

• headers (Object): An object representing custom headers to be added.

enableCORS(options)

Enables CORS with the specified options.

• options (Object): CORS configuration options.

mockGet(endpoint, response)

Mocks a GET endpoint.

• endpoint (String): The endpoint to mock.
• response (Object): The response to return for the mocked endpoint.

mockPost(endpoint, response)

Mocks a POST endpoint.

• endpoint (String): The endpoint to mock.
• response (Object): The response to return for the mocked endpoint.

mockPut(endpoint, response)

Mocks a PUT endpoint.

• endpoint (String): The endpoint to mock.
• response (Object): The response to return for the mocked endpoint.

mockDelete(endpoint, response)

Mocks a DELETE endpoint.

• endpoint (String): The endpoint to mock.
• response (Object): The response to return for the mocked endpoint.

start(port, options)

Starts the mock server.

• port (Number): The port to run the server on.
• options (Object): Server options.
  • tlsEnabled (Boolean): Whether to enable TLS/SSL.
  • tlsOptions (Object): TLS/SSL options.

Usage

1const { ApiMocker, generateTLSCertificates } = require('express-api-mocker');
2const fs = require('fs');
3
4const mocker = new ApiMocker();
5
6// Add custom headers
7mocker.addCustomHeaders({
8  'X-Custom-Header': 'CustomValue',
9  'X-Powered-By': 'Express-Api-Mocker'
10});
11
12// Enable CORS with options
13mocker.enableCORS({
14  origin: '*', // Allow all origins
15  methods: ['GET', 'POST', 'PUT', 'DELETE'], // Allow specific HTTP methods
16  allowedHeaders: ['Content-Type', 'Authorization'] // Allow specific headers
17});
18
19// Mock some endpoints
20mocker.mockGet('/api/user', { id: 1, name: 'John Doe' });
21mocker.mockPost('/api/login', { success: true, token: 'abc123' });
22mocker.mockPut('/api/user/1', { success: true });
23mocker.mockDelete('/api/user/1', { success: true });
24
25// Generate TLS certificates
26generateTLSCertificates('./cert.pem', './key.pem');
27
28const tlsOptions = {
29  key: fs.readFileSync('./key.pem'),
30  cert: fs.readFileSync('./cert.pem')
31};
32
33// Start the mock server
34mocker.start(3000, {
35  tlsEnabled: true,
36  tlsOptions: tlsOptions
37});
38

License

This project is licensed under the ISC License.