Add https.get()

diff --git a/doc/api/https.markdown b/doc/api/https.markdown
index ac1edf0..b98c16b 100644 (file)
--- a/doc/api/https.markdown
+++ b/doc/api/https.markdown
@@ -23,9 +23,10 @@ Example:
     }).listen(8000);
 
 
-## https.request
+## https.request(options, callback)
 
 Makes a request to a secure web server.
+Similar options to `http.request()`.
 
 Example:
 
@@ -52,7 +53,25 @@ Example:
       console.error(e);
     });
 
+## https.get(options, callback)
 
+Like `http.get()` but for HTTPS.
+
+Example:
+
+    var https = require('https');
+
+    https.get({ host: 'encrypted.google.com', path: '/' }, function(res) {
+      console.log("statusCode: ", res.statusCode);
+      console.log("headers: ", res.headers);
+
+      res.on('data', function(d) {
+        process.stdout.write(d);
+      });
+
+    }).on('error', function(e) {
+      console.error(e);
+    });
 
 
 

diff --git a/lib/https.js b/lib/https.js
index e2555f0..aaa070a 100644 (file)
--- a/lib/https.js
+++ b/lib/https.js
@@ -44,6 +44,8 @@ Agent.prototype._getConnection = function(host, port, cb) {
 
 
 function getAgent(options) {
+  if (!options.port) options.port = 443;
+
   var id = options.host + ':' + options.port;
   var agent = agents[id];
 
@@ -59,3 +61,11 @@ exports.request = function(options, cb) {
   var agent = getAgent(options);
   return http._requestFromAgent(agent, options, cb);
 };
+
+
+exports.get = function(options, cb) {
+  options.method = 'GET';
+  var req = exports.request(options, cb);
+  req.end();
+  return req;
+};