@useoptic/optic-node-sdk
v0.0.5
Published
Send data to Optic from JS
Downloads
883
Readme
@useoptic/optic-node-sdk
The code library standardizing data capture for Optic in Node applications. We have a list of middleware available for some frameworks, if we are missing the framework join our community and suggest the next framework or develop it with us.
Requirements
The library requires @useoptic/cli
to be installed, instructions on installing it are available https://www.useoptic.com/docs/.
Intsall
npm install @useoptic/optic-node-sdk
Usage
The library takes a configuration object and captures traffic in the background as long as @useoptic/cli
is installed.
Configuration
All options are optional for easier configuration in your application
enabled
:boolean
(defaults tofalse
) Programmatically control if capturing data and sending it to OpticuploadUrl
:string
(defaults toprocess.env.OPTIC_LOGGING_URL
) The URL to Optics capture URL, if left blank it will expectOPTIC_LOGGING_URL
environment variable set by the Optic CLIconsole
:boolean
(defaults tofalse
) Send to stdout/console for debuggingframework
:string
(defaults to '') Additional information to inform Optic of where it is capturing information
Example
Using the default http
server within Node
const Optic = require('@useoptic/optic-node-sdk');
const http = require('http');
const optic = new Optic({
enabled: true
});
const server = http.createServer((req, res) => {
optic.captureHttpRequest(req, res);
res.writeHead(200);
res.end();
});
const port = 3000;
const host = 'localhost';
server.listen(port, host, () => {
console.log(`Listen http://${host}:${port}`);
});
To start capturing data from the SDK, run your application with
api exec "node <your example file>"
License
This software is licensed under the MIT license.