request-to-curl
v0.1.6
Published
Adds a .toCurl() method to http.ClientRequest to generate output equivalent to the 'Copy as Curl' option in the WebKit debugger
Downloads
5,858
Maintainers
Readme
node-request-to-curl
Adds a .toCurl()
method to http.ClientRequests to generate output equivalent to the 'Copy as Curl' option in the WebKit
debugger.
Features
- Based from the WebKit code that Chrome uses in its debugger to generate curl commands
- Hooks into Node.js at a low-level and is compatible with helper libraries (tested with request)
- Parses the outgoing request to get what was sent over the wire (compatible with streams)
Use in production
All outgoing HTTP requests are parsed using Node's own HTTP library in a manner similar to how an incoming request is handled. This will incur a minor performance penalty.
Headers
The code from WebKit removes headers that curl calculates for us (namely content-length
).
How to use
request
var request = require('request');
require('request-to-curl');
request('http://www.google.com', function (error, response, body) {
console.log(response.request.req.toCurl());
});
Output:
curl 'http://www.google.com/' --compressed
http
var http = require('http'),
querystring = require('querystring');
require('request-to-curl');
var postData = querystring.stringify({
'msg': 'Hello World!'
});
var options = {
hostname: 'www.google.com',
port: 80,
path: '/upload',
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Content-Length': postData.length
}
};
var req = http.request(options, (res) => {
console.log(req.toCurl());
});
req.on('error', (e) => {
console.log(`problem with request: ${e.message}`);
});
// write data to request body
req.write(postData);
req.end();
Output:
curl 'http://www.google.com/upload' -H 'content-type: application/x-www-form-urlencoded' --data 'msg=Hello%20World!' --compressed
Alternatives
request-as-curl is a similar module, however, it does not parse the
request over the wire and is not compatible with streams. request-as-curl
requires you to pass in your request body
(which should be doable in most cases) and write code for each request. Global error handling is complicated by needing
to keep the request body in scope.
request-to-curl
favors over-the-wire accuracy for all outgoing requests.
request-as-curl
does not need to parse outgoing requests over the wire and is ideal if you want to debug a handful
of requests and do not use streams. request-to-curl
is what you want if you want to be log the curl command to
reproduce any failed outgoing HTTP requests anywhere in your app (which is very helpful for working with third party
HTTP APIs).