APIs

Show:
Extends EventEmitter
Module: opcua.client

Constructor

OPCUAClientBase

(
  • options
)

Parameters:

  • options Object
    • defaultSecureTokenLifetime Number

      default secure token lifetime in ms

    • [securityMode=MessageSecurityMode.None] MessageSecurityMode optional

      the default security mode.

    • [securityPolicy=SecurityPolicy.NONE] SecurityPolicy optional

      the security mode.

    • [serverCertificate=null] Certificate optional

      the server certificate.

    • [certificateFile="certificates/client_selfsigned_cert_1024.pem"] String optional

      client certificate pem file.

    • [privateKeyFile="certificates/client_key_1024.pem"] String optional

      client private key pem file.

    • [connectionStrategy] Object optional
    • [keepSessionAlive=false] Boolean optional
    • [tokenRenewalInterval=0] Number optional

      if not specify or set to 0 , token renewal will happen around 75% of the defaultSecureTokenLifetime

    • [keepPendingSessionsOnDisconnect=false] optional

      if set to true, pending session will not be automatically closed * when disconnect is called

    • [clientName=""] optional

      the client Name

Methods

connect

(
  • endpointUrl
  • callback
)
async

connect the OPC-UA client to a server end point.

Parameters:

  • endpointUrl String
  • callback Function

connect

(
  • endpointUrl
)
Promise async

Parameters:

  • endpointUrl String

Returns:

Promise:

disconnect

(
  • callback
)
async

disconnect client from server

Parameters:

  • callback Object

    [Function}

findEndpoint

() EndPoint

return the endpoint information matching security mode and security policy.

Returns:

EndPoint:

findEndpoint

() EndPoint

return the endpoint information matching the specified url , security mode and security policy.

Returns:

EndPoint:

findServers

(
  • callback
)
async

send a FindServers request to a discovery server

Parameters:

  • callback Object

    [Function}

findServers

(
  • options
  • callback
)

Parameters:

  • options Object
    • [endpointUrl] optional
    • [localeIds] optional

      Array

    • [serverUris] optional

      Array

  • callback Object

getEndpoints

(
  • [options]
  • [options.localeIds}
  • [options.profileUris}
  • callback
)
async

Parameters:

  • [options] Object optional
    • [endpointUrl] String optional

      the network address that the Client used to access the Discovery Endpoint .

  • [options.localeIds} Array

    List of locales to use.

  • [options.profileUris} Array

    List of transport profiles that the returned Endpoints shall support.

  • callback Function
    • err Error | Null
    • serverEndpoints Array

      the array of endpoint descriptions

perform_findServers

(
  • discovery_server_endpointUrl
  • callback
)
async

extract the server endpoints exposed by a discovery server

Parameters:

  • discovery_server_endpointUrl Object
  • callback Object

perform_findServers

(
  • discovery_server_endpointUrl
  • callback
)
async

extract the server endpoints exposed by a discovery server

Parameters:

  • discovery_server_endpointUrl Object
  • callback Object

Properties

bytesRead

Number

total number of bytes read by the client

bytesWritten

Number

total number of bytes written by the client

connectionStrategy

options.connectionStrategy | MaxRetry, initialDelay, maxDelay, randomisationFactor | | MaxRetry: number, initialDelay: number, maxDelay: number, randomisationFactor: number

isReconnecting

Boolean true if the client is trying to reconnect to the server after a connection break.

keepPendingSessionsOnDisconnect²

Boolean

keepSessionAlive

Boolean

true if session shall periodically probe the server to keep the session alive and prevent timeout

knowsServerEndpoint

Boolean

is true when the client has already requested the server end points.

reconnectOnFailure

Boolean

true if the connection strategy is set to automatically try to reconnect in case of failure

securityMode

MessageSecurityMode

serverCertificate

Certificate

transactionsPerformed

Number

total number of transactions performed by the client

Events

after_reconnection

notify the observers that the reconnection process has been completed

Event Payload:

  • err Object

close

Event Payload:

  • error Error

connection_reestablished send when the connection is reestablished after a connection break

receive_chunk

notify the observer that a message_chunk has been received

Event Payload:

  • message_chunk Object

receive_response

notify the observer that a response has been received from the server.

Event Payload:

  • message Object

send_chunk

notify the observer that a message_chunk has been sent

Event Payload:

  • message_chunk Object

send_request

notify the observer that a request has been sent to the server.

Event Payload:

  • message Object

start_reconnection

notifies the observer that the OPCUA is now trying to reestablish the connection after having received a connection break...

timed_out_request

send when a request has timed out without receiving a response

Event Payload:

  • request Object