Name: request-logger
Owner: Uphold
Description: A wrapper for the request module that logs all request events.
Created: 2016-12-30 18:08:23.0
Updated: 2017-01-09 14:37:54.0
Pushed: 2017-03-31 18:55:03.0
Size: 41
Language: JavaScript
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
A wrapper for the request module that logs all request events.
Install the package via yarn:
rn add '@uphold/request-logger'
Or via npm:
m install '@uphold/request-logger' --save
Wrap the request module using @uphold/request-logger. By default, all events will be logged to stdout.
t logger = require('@uphold/request-logger');
t request = logger(require('request'));
est.get('https://www.github.com');
headers: ?,
id: '6bfc21a0-0dad-48b2-8378-762e5f85f014',
method: 'GET',
type: 'request',
uri: 'https://www.github.com/' }
headers: ?,
id: '6bfc21a0-0dad-48b2-8378-762e5f85f014',
statusCode: 301,
type: 'redirect',
uri: 'https://github.com/' }
headers: ?,
id: '6bfc21a0-0dad-48b2-8378-762e5f85f014',
method: 'GET',
type: 'request',
uri: 'https://github.com/' }
headers: ?,
id: '6bfc21a0-0dad-48b2-8378-762e5f85f014',
statusCode: 200,
type: 'response',
uri: 'https://github.com/' }
You can optionally define a custom logging function which receives the request object (data) and the request instance:
t logger = require('@uphold/request-logger');
t request = logger(require('request'), data => console.log(`${data.id} ${data.type}: ${data.uri}${data.statusCode ? ` (${data.statusCode})` : ''} ${(data.body ? `${data.body}` : '').length} bytes`));
est.get('https://www.github.com', () => {});
a3600f9-0995-4a89-951f-caf7c0a79a69 request: https://www.github.com/ 0 bytes
a3600f9-0995-4a89-951f-caf7c0a79a69 redirect: https://github.com/ (301) 0 bytes
a3600f9-0995-4a89-951f-caf7c0a79a69 request: https://github.com/ 0 bytes
a3600f9-0995-4a89-951f-caf7c0a79a69 response: https://github.com/ (200) 25562 bytes
Each data object contains a type property indicating the type of event:
error - the request has failed due to an error (e.g. a timeout). data.error is defined.
request - the request succeeded. data.body may be defined for POST requests.
response - the request returned a response. Note that request only buffers the response body if a callback was given, so only in that case will data.body be defined.
redirect - the request received a redirect status code (HTTP 3xx). data.uri will point to the URI of the next request.
complete - the request has been completed. This event is only dispatched on POST requests.
In every event, a data.id parameter is defined to allow matching it to the request it originated from.
The recommended node.js version is >= 6 as it ships with native ES2015 Proxy support. This module supports node.js 4 by means of a polyfill that is loaded under the hood. As usual, keep in mind that polyfills are not as performant as their native counterpart.
The minimum required request version is 2.27.0, although 2.54.0 is a particularly troubled version which is best avoided.
m version [<newversion> | major | minor | patch] -m "Release %s"`
MIT