稳定度: 3 - 稳定HTTPS is the HTTP protocol over TLS/SSL. In Node this is implemented as a\nseparate module.\n\n
\nHTTPS 是建立在 TLS/SSL 之上的 HTTP 协议。在 Node 中被实现为单独的模块。\n\n
\n", "properties": [ { "textRaw": "类: https.Server", "name": "Server", "desc": "This class is a subclass of tls.Server and emits events same as\nhttp.Server. See http.Server for more information.\n\n
该类是 tls.Server 的子类，并且发生和 http.Server 一样的事件。更多信息详见 http.Server。\n\n
See [http.Server#setTimeout()][].\n\n
\n详见 [http.Server#setTimeout()][]。\n\n
\n", "signatures": [ { "params": [ { "name": "msecs" }, { "name": "callback" } ] } ] } ], "properties": [ { "textRaw": "server.timeout", "name": "timeout", "desc": "See [http.Server#timeout][].\n\n
\n详见 [http.Server#timeout][]。\n\n
\n" } ] }, { "textRaw": "类: https.Agent", "name": "Agent", "desc": "An Agent object for HTTPS similar to [http.Agent][]. See [https.request()][]\nfor more information.\n\n
\n类似于 [http.Agent][] 的 HTTPS Agent 对象。详见 [https.request()][]。\n\n
\n" }, { "textRaw": "https.globalAgent", "name": "globalAgent", "desc": "Global instance of [https.Agent][] for all HTTPS client requests.\n\n
\n所有 HTTPS 客户端请求的全局 [https.Agent][] 实例。\n\n
\n" } ], "methods": [ { "textRaw": "https.createServer(options, [requestListener])", "type": "method", "name": "createServer", "desc": "Returns a new HTTPS web server object. The options is similar to\n[tls.createServer()][]. The requestListener is a function which is\nautomatically added to the 'request' event.\n\n
返回一个新的 HTTPS Web 服务器对象。其中 options 类似于 [tls.createServer()][]；requestListener 是一个会被自动添加到 request 事件的函数。\n\n
Example:\n\n
\n示例：\n\n
\nhttps.createServer(options, function (req, res) {\n res.writeHead(200);\n res.end("hello world\\n");\n}).listen(8000);Or\n\n
\n或者\n\n
\nhttps.createServer(options, function (req, res) {\n res.writeHead(200);\n res.end("hello world\\n");\n}).listen(8000);See [http.listen()][] for details.\n\n
\n详见 [http.listen()][]。\n\n
\n", "signatures": [ { "params": [ { "name": "handle" }, { "name": "callback", "optional": true } ] }, { "params": [ { "name": "path" }, { "name": "callback", "optional": true } ] } ] }, { "textRaw": "server.listen(handle, [callback])", "type": "method", "name": "listen", "desc": "See [http.listen()][] for details.\n\n
\n详见 [http.listen()][]。\n\n
\n", "signatures": [ { "params": [ { "name": "handle" }, { "name": "callback", "optional": true } ] } ] }, { "textRaw": "server.close([callback])", "type": "method", "name": "close", "desc": "See [http.close()][] for details.\n\n
\n详见 [http.close()][]。\n\n
\n", "signatures": [ { "params": [ { "name": "callback", "optional": true } ] } ] } ], "signatures": [ { "params": [ { "name": "options" }, { "name": "requestListener", "optional": true } ] } ] }, { "textRaw": "https.request(options, callback)", "type": "method", "name": "request", "desc": "Makes a request to a secure web server.\n\n
\n向一个安全 Web 服务器发送请求。\n\n
\noptions can be an object or a string. If options is a string, it is\nautomatically parsed with url.parse().\n\n
options 可以是一个对象或字符串。如果 options 是字符串，它会自动被 url.parse() 解析。\n\n
All options from [http.request()][] are valid.\n\n
\n所有来自 [http.request()][] 的选项都是经过验证的。\n\n
\nExample:\n\n
\n示例：\n\n
\nreq.on('error', function(e) {\n console.error(e);\n});The options argument has the following options\n\n
\noptions 参数有如下选项\n\n
\nhost: A domain name or IP address of the server to issue the request to.\nDefaults to 'localhost'.hostname: To support url.parse() hostname is preferred over hostport: Port of remote server. Defaults to 443.method: A string specifying the HTTP request method. Defaults to 'GET'.path: Request path. Defaults to '/'. Should include query string if any.\nE.G. '/index.html?page=12'headers: An object containing request headers.auth: Basic authentication i.e. 'user:password' to compute an\nAuthorization header.agent: Controls [Agent][] behavior. When an Agent is used request will\ndefault to Connection: keep-alive. Possible values:
undefined (default): use [globalAgent][] for this host and port.Agent object: explicitly use the passed in Agent.false: opts out of connection pooling with an Agent, defaults request to\nConnection: close.host：发送请求的服务器的域名或 IP 地址，缺省为 'localhost'。
hostname：为了支持 url.parse()，hostname 优先于 host。port：远程服务器的端口，缺省为 443。method：指定 HTTP 请求方法的字符串，缺省为 `'GET'。path：请求路径，缺省为 '/'。如有查询字串则应包含，比如 '/index.html?page=12'。headers：包含请求头的对象。auth：基本认证，如 'user:password' 来计算 Authorization 头。agent：控制 [Agent][] 行为。当使用 Agent 时请求会缺省为 Connection: keep-alive。可选值有：undefined（缺省）：为该主机和端口使用 [globalAgent][]。Agent 对象：明确使用传入的 Agent。false：不使用 Agent 连接池，缺省请求 Connection: close。The following options from [tls.connect()][] can also be specified. However, a\n[globalAgent][] silently ignores these.\n\n
\n下列来自 [tls.connect()][] 的选项也能够被指定，但一个 [globalAgent][] 会忽略它们。\n\n
\npfx: Certificate, Private key and CA certificates to use for SSL. Default null.key: Private key to use for SSL. Default null.passphrase: A string of passphrase for the private key or pfx. Default null.cert: Public x509 certificate to use. Default null.ca: An authority certificate or array of authority certificates to check\nthe remote host against.ciphers: A string describing the ciphers to use or exclude. Consult\nhttp://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT for\ndetails on the format.rejectUnauthorized: If true, the server certificate is verified against\nthe list of supplied CAs. An 'error' event is emitted if verification\nfails. Verification happens at the connection level, before the HTTP\nrequest is sent. Default true.secureProtocol: The SSL method to use, e.g. SSLv3_method to force\nSSL version 3. The possible values depend on your installation of\nOpenSSL and are defined in the constant [SSL_METHODS][].
pfx：证书，SSL 所用的私钥或 CA 证书。缺省为 null。
key：SSL 所用私钥。缺省为 null。passphrase：私钥或 pfx 的口令字符串，缺省为 null。cert：所用公有 x509 证书，缺省为 null。ca：用于检查远程主机的证书颁发机构或包含一系列证书颁发机构的数组。ciphers：描述要使用或排除的密码的字符串，格式请参阅 http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT。rejectUnauthorized：如为 true 则服务器证书会使用所给 CA 列表验证。如果验证失败则会触发 'error' 时间。验证过程发生于连接层，在 HTTP 请求发送之前。缺省为 true。secureProtocol：所用 SSL 方法，比如 SSLv3_method 强制使用 SSL version 3。可取值取决于您安装的 OpenSSL 并被定义在 [SSL_METHODS][] 常量。In order to specify these options, use a custom Agent.\n\n
要指定这些选项，使用一个自定义 Agent。\n\n
Example:\n\n
\n示例：\n\n
\nvar req = https.request(options, function(res) {\n ...\n}Or does not use an Agent.\n\n
或不使用 Agent。\n\n
Example:\n\n
\n示例：\n\n
\nvar req = https.request(options, function(res) {\n ...\n}Like http.get() but for HTTPS.\n\n
类似 http.get() 但为 HTTPS。\n\n
options can be an object or a string. If options is a string, it is\nautomatically parsed with url.parse().\n\n
options 可以是一个对象或字符串。如果 options 是字符串，它会自动被 url.parse() 解析。\n\n
Example:\n\n
\n示例：\n\n
\n}).on('error', function(e) {\n console.error(e);\n});