Gecko [ unitednationsplay.com ]

Name	Size	Permission	Date
assets	[ DIR ]	drwxr-xr-x	2022-01-26 16:43
addons.html	97.08 KB	-rw-r--r--	2022-01-10 13:06
addons.json	48.6 KB	-rw-r--r--	2022-01-10 13:06
addons.md	39.44 KB	-rw-r--r--	2022-01-10 13:06
all.html	5.06 MB	-rw-r--r--	2022-01-10 13:06
all.json	4.78 MB	-rw-r--r--	2022-01-10 13:06
assert.html	118.84 KB	-rw-r--r--	2022-01-10 13:06
assert.json	83.37 KB	-rw-r--r--	2022-01-10 13:06
assert.md	47.93 KB	-rw-r--r--	2022-01-10 13:06
async_hooks.html	94.53 KB	-rw-r--r--	2022-01-10 13:06
async_hooks.json	64.9 KB	-rw-r--r--	2022-01-10 13:06
async_hooks.md	38.62 KB	-rw-r--r--	2022-01-10 13:06
buffer.html	289.36 KB	-rw-r--r--	2022-01-10 13:06
buffer.json	227.52 KB	-rw-r--r--	2022-01-10 13:06
buffer.md	109.83 KB	-rw-r--r--	2022-01-10 13:06
child_process.html	156.96 KB	-rw-r--r--	2022-01-10 13:06
child_process.json	140.03 KB	-rw-r--r--	2022-01-10 13:06
child_process.md	69.69 KB	-rw-r--r--	2022-01-10 13:06
cli.html	99.52 KB	-rw-r--r--	2022-01-10 13:06
cli.json	97.49 KB	-rw-r--r--	2022-01-10 13:06
cli.md	47.37 KB	-rw-r--r--	2022-01-10 13:06
cluster.html	65.92 KB	-rw-r--r--	2022-01-10 13:06
cluster.json	45.84 KB	-rw-r--r--	2022-01-10 13:06
cluster.md	24.83 KB	-rw-r--r--	2022-01-10 13:06
console.html	50.57 KB	-rw-r--r--	2022-01-10 13:06
console.json	40.04 KB	-rw-r--r--	2022-01-10 13:06
console.md	16.55 KB	-rw-r--r--	2022-01-10 13:06
crypto.html	297.2 KB	-rw-r--r--	2022-01-10 13:06
crypto.json	261.36 KB	-rw-r--r--	2022-01-10 13:06
crypto.md	124.37 KB	-rw-r--r--	2022-01-10 13:06
debugger.html	21.62 KB	-rw-r--r--	2022-01-10 13:06
debugger.json	9.75 KB	-rw-r--r--	2022-01-10 13:06
debugger.md	6.43 KB	-rw-r--r--	2022-01-10 13:06
deprecations.html	142.64 KB	-rw-r--r--	2022-01-10 13:06
deprecations.json	164.68 KB	-rw-r--r--	2022-01-10 13:06
deprecations.md	81.32 KB	-rw-r--r--	2022-01-10 13:06
dgram.html	67.09 KB	-rw-r--r--	2022-01-10 13:06
dgram.json	57.33 KB	-rw-r--r--	2022-01-10 13:06
dgram.md	27.81 KB	-rw-r--r--	2022-01-10 13:06
diagnostics_channel.html	21.13 KB	-rw-r--r--	2022-01-10 13:06
diagnostics_channel.json	10.8 KB	-rw-r--r--	2022-01-10 13:06
diagnostics_channel.md	5.24 KB	-rw-r--r--	2022-01-10 13:06
dns.html	109.72 KB	-rw-r--r--	2022-01-10 13:06
dns.json	98.84 KB	-rw-r--r--	2022-01-10 13:06
dns.md	44.29 KB	-rw-r--r--	2022-01-10 13:06
documentation.html	18.4 KB	-rw-r--r--	2022-01-10 13:06
documentation.json	8.83 KB	-rw-r--r--	2022-01-10 13:06
documentation.md	4.05 KB	-rw-r--r--	2022-01-10 13:06
domain.html	41.38 KB	-rw-r--r--	2022-01-10 13:06
domain.json	22.06 KB	-rw-r--r--	2022-01-10 13:06
domain.md	15.2 KB	-rw-r--r--	2022-01-10 13:06
embedding.html	24.65 KB	-rw-r--r--	2022-01-10 13:06
embedding.json	10.05 KB	-rw-r--r--	2022-01-10 13:06
embedding.md	8.67 KB	-rw-r--r--	2022-01-10 13:06
errors.html	189.1 KB	-rw-r--r--	2022-01-10 13:06
errors.json	194.73 KB	-rw-r--r--	2022-01-10 13:06
errors.md	82.71 KB	-rw-r--r--	2022-01-10 13:06
esm.html	97.97 KB	-rw-r--r--	2022-01-10 13:06
esm.json	78.48 KB	-rw-r--r--	2022-01-10 13:06
esm.md	48.2 KB	-rw-r--r--	2022-01-10 13:06
events.html	129.56 KB	-rw-r--r--	2022-01-10 13:06
events.json	94.12 KB	-rw-r--r--	2022-01-10 13:06
events.md	43.71 KB	-rw-r--r--	2022-01-10 13:06
fs.html	503.09 KB	-rw-r--r--	2022-01-10 13:06
fs.json	500.22 KB	-rw-r--r--	2022-01-10 13:06
fs.md	210.32 KB	-rw-r--r--	2022-01-10 13:06
globals.html	29.55 KB	-rw-r--r--	2022-01-10 13:06
globals.json	31.16 KB	-rw-r--r--	2022-01-10 13:06
globals.md	8.21 KB	-rw-r--r--	2022-01-10 13:06
http.html	213.14 KB	-rw-r--r--	2022-01-10 13:06
http.json	214.96 KB	-rw-r--r--	2022-01-10 13:06
http.md	91.28 KB	-rw-r--r--	2022-01-10 13:06
http2.html	274.7 KB	-rw-r--r--	2022-01-10 13:06
http2.json	274.23 KB	-rw-r--r--	2022-01-10 13:06
http2.md	123.62 KB	-rw-r--r--	2022-01-10 13:06
https.html	44.54 KB	-rw-r--r--	2022-01-10 13:06
https.json	36.55 KB	-rw-r--r--	2022-01-10 13:06
https.md	14.58 KB	-rw-r--r--	2022-01-10 13:06
index.html	12.21 KB	-rw-r--r--	2022-01-10 13:06
index.json	54 B	-rw-r--r--	2022-01-10 13:06
index.md	1.73 KB	-rw-r--r--	2022-01-10 13:06
inspector.html	25.57 KB	-rw-r--r--	2022-01-10 13:06
inspector.json	13.43 KB	-rw-r--r--	2022-01-10 13:06
inspector.md	6.66 KB	-rw-r--r--	2022-01-10 13:06
intl.html	25.1 KB	-rw-r--r--	2022-01-10 13:06
intl.json	14.5 KB	-rw-r--r--	2022-01-10 13:06
intl.md	10.46 KB	-rw-r--r--	2022-01-10 13:06
module.html	23.9 KB	-rw-r--r--	2022-01-10 13:06
module.json	13.29 KB	-rw-r--r--	2022-01-10 13:06
module.md	5.2 KB	-rw-r--r--	2022-01-10 13:06
modules.html	67.19 KB	-rw-r--r--	2022-01-10 13:06
modules.json	48.92 KB	-rw-r--r--	2022-01-10 13:06
modules.md	30.83 KB	-rw-r--r--	2022-01-10 13:06
n-api.html	336.63 KB	-rw-r--r--	2022-01-10 13:06
n-api.json	330.37 KB	-rw-r--r--	2022-01-10 13:06
n-api.md	206.51 KB	-rw-r--r--	2022-01-10 13:06
net.html	111.64 KB	-rw-r--r--	2022-01-10 13:06
net.json	108.87 KB	-rw-r--r--	2022-01-10 13:06
net.md	44.19 KB	-rw-r--r--	2022-01-10 13:06
os.html	60.56 KB	-rw-r--r--	2022-01-10 13:06
os.json	50.72 KB	-rw-r--r--	2022-01-10 13:06
os.md	33.98 KB	-rw-r--r--	2022-01-10 13:06
packages.html	80.39 KB	-rw-r--r--	2022-01-10 13:06
packages.json	59.35 KB	-rw-r--r--	2022-01-10 13:06
packages.md	39.1 KB	-rw-r--r--	2022-01-10 13:06
path.html	43.66 KB	-rw-r--r--	2022-01-10 13:06
path.json	27.96 KB	-rw-r--r--	2022-01-10 13:06
path.md	14.46 KB	-rw-r--r--	2022-01-10 13:06
perf_hooks.html	71.71 KB	-rw-r--r--	2022-01-10 13:06
perf_hooks.json	49.24 KB	-rw-r--r--	2022-01-10 13:06
perf_hooks.md	23.17 KB	-rw-r--r--	2022-01-10 13:06
policy.html	35.98 KB	-rw-r--r--	2022-01-10 13:06
policy.json	18.38 KB	-rw-r--r--	2022-01-10 13:06
policy.md	13.9 KB	-rw-r--r--	2022-01-10 13:06
process.html	192.69 KB	-rw-r--r--	2022-01-10 13:06
process.json	150.9 KB	-rw-r--r--	2022-01-10 13:06
process.md	86.44 KB	-rw-r--r--	2022-01-10 13:06
punycode.html	19.88 KB	-rw-r--r--	2022-01-10 13:06
punycode.json	8.79 KB	-rw-r--r--	2022-01-10 13:06
punycode.md	4.17 KB	-rw-r--r--	2022-01-10 13:06
querystring.html	22.01 KB	-rw-r--r--	2022-01-10 13:06
querystring.json	12.74 KB	-rw-r--r--	2022-01-10 13:06
querystring.md	5.48 KB	-rw-r--r--	2022-01-10 13:06
readline.html	69.79 KB	-rw-r--r--	2022-01-10 13:06
readline.json	55.74 KB	-rw-r--r--	2022-01-10 13:06
readline.md	28.04 KB	-rw-r--r--	2022-01-10 13:06
repl.html	58.19 KB	-rw-r--r--	2022-01-10 13:06
repl.json	44.5 KB	-rw-r--r--	2022-01-10 13:06
repl.md	23.61 KB	-rw-r--r--	2022-01-10 13:06
report.html	71.4 KB	-rw-r--r--	2022-01-10 13:06
report.json	21.23 KB	-rw-r--r--	2022-01-10 13:06
report.md	17.92 KB	-rw-r--r--	2022-01-10 13:06
stream.html	226.43 KB	-rw-r--r--	2022-01-10 13:06
stream.json	223.31 KB	-rw-r--r--	2022-01-10 13:06
stream.md	100.94 KB	-rw-r--r--	2022-01-10 13:06
string_decoder.html	17.5 KB	-rw-r--r--	2022-01-10 13:06
string_decoder.json	5.8 KB	-rw-r--r--	2022-01-10 13:06
string_decoder.md	2.94 KB	-rw-r--r--	2022-01-10 13:06
synopsis.html	13.93 KB	-rw-r--r--	2022-01-10 13:06
synopsis.json	2.97 KB	-rw-r--r--	2022-01-10 13:06
synopsis.md	2.13 KB	-rw-r--r--	2022-01-10 13:06
timers.html	32.99 KB	-rw-r--r--	2022-01-10 13:06
timers.json	23.92 KB	-rw-r--r--	2022-01-10 13:06
timers.md	10.55 KB	-rw-r--r--	2022-01-10 13:06
tls.html	152.2 KB	-rw-r--r--	2022-01-10 13:06
tls.json	161.77 KB	-rw-r--r--	2022-01-10 13:06
tls.md	81.06 KB	-rw-r--r--	2022-01-10 13:06
tracing.html	22.43 KB	-rw-r--r--	2022-01-10 13:06
tracing.json	12.14 KB	-rw-r--r--	2022-01-10 13:06
tracing.md	6.59 KB	-rw-r--r--	2022-01-10 13:06
tty.html	29.16 KB	-rw-r--r--	2022-01-10 13:06
tty.json	22.31 KB	-rw-r--r--	2022-01-10 13:06
tty.md	8.78 KB	-rw-r--r--	2022-01-10 13:06
url.html	122.38 KB	-rw-r--r--	2022-01-10 13:06
url.json	88.21 KB	-rw-r--r--	2022-01-10 13:06
url.md	49.32 KB	-rw-r--r--	2022-01-10 13:06
util.html	199.52 KB	-rw-r--r--	2022-01-10 13:06
util.json	171.18 KB	-rw-r--r--	2022-01-10 13:06
util.md	71.47 KB	-rw-r--r--	2022-01-10 13:06
v8.html	51.61 KB	-rw-r--r--	2022-01-10 13:06
v8.json	39.5 KB	-rw-r--r--	2022-01-10 13:06
v8.md	16.55 KB	-rw-r--r--	2022-01-10 13:06
vm.html	123.51 KB	-rw-r--r--	2022-01-10 13:06
vm.json	113.19 KB	-rw-r--r--	2022-01-10 13:06
vm.md	55.37 KB	-rw-r--r--	2022-01-10 13:06
wasi.html	21.16 KB	-rw-r--r--	2022-01-10 13:06
wasi.json	11.72 KB	-rw-r--r--	2022-01-10 13:06
wasi.md	6.27 KB	-rw-r--r--	2022-01-10 13:06
worker_threads.html	90.29 KB	-rw-r--r--	2022-01-10 13:06
worker_threads.json	69.84 KB	-rw-r--r--	2022-01-10 13:06
worker_threads.md	39 KB	-rw-r--r--	2022-01-10 13:06
zlib.html	95.09 KB	-rw-r--r--	2022-01-10 13:06
zlib.json	100.2 KB	-rw-r--r--	2022-01-10 13:06
zlib.md	35.03 KB	-rw-r--r--	2022-01-10 13:06

