2.0.1 • Published 3 months ago

@adobe/aio-lib-test-proxy v2.0.1

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
3 months ago

Version Downloads/week Node.js CI License Codecov Coverage

Adobe I/O Lib for Test Proxies and Api Servers

Installing

$ npm install --save-dev @adobe/aio-lib-test-proxy

Usage

1) Initialize the SDK

const { createApiServer, createHttpProxy, createHttpsProxy } = require('@adobe/aio-lib-test-proxy')

const httpsProxy = createHttpsProxy()
const response = await fetch('https://adobe.com', {
  agent: new HttpsProxyAgent('https://my-proxy.local:8080')
})
httpsProxy.stop()

const apiServer = createApiServer()
const response2 = await fetch('http://localhost:3000/mirror?foo=bar')
const response = await fetch('http://localhost:3000/post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ foo: 'bar' })
})
apiServer.close()

Functions

Typedefs

createApiServer(options) ⇒ object

Create a simple API server.

For use in tests only. Default port is 3000.

  1. GET /mirror will return any query variables as json.
  2. POST /post will return the posted body as json.

Kind: global function
Returns: object - the HTTP API server object

ParamTypeDefaultDescription
optionsobjectthe options object
options.portnumber3000the port number to listen to
options.useSslnumberfalseuse ssl (https)

createHttpProxy(httpOptions) ⇒ Promise.<mockttp.Mockttp>

Create a HTTP forwarding proxy

For use in tests only. Default port is 8080.

Kind: global function
Returns: Promise.<mockttp.Mockttp> - the proxy server instance

ParamTypeDescription
httpOptionsHttpOptionsthe http proxy options

createHttpsProxy(httpOptions) ⇒ Promise.<mockttp.Mockttp>

Create a HTTPS forwarding proxy

For use in tests only. Default port is 8081.

This will generate certs for SSL, and add it to the root CAs temporarily. This prevents any self-signed cert errors for tests when using the https proxy.

Kind: global function
Returns: Promise.<mockttp.Mockttp> - the proxy server instance

ParamTypeDescription
httpOptionsHttpOptionsthe http proxy options

HttpOptions : object

HTTP Options

Kind: global typedef
Properties

NameTypeDefaultDescription
portnumberthe port to use
useBasicAuthbooleanuse basic authorization
usernamebooleanadminthe username for basic authorization
passwordbooleansecretthe password for basic authorization

Debug Logs

LOG_LEVEL=debug <your_call_here>

Prepend the LOG_LEVEL environment variable and debug value to the call that invokes your function, on the command line. This should output a lot of debug data for your SDK calls.

Contributing

Contributions are welcome! Read the Contributing Guide for more information.

Licensing

This project is licensed under the Apache V2 License. See LICENSE for more information.