SecureBlackbox 2020 Node.js Edition

Questions / Feedback?

KeepAlivePolicy Property

Defines the keep-alive handling policy.

Syntax

 httpclient.getKeepAlivePolicy([callback])
 httpclient.setKeepAlivePolicy( keepAlivePolicy, [callback])

Possible Values

  0 (ckapStandardDefined), 
  1 (ckapPreferKeepAlive), 
  2 (ckapRelyOnServer), 
  3 (ckapKeepAlivesDisabled)

Default Value

0

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getKeepAlivePolicy([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setKeepAlivePolicy([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

Use this property to tune-up the keep-alive mechanism as per the needs of your application.

ckapStandardDefined0Follow the standard
ckapPreferKeepAlive1Always request a keep-alive connection
ckapRelyOnServer2Not include the "Connection" header, allowing the server to choose the keep-alive mode
ckapKeepAlivesDisabled3Disable keep-alives by including the "Connection: Close" header

Data Type

Integer

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox 2020 Node.js Edition - Version 20.0 [Build 8165]