Skip to content

Commit 6aa0dac

Browse files
lpincaMylesBorins
authored andcommitted
doc: clarify that the ctx argument is optional
Clarify that the `ctx` argument of the `SNICallback` callback is optional. Fixes: #34085 PR-URL: #34097 Reviewed-By: Ujjwal Sharma <[email protected]> Reviewed-By: Tobias Nießen <[email protected]> Reviewed-By: Trivikram Kamat <[email protected]> Reviewed-By: James M Snell <[email protected]>
1 parent 1558800 commit 6aa0dac

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

doc/api/tls.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1704,12 +1704,15 @@ changes:
17041704
* `sessionTimeout` {number} The number of seconds after which a TLS session
17051705
created by the server will no longer be resumable. See
17061706
[Session Resumption][] for more information. **Default:** `300`.
1707-
* `SNICallback(servername, cb)` {Function} A function that will be called if
1708-
the client supports SNI TLS extension. Two arguments will be passed when
1709-
called: `servername` and `cb`. `SNICallback` should invoke `cb(null, ctx)`,
1710-
where `ctx` is a `SecureContext` instance. (`tls.createSecureContext(...)`
1711-
can be used to get a proper `SecureContext`.) If `SNICallback` wasn't
1712-
provided the default callback with high-level API will be used (see below).
1707+
* `SNICallback(servername, callback)` {Function} A function that will be
1708+
called if the client supports SNI TLS extension. Two arguments will be
1709+
passed when called: `servername` and `callback`. `callback` is an
1710+
error-first callback that takes two optional arguments: `error` and `ctx`.
1711+
`ctx`, if provided, is a `SecureContext` instance.
1712+
[`tls.createSecureContext()`][] can be used to get a proper `SecureContext`.
1713+
If `callback` is called with a falsy `ctx` argument, the default secure
1714+
context of the server will be used. If `SNICallback` wasn't provided the
1715+
default callback with high-level API will be used (see below).
17131716
* `ticketKeys`: {Buffer} 48-bytes of cryptographically strong pseudo-random
17141717
data. See [Session Resumption][] for more information.
17151718
* `pskCallback` {Function}

0 commit comments

Comments
 (0)