Rename

{
 "type": "module",
 "source": "doc/api/https.md",
 "modules": [
 {
 "textRaw": "HTTPS",
 "name": "https",
 "introduced_in": "v0.10.0",
 "stability": 2,
 "stabilityText": "Stable",
 "desc": "Source Code: <a href=\"https://github.com/nodejs/node/blob/v14.18.3/lib/https.js\">lib/https.js</a>\nHTTPS is the HTTP protocol over TLS/SSL. In Node.js this is implemented as a\nseparate module.",
 "classes": [
 {
 "textRaw": "Class: `https.Agent`",
 "type": "class",
 "name": "https.Agent",
 "meta": {
 "added": [
 "v0.4.5"
 ],
 "changes": [
 {
 "version": "v5.3.0",
 "pr-url": "https://github.com/nodejs/node/pull/4252",
 "description": "support `0` `maxCachedSessions` to disable TLS session caching."
 },
 {
 "version": "v2.5.0",
 "pr-url": "https://github.com/nodejs/node/pull/2228",
 "description": "parameter `maxCachedSessions` added to `options` for TLS sessions reuse."
 }
 ]
 },
 "desc": "An <a href=\"#https_class_https_agent\"><code>Agent</code></a> object for HTTPS similar to <a href=\"http.html#http_class_http_agent\"><code>http.Agent</code></a>. See\n<a href=\"#https_https_request_options_callback\"><code>https.request()</code></a> for more information.",
 "signatures": [
 {
 "params": [
 {
 "textRaw": "`options` {Object} Set of configurable options to set on the agent. Can have the same fields as for [`http.Agent(options)`][], and",
 "name": "options",
 "type": "Object",
 "desc": "Set of configurable options to set on the agent. Can have the same fields as for [`http.Agent(options)`][], and",
 "options": [
 {
 "textRaw": "`maxCachedSessions` {number} maximum number of TLS cached sessions. Use `0` to disable TLS session caching. **Default:** `100`.",
 "name": "maxCachedSessions",
 "type": "number",
 "default": "`100`",
 "desc": "maximum number of TLS cached sessions. Use `0` to disable TLS session caching."
 },
 {
 "textRaw": "`servername` {string} the value of [Server Name Indication extension][sni wiki] to be sent to the server. Use empty string `''` to disable sending the extension. **Default:** host name of the target server, unless the target server is specified using an IP address, in which case the default is `''` (no extension).See [`Session Resumption`][] for information about TLS session reuse.",
 "name": "servername",
 "type": "string",
 "default": "host name of the target server, unless the target server is specified using an IP address, in which case the default is `''` (no extension).See [`Session Resumption`][] for information about TLS session reuse",
 "desc": "the value of [Server Name Indication extension][sni wiki] to be sent to the server. Use empty string `''` to disable sending the extension."
 }
 ]
 }
 ]
 }
 ]
 },
 {
 "textRaw": "Class: `https.Server`",
 "type": "class",
 "name": "https.Server",
 "meta": {
 "added": [
 "v0.3.4"
 ],
 "changes": []
 },
 "desc": "<ul>\n<li>Extends: <a href=\"tls.html#tls_class_tls_server\" class=\"type\">&lt;tls.Server&gt;</a></li>\n</ul>\nSee <a href=\"http.html#http_class_http_server\"><code>http.Server</code></a> for more information.",
 "methods": [
 {
 "textRaw": "`server.close([callback])`",
 "type": "method",
 "name": "close",
 "meta": {
 "added": [
 "v0.1.90"
 ],
 "changes": []
 },
 "signatures": [
 {
 "return": {
 "textRaw": "Returns: {https.Server}",
 "name": "return",
 "type": "https.Server"
 },
 "params": [
 {
 "textRaw": "`callback` {Function}",
 "name": "callback",
 "type": "Function"
 }
 ]
 }
 ],
 "desc": "See <a href=\"http.html#http_server_close_callback\"><code>server.close()</code></a> from the HTTP module for details."
 },
 {
 "textRaw": "`server.listen()`",
 "type": "method",
 "name": "listen",
 "signatures": [
 {
 "params": []
 }
 ],
 "desc": "Starts the HTTPS server listening for encrypted connections.\nThis method is identical to <a href=\"net.html#net_server_listen\"><code>server.listen()</code></a> from <a href=\"net.html#net_class_net_server\"><code>net.Server</code></a>."
 },
 {
 "textRaw": "`server.setTimeout([msecs][, callback])`",
 "type": "method",
 "name": "setTimeout",
 "meta": {
 "added": [
 "v0.11.2"
 ],
 "changes": []
 },
 "signatures": [
 {
 "return": {
 "textRaw": "Returns: {https.Server}",
 "name": "return",
 "type": "https.Server"
 },
 "params": [
 {
 "textRaw": "`msecs` {number} **Default:** `120000` (2 minutes)",
 "name": "msecs",
 "type": "number",
 "default": "`120000` (2 minutes)"
 },
 {
 "textRaw": "`callback` {Function}",
 "name": "callback",
 "type": "Function"
 }
 ]
 }
 ],
 "desc": "See <a href=\"http.html#http_server_settimeout_msecs_callback\"><code>http.Server#setTimeout()</code></a>."
 }
 ],
 "properties": [
 {
 "textRaw": "`headersTimeout` {number} **Default:** `60000`",
 "type": "number",
 "name": "headersTimeout",
 "meta": {
 "added": [
 "v11.3.0"
 ],
 "changes": []
 },
 "default": "`60000`",
 "desc": "See <a href=\"http.html#http_server_headerstimeout\"><code>http.Server#headersTimeout</code></a>."
 },
 {
 "textRaw": "`maxHeadersCount` {number} **Default:** `2000`",
 "type": "number",
 "name": "maxHeadersCount",
 "default": "`2000`",
 "desc": "See <a href=\"http.html#http_server_maxheaderscount\"><code>http.Server#maxHeadersCount</code></a>."
 },
 {
 "textRaw": "`requestTimeout` {number} **Default:** `0`",
 "type": "number",
 "name": "requestTimeout",
 "meta": {
 "added": [
 "v14.11.0"
 ],
 "changes": []
 },
 "default": "`0`",
 "desc": "See <a href=\"http.html#http_server_requesttimeout\"><code>http.Server#requestTimeout</code></a>."
 },
 {
 "textRaw": "`timeout` {number} **Default:** 0 (no timeout)",
 "type": "number",
 "name": "timeout",
 "meta": {
 "added": [
 "v0.11.2"
 ],
 "changes": [
 {
 "version": "v13.0.0",
 "pr-url": "https://github.com/nodejs/node/pull/27558",
 "description": "The default timeout changed from 120s to 0 (no timeout)."
 }
 ]
 },
 "default": "0 (no timeout)",
 "desc": "See <a href=\"http.html#http_server_timeout\"><code>http.Server#timeout</code></a>."
 },
 {
 "textRaw": "`keepAliveTimeout` {number} **Default:** `5000` (5 seconds)",
 "type": "number",
 "name": "keepAliveTimeout",
 "meta": {
 "added": [
 "v8.0.0"
 ],
 "changes": []
 },
 "default": "`5000` (5 seconds)",
 "desc": "See <a href=\"http.html#http_server_keepalivetimeout\"><code>http.Server#keepAliveTimeout</code></a>."
 }
 ]
 }
 ],
 "methods": [
 {
 "textRaw": "`https.createServer([options][, requestListener])`",
 "type": "method",
 "name": "createServer",
 "meta": {
 "added": [
 "v0.3.4"
 ],
 "changes": []
 },
 "signatures": [
 {
 "return": {
 "textRaw": "Returns: {https.Server}",
 "name": "return",
 "type": "https.Server"
 },
 "params": [
 {
 "textRaw": "`options` {Object} Accepts `options` from [`tls.createServer()`][], [`tls.createSecureContext()`][] and [`http.createServer()`][].",
 "name": "options",
 "type": "Object",
 "desc": "Accepts `options` from [`tls.createServer()`][], [`tls.createSecureContext()`][] and [`http.createServer()`][]."
 },
 {
 "textRaw": "`requestListener` {Function} A listener to be added to the `'request'` event.",
 "name": "requestListener",
 "type": "Function",
 "desc": "A listener to be added to the `'request'` event."
 }
 ]
 }
 ],
 "desc": "<pre><code class=\"language-js\">// curl -k https://localhost:8000/\nconst https = require('https');\nconst fs = require('fs');\n\nconst options = {\n key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),\n cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem')\n};\n\nhttps.createServer(options, (req, res) => {\n res.writeHead(200);\n res.end('hello world\\n');\n}).listen(8000);\n</code></pre>\nOr\n<pre><code class=\"language-js\">const https = require('https');\nconst fs = require('fs');\n\nconst options = {\n pfx: fs.readFileSync('test/fixtures/test_cert.pfx'),\n passphrase: 'sample'\n};\n\nhttps.createServer(options, (req, res) => {\n res.writeHead(200);\n res.end('hello world\\n');\n}).listen(8000);\n</code></pre>"
 },
 {
 "textRaw": "`https.get(options[, callback])`",
 "type": "method",
 "name": "get",
 "meta": {
 "added": [
 "v0.3.6"
 ],
 "changes": [
 {
 "version": "v10.9.0",
 "pr-url": "https://github.com/nodejs/node/pull/21616",
 "description": "The `url` parameter can now be passed along with a separate `options` object."
 },
 {
 "version": "v7.5.0",
 "pr-url": "https://github.com/nodejs/node/pull/10638",
 "description": "The `options` parameter can be a WHATWG `URL` object."
 }
 ]
 },
 "signatures": [
 {
 "params": [
 {
 "textRaw": "`url` {string | URL}",
 "name": "url",
 "type": "string | URL"
 },
 {
 "textRaw": "`options` {Object | string | URL} Accepts the same `options` as [`https.request()`][], with the `method` always set to `GET`.",
 "name": "options",
 "type": "Object | string | URL",
 "desc": "Accepts the same `options` as [`https.request()`][], with the `method` always set to `GET`."
 },
 {
 "textRaw": "`callback` {Function}",
 "name": "callback",
 "type": "Function"
 }
 ]
 }
 ],
 "desc": "Like <a href=\"http.html#http_http_get_options_callback\"><code>http.get()</code></a> but for HTTPS.\n<code>options</code> can be an object, a string, or a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a> object. If <code>options</code> is a\nstring, it is automatically parsed with <a href=\"url.html#url_new_url_input_base\"><code>new URL()</code></a>. If it is a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a>\nobject, it will be automatically converted to an ordinary <code>options</code> object.\n<pre><code class=\"language-js\">const https = require('https');\n\nhttps.get('https://encrypted.google.com/', (res) => {\n console.log('statusCode:', res.statusCode);\n console.log('headers:', res.headers);\n\n res.on('data', (d) => {\n process.stdout.write(d);\n });\n\n}).on('error', (e) => {\n console.error(e);\n});\n</code></pre>"
 },
 {
 "textRaw": "`https.get(url[, options][, callback])`",
 "type": "method",
 "name": "get",
 "meta": {
 "added": [
 "v0.3.6"
 ],
 "changes": [
 {
 "version": "v10.9.0",
 "pr-url": "https://github.com/nodejs/node/pull/21616",
 "description": "The `url` parameter can now be passed along with a separate `options` object."
 },
 {
 "version": "v7.5.0",
 "pr-url": "https://github.com/nodejs/node/pull/10638",
 "description": "The `options` parameter can be a WHATWG `URL` object."
 }
 ]
 },
 "signatures": [
 {
 "params": [
 {
 "textRaw": "`url` {string | URL}",
 "name": "url",
 "type": "string | URL"
 },
 {
 "textRaw": "`options` {Object | string | URL} Accepts the same `options` as [`https.request()`][], with the `method` always set to `GET`.",
 "name": "options",
 "type": "Object | string | URL",
 "desc": "Accepts the same `options` as [`https.request()`][], with the `method` always set to `GET`."
 },
 {
 "textRaw": "`callback` {Function}",
 "name": "callback",
 "type": "Function"
 }
 ]
 }
 ],
 "desc": "Like <a href=\"http.html#http_http_get_options_callback\"><code>http.get()</code></a> but for HTTPS.\n<code>options</code> can be an object, a string, or a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a> object. If <code>options</code> is a\nstring, it is automatically parsed with <a href=\"url.html#url_new_url_input_base\"><code>new URL()</code></a>. If it is a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a>\nobject, it will be automatically converted to an ordinary <code>options</code> object.\n<pre><code class=\"language-js\">const https = require('https');\n\nhttps.get('https://encrypted.google.com/', (res) => {\n console.log('statusCode:', res.statusCode);\n console.log('headers:', res.headers);\n\n res.on('data', (d) => {\n process.stdout.write(d);\n });\n\n}).on('error', (e) => {\n console.error(e);\n});\n</code></pre>"
 },
 {
 "textRaw": "`https.request(options[, callback])`",
 "type": "method",
 "name": "request",
 "meta": {
 "added": [
 "v0.3.6"
 ],
 "changes": [
 {
 "version": "v14.18.0",
 "pr-url": "https://github.com/nodejs/node/pull/39310",
 "description": "When using a `URL` object parsed username and password will now be properly URI decoded."
 },
 {
 "version": "v14.1.0",
 "pr-url": "https://github.com/nodejs/node/pull/32786",
 "description": "The `highWaterMark` option is accepted now."
 },
 {
 "version": "v10.9.0",
 "pr-url": "https://github.com/nodejs/node/pull/21616",
 "description": "The `url` parameter can now be passed along with a separate `options` object."
 },
 {
 "version": "v9.3.0",
 "pr-url": "https://github.com/nodejs/node/pull/14903",
 "description": "The `options` parameter can now include `clientCertEngine`."
 },
 {
 "version": "v7.5.0",
 "pr-url": "https://github.com/nodejs/node/pull/10638",
 "description": "The `options` parameter can be a WHATWG `URL` object."
 }
 ]
 },
 "signatures": [
 {
 "return": {
 "textRaw": "Returns: {http.ClientRequest}",
 "name": "return",
 "type": "http.ClientRequest"
 },
 "params": [
 {
 "textRaw": "`url` {string | URL}",
 "name": "url",
 "type": "string | URL"
 },
 {
 "textRaw": "`options` {Object | string | URL} Accepts all `options` from [`http.request()`][], with some differences in default values:",
 "name": "options",
 "type": "Object | string | URL",
 "desc": "Accepts all `options` from [`http.request()`][], with some differences in default values:",
 "options": [
 {
 "textRaw": "`protocol` **Default:** `'https:'`",
 "name": "protocol",
 "default": "`'https:'`"
 },
 {
 "textRaw": "`port` **Default:** `443`",
 "name": "port",
 "default": "`443`"
 },
 {
 "textRaw": "`agent` **Default:** `https.globalAgent`",
 "name": "agent",
 "default": "`https.globalAgent`"
 }
 ]
 },
 {
 "textRaw": "`callback` {Function}",
 "name": "callback",
 "type": "Function"
 }
 ]
 }
 ],
 "desc": "Makes a request to a secure web server.\nThe following additional <code>options</code> from <a href=\"tls.html#tls_tls_connect_options_callback\"><code>tls.connect()</code></a> are also accepted:\n<code>ca</code>, <code>cert</code>, <code>ciphers</code>, <code>clientCertEngine</code>, <code>crl</code>, <code>dhparam</code>, <code>ecdhCurve</code>,\n<code>honorCipherOrder</code>, <code>key</code>, <code>passphrase</code>, <code>pfx</code>, <code>rejectUnauthorized</code>,\n<code>secureOptions</code>, <code>secureProtocol</code>, <code>servername</code>, <code>sessionIdContext</code>,\n<code>highWaterMark</code>.\n<code>options</code> can be an object, a string, or a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a> object. If <code>options</code> is a\nstring, it is automatically parsed with <a href=\"url.html#url_new_url_input_base\"><code>new URL()</code></a>. If it is a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a>\nobject, it will be automatically converted to an ordinary <code>options</code> object.\n<code>https.request()</code> returns an instance of the <a href=\"http.html#http_class_http_clientrequest\"><code>http.ClientRequest</code></a>\nclass. The <code>ClientRequest</code> instance is a writable stream. If one needs to\nupload a file with a POST request, then write to the <code>ClientRequest</code> object.\n<pre><code class=\"language-js\">const https = require('https');\n\nconst options = {\n hostname: 'encrypted.google.com',\n port: 443,\n path: '/',\n method: 'GET'\n};\n\nconst req = https.request(options, (res) => {\n console.log('statusCode:', res.statusCode);\n console.log('headers:', res.headers);\n\n res.on('data', (d) => {\n process.stdout.write(d);\n });\n});\n\nreq.on('error', (e) => {\n console.error(e);\n});\nreq.end();\n</code></pre>\nExample using options from <a href=\"tls.html#tls_tls_connect_options_callback\"><code>tls.connect()</code></a>:\n<pre><code class=\"language-js\">const options = {\n hostname: 'encrypted.google.com',\n port: 443,\n path: '/',\n method: 'GET',\n key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),\n cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem')\n};\noptions.agent = new https.Agent(options);\n\nconst req = https.request(options, (res) => {\n // ...\n});\n</code></pre>\nAlternatively, opt out of connection pooling by not using an <a href=\"#https_class_https_agent\"><code>Agent</code></a>.\n<pre><code class=\"language-js\">const options = {\n hostname: 'encrypted.google.com',\n port: 443,\n path: '/',\n method: 'GET',\n key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),\n cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem'),\n agent: false\n};\n\nconst req = https.request(options, (res) => {\n // ...\n});\n</code></pre>\nExample using a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a> as <code>options</code>:\n<pre><code class=\"language-js\">const options = new URL('https://abc:xyz@example.com');\n\nconst req = https.request(options, (res) => {\n // ...\n});\n</code></pre>\nExample pinning on certificate fingerprint, or the public key (similar to\n<code>pin-sha256</code>):\n<pre><code class=\"language-js\">const tls = require('tls');\nconst https = require('https');\nconst crypto = require('crypto');\n\nfunction sha256(s) {\n return crypto.createHash('sha256').update(s).digest('base64');\n}\nconst options = {\n hostname: 'github.com',\n port: 443,\n path: '/',\n method: 'GET',\n checkServerIdentity: function(host, cert) {\n // Make sure the certificate is issued to the host we are connected to\n const err = tls.checkServerIdentity(host, cert);\n if (err) {\n return err;\n }\n\n // Pin the public key, similar to HPKP pin-sha25 pinning\n const pubkey256 = 'pL1+qb9HTMRZJmuC/bB/ZI9d302BYrrqiVuRyW+DGrU=';\n if (sha256(cert.pubkey) !== pubkey256) {\n const msg = 'Certificate verification error: ' +\n `The public key of '${cert.subject.CN}' ` +\n 'does not match our pinned fingerprint';\n return new Error(msg);\n }\n\n // Pin the exact certificate, rather than the pub key\n const cert256 = '25:FE:39:32:D9:63:8C:8A:FC:A1:9A:29:87:' +\n 'D8:3E:4C:1D:98:DB:71:E4:1A:48:03:98:EA:22:6A:BD:8B:93:16';\n if (cert.fingerprint256 !== cert256) {\n const msg = 'Certificate verification error: ' +\n `The certificate of '${cert.subject.CN}' ` +\n 'does not match our pinned fingerprint';\n return new Error(msg);\n }\n\n // This loop is informational only.\n // Print the certificate and public key fingerprints of all certs in the\n // chain. Its common to pin the public key of the issuer on the public\n // internet, while pinning the public key of the service in sensitive\n // environments.\n do {\n console.log('Subject Common Name:', cert.subject.CN);\n console.log(' Certificate SHA256 fingerprint:', cert.fingerprint256);\n\n hash = crypto.createHash('sha256');\n console.log(' Public key ping-sha256:', sha256(cert.pubkey));\n\n lastprint256 = cert.fingerprint256;\n cert = cert.issuerCertificate;\n } while (cert.fingerprint256 !== lastprint256);\n\n },\n};\n\noptions.agent = new https.Agent(options);\nconst req = https.request(options, (res) => {\n console.log('All OK. Server matched our pinned cert or public key');\n console.log('statusCode:', res.statusCode);\n // Print the HPKP values\n console.log('headers:', res.headers['public-key-pins']);\n\n res.on('data', (d) => {});\n});\n\nreq.on('error', (e) => {\n console.error(e.message);\n});\nreq.end();\n</code></pre>\nOutputs for example:\n<pre><code class=\"language-text\">Subject Common Name: github.com\n Certificate SHA256 fingerprint: 25:FE:39:32:D9:63:8C:8A:FC:A1:9A:29:87:D8:3E:4C:1D:98:DB:71:E4:1A:48:03:98:EA:22:6A:BD:8B:93:16\n Public key ping-sha256: pL1+qb9HTMRZJmuC/bB/ZI9d302BYrrqiVuRyW+DGrU=\nSubject Common Name: DigiCert SHA2 Extended Validation Server CA\n Certificate SHA256 fingerprint: 40:3E:06:2A:26:53:05:91:13:28:5B:AF:80:A0:D4:AE:42:2C:84:8C:9F:78:FA:D0:1F:C9:4B:C5:B8:7F:EF:1A\n Public key ping-sha256: RRM1dGqnDFsCJXBTHky16vi1obOlCgFFn/yOhI/y+ho=\nSubject Common Name: DigiCert High Assurance EV Root CA\n Certificate SHA256 fingerprint: 74:31:E5:F4:C3:C1:CE:46:90:77:4F:0B:61:E0:54:40:88:3B:A9:A0:1E:D0:0B:A6:AB:D7:80:6E:D3:B1:18:CF\n Public key ping-sha256: WoiWRyIOVNa9ihaBciRSC7XHjliYS9VwUGOIud4PB18=\nAll OK. Server matched our pinned cert or public key\nstatusCode: 200\nheaders: max-age=0; pin-sha256=\"WoiWRyIOVNa9ihaBciRSC7XHjliYS9VwUGOIud4PB18=\"; pin-sha256=\"RRM1dGqnDFsCJXBTHky16vi1obOlCgFFn/yOhI/y+ho=\"; pin-sha256=\"k2v657xBsOVe1PQRwOsHsw3bsGT2VzIqz5K+59sNQws=\"; pin-sha256=\"K87oWBWM9UZfyddvDfoxL+8lpNyoUB2ptGtn0fv6G2Q=\"; pin-sha256=\"IQBnNBEiFuhj+8x6X8XLgh01V9Ic5/V3IRQLNFFc7v4=\"; pin-sha256=\"iie1VXtL7HzAMF+/PVPR9xzT80kQxdZeJ+zduCB3uj0=\"; pin-sha256=\"LvRiGEjRqfzurezaWuj8Wie2gyHMrW5Q06LspMnox7A=\"; includeSubDomains\n</code></pre>"
 },
 {
 "textRaw": "`https.request(url[, options][, callback])`",
 "type": "method",
 "name": "request",
 "meta": {
 "added": [
 "v0.3.6"
 ],
 "changes": [
 {
 "version": "v14.18.0",
 "pr-url": "https://github.com/nodejs/node/pull/39310",
 "description": "When using a `URL` object parsed username and password will now be properly URI decoded."
 },
 {
 "version": "v14.1.0",
 "pr-url": "https://github.com/nodejs/node/pull/32786",
 "description": "The `highWaterMark` option is accepted now."
 },
 {
 "version": "v10.9.0",
 "pr-url": "https://github.com/nodejs/node/pull/21616",
 "description": "The `url` parameter can now be passed along with a separate `options` object."
 },
 {
 "version": "v9.3.0",
 "pr-url": "https://github.com/nodejs/node/pull/14903",
 "description": "The `options` parameter can now include `clientCertEngine`."
 },
 {
 "version": "v7.5.0",
 "pr-url": "https://github.com/nodejs/node/pull/10638",
 "description": "The `options` parameter can be a WHATWG `URL` object."
 }
 ]
 },
 "signatures": [
 {
 "return": {
 "textRaw": "Returns: {http.ClientRequest}",
 "name": "return",
 "type": "http.ClientRequest"
 },
 "params": [
 {
 "textRaw": "`url` {string | URL}",
 "name": "url",
 "type": "string | URL"
 },
 {
 "textRaw": "`options` {Object | string | URL} Accepts all `options` from [`http.request()`][], with some differences in default values:",
 "name": "options",
 "type": "Object | string | URL",
 "desc": "Accepts all `options` from [`http.request()`][], with some differences in default values:",
 "options": [
 {
 "textRaw": "`protocol` **Default:** `'https:'`",
 "name": "protocol",
 "default": "`'https:'`"
 },
 {
 "textRaw": "`port` **Default:** `443`",
 "name": "port",
 "default": "`443`"
 },
 {
 "textRaw": "`agent` **Default:** `https.globalAgent`",
 "name": "agent",
 "default": "`https.globalAgent`"
 }
 ]
 },
 {
 "textRaw": "`callback` {Function}",
 "name": "callback",
 "type": "Function"
 }
 ]
 }
 ],
 "desc": "Makes a request to a secure web server.\nThe following additional <code>options</code> from <a href=\"tls.html#tls_tls_connect_options_callback\"><code>tls.connect()</code></a> are also accepted:\n<code>ca</code>, <code>cert</code>, <code>ciphers</code>, <code>clientCertEngine</code>, <code>crl</code>, <code>dhparam</code>, <code>ecdhCurve</code>,\n<code>honorCipherOrder</code>, <code>key</code>, <code>passphrase</code>, <code>pfx</code>, <code>rejectUnauthorized</code>,\n<code>secureOptions</code>, <code>secureProtocol</code>, <code>servername</code>, <code>sessionIdContext</code>,\n<code>highWaterMark</code>.\n<code>options</code> can be an object, a string, or a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a> object. If <code>options</code> is a\nstring, it is automatically parsed with <a href=\"url.html#url_new_url_input_base\"><code>new URL()</code></a>. If it is a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a>\nobject, it will be automatically converted to an ordinary <code>options</code> object.\n<code>https.request()</code> returns an instance of the <a href=\"http.html#http_class_http_clientrequest\"><code>http.ClientRequest</code></a>\nclass. The <code>ClientRequest</code> instance is a writable stream. If one needs to\nupload a file with a POST request, then write to the <code>ClientRequest</code> object.\n<pre><code class=\"language-js\">const https = require('https');\n\nconst options = {\n hostname: 'encrypted.google.com',\n port: 443,\n path: '/',\n method: 'GET'\n};\n\nconst req = https.request(options, (res) => {\n console.log('statusCode:', res.statusCode);\n console.log('headers:', res.headers);\n\n res.on('data', (d) => {\n process.stdout.write(d);\n });\n});\n\nreq.on('error', (e) => {\n console.error(e);\n});\nreq.end();\n</code></pre>\nExample using options from <a href=\"tls.html#tls_tls_connect_options_callback\"><code>tls.connect()</code></a>:\n<pre><code class=\"language-js\">const options = {\n hostname: 'encrypted.google.com',\n port: 443,\n path: '/',\n method: 'GET',\n key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),\n cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem')\n};\noptions.agent = new https.Agent(options);\n\nconst req = https.request(options, (res) => {\n // ...\n});\n</code></pre>\nAlternatively, opt out of connection pooling by not using an <a href=\"#https_class_https_agent\"><code>Agent</code></a>.\n<pre><code class=\"language-js\">const options = {\n hostname: 'encrypted.google.com',\n port: 443,\n path: '/',\n method: 'GET',\n key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),\n cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem'),\n agent: false\n};\n\nconst req = https.request(options, (res) => {\n // ...\n});\n</code></pre>\nExample using a <a href=\"url.html#url_the_whatwg_url_api\"><code>URL</code></a> as <code>options</code>:\n<pre><code class=\"language-js\">const options = new URL('https://abc:xyz@example.com');\n\nconst req = https.request(options, (res) => {\n // ...\n});\n</code></pre>\nExample pinning on certificate fingerprint, or the public key (similar to\n<code>pin-sha256</code>):\n<pre><code class=\"language-js\">const tls = require('tls');\nconst https = require('https');\nconst crypto = require('crypto');\n\nfunction sha256(s) {\n return crypto.createHash('sha256').update(s).digest('base64');\n}\nconst options = {\n hostname: 'github.com',\n port: 443,\n path: '/',\n method: 'GET',\n checkServerIdentity: function(host, cert) {\n // Make sure the certificate is issued to the host we are connected to\n const err = tls.checkServerIdentity(host, cert);\n if (err) {\n return err;\n }\n\n // Pin the public key, similar to HPKP pin-sha25 pinning\n const pubkey256 = 'pL1+qb9HTMRZJmuC/bB/ZI9d302BYrrqiVuRyW+DGrU=';\n if (sha256(cert.pubkey) !== pubkey256) {\n const msg = 'Certificate verification error: ' +\n `The public key of '${cert.subject.CN}' ` +\n 'does not match our pinned fingerprint';\n return new Error(msg);\n }\n\n // Pin the exact certificate, rather than the pub key\n const cert256 = '25:FE:39:32:D9:63:8C:8A:FC:A1:9A:29:87:' +\n 'D8:3E:4C:1D:98:DB:71:E4:1A:48:03:98:EA:22:6A:BD:8B:93:16';\n if (cert.fingerprint256 !== cert256) {\n const msg = 'Certificate verification error: ' +\n `The certificate of '${cert.subject.CN}' ` +\n 'does not match our pinned fingerprint';\n return new Error(msg);\n }\n\n // This loop is informational only.\n // Print the certificate and public key fingerprints of all certs in the\n // chain. Its common to pin the public key of the issuer on the public\n // internet, while pinning the public key of the service in sensitive\n // environments.\n do {\n console.log('Subject Common Name:', cert.subject.CN);\n console.log(' Certificate SHA256 fingerprint:', cert.fingerprint256);\n\n hash = crypto.createHash('sha256');\n console.log(' Public key ping-sha256:', sha256(cert.pubkey));\n\n lastprint256 = cert.fingerprint256;\n cert = cert.issuerCertificate;\n } while (cert.fingerprint256 !== lastprint256);\n\n },\n};\n\noptions.agent = new https.Agent(options);\nconst req = https.request(options, (res) => {\n console.log('All OK. Server matched our pinned cert or public key');\n console.log('statusCode:', res.statusCode);\n // Print the HPKP values\n console.log('headers:', res.headers['public-key-pins']);\n\n res.on('data', (d) => {});\n});\n\nreq.on('error', (e) => {\n console.error(e.message);\n});\nreq.end();\n</code></pre>\nOutputs for example:\n<pre><code class=\"language-text\">Subject Common Name: github.com\n Certificate SHA256 fingerprint: 25:FE:39:32:D9:63:8C:8A:FC:A1:9A:29:87:D8:3E:4C:1D:98:DB:71:E4:1A:48:03:98:EA:22:6A:BD:8B:93:16\n Public key ping-sha256: pL1+qb9HTMRZJmuC/bB/ZI9d302BYrrqiVuRyW+DGrU=\nSubject Common Name: DigiCert SHA2 Extended Validation Server CA\n Certificate SHA256 fingerprint: 40:3E:06:2A:26:53:05:91:13:28:5B:AF:80:A0:D4:AE:42:2C:84:8C:9F:78:FA:D0:1F:C9:4B:C5:B8:7F:EF:1A\n Public key ping-sha256: RRM1dGqnDFsCJXBTHky16vi1obOlCgFFn/yOhI/y+ho=\nSubject Common Name: DigiCert High Assurance EV Root CA\n Certificate SHA256 fingerprint: 74:31:E5:F4:C3:C1:CE:46:90:77:4F:0B:61:E0:54:40:88:3B:A9:A0:1E:D0:0B:A6:AB:D7:80:6E:D3:B1:18:CF\n Public key ping-sha256: WoiWRyIOVNa9ihaBciRSC7XHjliYS9VwUGOIud4PB18=\nAll OK. Server matched our pinned cert or public key\nstatusCode: 200\nheaders: max-age=0; pin-sha256=\"WoiWRyIOVNa9ihaBciRSC7XHjliYS9VwUGOIud4PB18=\"; pin-sha256=\"RRM1dGqnDFsCJXBTHky16vi1obOlCgFFn/yOhI/y+ho=\"; pin-sha256=\"k2v657xBsOVe1PQRwOsHsw3bsGT2VzIqz5K+59sNQws=\"; pin-sha256=\"K87oWBWM9UZfyddvDfoxL+8lpNyoUB2ptGtn0fv6G2Q=\"; pin-sha256=\"IQBnNBEiFuhj+8x6X8XLgh01V9Ic5/V3IRQLNFFc7v4=\"; pin-sha256=\"iie1VXtL7HzAMF+/PVPR9xzT80kQxdZeJ+zduCB3uj0=\"; pin-sha256=\"LvRiGEjRqfzurezaWuj8Wie2gyHMrW5Q06LspMnox7A=\"; includeSubDomains\n</code></pre>"
 }
 ],
 "properties": [
 {
 "textRaw": "`https.globalAgent`",
 "name": "globalAgent",
 "meta": {
 "added": [
 "v0.5.9"
 ],
 "changes": []
 },
 "desc": "Global instance of <a href=\"#https_class_https_agent\"><code>https.Agent</code></a> for all HTTPS client requests."
 }
 ],
 "type": "module",
 "displayName": "HTTPS"
 }
 ]
}