curler
v0.0.5
Published
A native c++ node.js module for asynchronous http requests via libcurl.
Downloads
7
Readme
curler
A native c++ node.js module for asynchronous http requests via libcurl.
Install
request(options, callback[err, res, bodyData])
Options
url
: request url. (required)method
: HTTP method type. Defaults toGET
. (can be anything)headers
: Optional JSON key/value array of the request headers.userAgent
: Optional custom user agent.proxy
: Optional proxy support. (i.e. http://proxy.example.com:80)data
: Optional request body data.timeout
: Total request timeout (connection/response) in milliseconds.connectionTimeout
: Connection timeout in milliseconds.
Examples
GET request
var curler = require("curler").Curler;
var curl = new curler();
var options = {
method: "GET",
url: 'http://www.google.com'
};
var startDate = Date.now();
curl.request(options, function(err, res, bodyData) {
var duration = (Date.now() - startDate);
if (err) {
console.log(err);
}
else {
console.log('statusCode: %s', res.statusCode);
console.log('bodyData: %s', bodyData);
}
console.log("curler (libcurl) performed http request in %s ms. dnsTime: %s, connectTime: %s, preTransferTime: %s, startTransferTime: %s, totalTime: %s", duration, res.dnsTime, res.connectTime, res.preTransferTime, res.startTransferTime, res.totalTime);
});
POST request (body data)
var curler = require("curler").Curler;
var curl = new curler();
var data = JSON.stringify({ hello: 'world' });
var options = {
method: "POST",
url: 'http://www.example.com/',
userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 5_0 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9A334 Safari/7534.48.3',
headers: {
'Content-Type': 'application/json',
'Connection': 'Keep-Alive'
},
data: data,
timeout: 5000,
connectionTimeout: 5000
};
var startDate = Date.now();
curl.request(options, function(err, res, bodyData) {
var duration = (Date.now() - startDate);
if (err) {
console.log(err);
}
else {
console.log('statusCode: %s', res.statusCode);
console.log('bodyData: %s', bodyData);
}
console.log("curler (libcurl) performed http request in %s ms. dnsTime: %s, connectTime: %s, preTransferTime: %s, startTransferTime: %s, totalTime: %s", duration, res.dnsTime, res.connectTime, res.preTransferTime, res.startTransferTime, res.totalTime);
});
TODO
- Allow Expect: 100-Continue to be configurable, rather than always off
- Load a queue of curl handles when the module loads (ghetto connection pooling). Need a deconstructor in curler.cc that works first!