https: make https.get() accept a URL

https.get() now accepts either a URL (as a string) or an options object.

Refs #2859.
Fixes #3882.

1 files changed, 10 insertions, 3 deletions

diff --git a/doc/api/https.markdown b/doc/api/https.markdown
index 5f0052c2c3a..13691d5b3d0 100644
--- a/doc/api/https.markdown
+++ b/doc/api/https.markdown
@@ -48,8 +48,12 @@ Or
 
 ## https.request(options, callback)
 
-Makes a request to a secure web server.  All options from [http.request()][]
-are valid.
+Makes a request to a secure web server.
+
+`options` can be an object or a string. If `options` is a string, it is
+automatically parsed with [url.parse()](url.html#url.parse).
+
+All options from [http.request()][] are valid.
 
 Example:
 
@@ -157,11 +161,14 @@ Example:
 
 Like `http.get()` but for HTTPS.
 
+`options` can be an object or a string. If `options` is a string, it is
+automatically parsed with [url.parse()](url.html#url.parse).
+
 Example:
 
     var https = require('https');
 
-    https.get({ host: 'encrypted.google.com', path: '/' }, function(res) {
+    https.get('https://encrypted.google.com/' }, function(res) {
       console.log("statusCode: ", res.statusCode);
       console.log("headers: ", res.headers);