Adds a .toCurl()
method to http.ClientRequests to generate output equivalent to the 'Copy as Curl' option in the WebKit
debugger.
- 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)
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.
The code from WebKit removes headers that curl calculates for us (namely content-length
).
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
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
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).