ClientSubscription | NodeOPCUA reference documentation

Hierarchy

EventEmitter
- ClientSubscription

Index

Constructors

constructor

Events

Properties

Constructors

constructor

new ClientSubscription(): ClientSubscription

Returns ClientSubscription

Events

on

on(event: string | symbol, listener: (...args: any[]) => void): ClientSubscription
on(event: "started", eventHandler: (subscriptionId: number) => void): ClientSubscription
on(event: "terminated", eventHandler: () => void): ClientSubscription
on(event: "item_added", eventHandler: (monitoredItem: ClientMonitoredItem) => void): ClientSubscription
on(event: "keepalive", eventHandler: () => void): ClientSubscription
on(event: "internal_error", eventHandler: (err: Error) => void): ClientSubscription
on(event: "raw_notification", eventHandler: (notificationMessage: NotificationMessage) => void): ClientSubscription
on(event: "received_notifications", eventHandler: (notificationMessage: NotificationMessage) => void): ClientSubscription
on(event: "status_changed", eventHandler: (status: StatusCode, diagnosticInfo: DiagnosticInfo) => void): ClientSubscription
on(event: "error", eventHandler: (err: Error) => void): ClientSubscription

- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:176
Parameters
- event: string | symbol
- listener: (...args: any[]) => void
  - - (...args: any[]): void
    - Parameters
      - Rest ...args: any[]
      Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:181
notify the observers that the subscription has now started

Parameters
- event: "started"
- eventHandler: (subscriptionId: number) => void
  - - (subscriptionId: number): void
    - Parameters
      - subscriptionId: number
      Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:186
notify the observers tha the client subscription has terminated

Parameters
- event: "terminated"
- eventHandler: () => void
  - - (): void
    - Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:191
notify the observers that a new monitored item has been added to the subscription.

Parameters
- event: "item_added"
- eventHandler: (monitoredItem: ClientMonitoredItem) => void
  - - (monitoredItem: ClientMonitoredItem): void
    - Parameters
      - monitoredItem: ClientMonitoredItem
      Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:196
notify the observers that a keep alive Publish Response has been received from the server.

Parameters
- event: "keepalive"
- eventHandler: () => void
  - - (): void
    - Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:203
notify the observers that an error has occurred

Parameters
- event: "internal_error"
- eventHandler: (err: Error) => void
  - - (err: Error): void
    - Parameters
      - err: Error
      Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:204
Parameters
- event: "raw_notification"
- eventHandler: (notificationMessage: NotificationMessage) => void
  - - (notificationMessage: NotificationMessage): void
    - Parameters
      - notificationMessage: NotificationMessage
      Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:210
notify the observers that some notifications has been received from the server in a PublishResponse each modified monitored Item

Parameters
- event: "received_notifications"
- eventHandler: (notificationMessage: NotificationMessage) => void
  - - (notificationMessage: NotificationMessage): void
    - Parameters
      - notificationMessage: NotificationMessage
      Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:215
notify the observers that the server has send a status changed notification (such as BadTimeout )

Parameters
- event: "status_changed"
- eventHandler: (status: StatusCode, diagnosticInfo: DiagnosticInfo) => void
  - - (status: StatusCode, diagnosticInfo: DiagnosticInfo): void
    - Parameters
      - status: StatusCode
      - diagnosticInfo: DiagnosticInfo
      Returns void
Returns ClientSubscription
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:216
Parameters
- event: "error"
- eventHandler: (err: Error) => void
  - - (err: Error): void
    - Parameters
      - err: Error
      Returns void
Returns ClientSubscription

Properties

hasSession

hasSession: boolean

return true if the subscription is attached to a valid session

isActive

isActive: boolean

true is the subscription is fully active

lifetimeCount

lifetimeCount: number

maxKeepAliveCount

maxKeepAliveCount: number

maxNotificationsPerPublish

maxNotificationsPerPublish: number

monitoredItems

monitoredItems: ClientMonitoredItemBaseMap

priority

priority: number

publishingEnabled

publishingEnabled: boolean

publishingInterval

publishingInterval: number

session

session: ClientSession

return the session associated with the subscription. (may throw if the session is not valid)

subscriptionId

subscriptionId: number

timeoutHint

timeoutHint: number

Static ignoreNextWarning

ignoreNextWarning: boolean

Methods

_createMonitoredItem

_createMonitoredItem(itemToMonitor: ReadValueIdOptions, monitoringParameters: MonitoringParametersOptions, timestampsToReturn: TimestampsToReturn): ClientMonitoredItem

- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:219
Parameters
- itemToMonitor: ReadValueIdOptions
- monitoringParameters: MonitoringParametersOptions
- timestampsToReturn: TimestampsToReturn
Returns ClientMonitoredItem

addListener

addListener(event: string | symbol, listener: (...args: any[]) => void): ClientSubscription

- Defined in node_modules/@types/node/events.d.ts:62
Parameters
- event: string | symbol
- listener: (...args: any[]) => void
  - - (...args: any[]): void
    - Parameters
      - Rest ...args: any[]
      Returns void
Returns ClientSubscription

emit

emit(event: string | symbol, ...args: any[]): boolean

- Defined in node_modules/@types/node/events.d.ts:72
Parameters
- event: string | symbol
- Rest ...args: any[]
Returns boolean

eventNames

eventNames(): (string | symbol)[]

- Defined in node_modules/@types/node/events.d.ts:77
Returns (string | symbol)[]

getMaxListeners

getMaxListeners(): number

- Defined in node_modules/@types/node/events.d.ts:69
Returns number

getMonitoredItems

getMonitoredItems(): Promise<MonitoredItemData>
getMonitoredItems(callback: (err: Error, result?: MonitoredItemData) => void): void

- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:169
Returns Promise<MonitoredItemData>
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:170
Parameters
- callback: (err: Error, result?: MonitoredItemData) => void
  - - (err: Error, result?: MonitoredItemData): void
    - Parameters
      - err: Error
      - Optional result: MonitoredItemData
      Returns void
Returns void

listenerCount

listenerCount(event: string | symbol): number

- Defined in node_modules/@types/node/events.d.ts:73
Parameters
- event: string | symbol
Returns number

listeners

listeners(event: string | symbol): Function[]

- Defined in node_modules/@types/node/events.d.ts:70
Parameters
- event: string | symbol
Returns Function[]

monitor

monitor(itemToMonitor: ReadValueIdOptions, requestedParameters: MonitoringParametersOptions, timestampsToReturn: TimestampsToReturn): Promise<ClientMonitoredItem>
monitor(itemToMonitor: ReadValueIdOptions, requestedParameters: MonitoringParametersOptions, timestampsToReturn: TimestampsToReturn, done: (err: Error, monitoredItem?: ClientMonitoredItem) => void): void

- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:149
add a monitor item to the subscription
method

monitor

Monitoring a simple Value Change

example:

clientSubscription.monitor( // itemToMonitor: { nodeId: "ns=0;i=2258", attributeId: AttributeIds.Value, indexRange: null, dataEncoding: { namespaceIndex: 0, name: null } }, // requestedParameters: { samplingInterval: 3000, filter: null, queueSize: 1, discardOldest: true }, TimestampsToReturn.Neither );

Monitoring a Value Change With a DataChange Filter

options.trigger {DataChangeTrigger} {Status|StatusValue|StatusValueTimestamp} options.deadbandType {DeadbandType} {None|Absolute|Percent} options.deadbandValue {Double}

example:

clientSubscription.monitor( // itemToMonitor: { nodeId: "ns=0;i=2258", attributeId: AttributeIds.Value, }, // requestedParameters: { samplingInterval: 3000, filter: new DataChangeFilter({ trigger: DataChangeTrigger.StatusValue, deadbandType: DeadbandType.Absolute, deadbandValue: 0.1 }), queueSize: 1, discardOldest: true }, TimestampsToReturn.Neither );

Monitoring an Event

If the monitor attributeId is EventNotifier then the filter must be specified

example:
var filter = new EventFilter({ selectClauses: [ { browsePath: [ {name: 'ActiveState' }, {name: 'id'} ]}, { browsePath: [ {name: 'ConditionName'} ]} ], whereClause: [] });

clientSubscription.monitor( // itemToMonitor: { nodeId: "ns=0;i=2258", attributeId: AttributeIds.EventNotifier, indexRange: null, dataEncoding: { namespaceIndex: 0, name: null } }, // requestedParameters: { samplingInterval: 3000,
```
   filter: filter,

   queueSize: 1,
   discardOldest: true
},
TimestampsToReturn.Neither
```
);
Parameters
- itemToMonitor: ReadValueIdOptions
- requestedParameters: MonitoringParametersOptions
- timestampsToReturn: TimestampsToReturn
Returns Promise<ClientMonitoredItem>
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:150
Parameters
- itemToMonitor: ReadValueIdOptions
- requestedParameters: MonitoringParametersOptions
- timestampsToReturn: TimestampsToReturn
- done: (err: Error, monitoredItem?: ClientMonitoredItem) => void
  - - (err: Error, monitoredItem?: ClientMonitoredItem): void
    - Parameters
      - err: Error
      - Optional monitoredItem: ClientMonitoredItem
      Returns void
Returns void

monitorItems

monitorItems(itemsToMonitor: ReadValueIdOptions[], requestedParameters: MonitoringParametersOptions, timestampsToReturn: TimestampsToReturn): Promise<ClientMonitoredItemGroup>
monitorItems(itemsToMonitor: ReadValueIdOptions[], requestedParameters: MonitoringParametersOptions, timestampsToReturn: TimestampsToReturn, done: (err: Error, monitoredItemGroup?: ClientMonitoredItemGroup) => void): void

- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:159
method

monitorItems

async

Parameters
- itemsToMonitor: ReadValueIdOptions[]
- requestedParameters: MonitoringParametersOptions
- timestampsToReturn: TimestampsToReturn
Returns Promise<ClientMonitoredItemGroup>

a ClientMonitoredItemGroup
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:168
method

monitorItems

async

Parameters
- itemsToMonitor: ReadValueIdOptions[]
- requestedParameters: MonitoringParametersOptions
- timestampsToReturn: TimestampsToReturn
- done: (err: Error, monitoredItemGroup?: ClientMonitoredItemGroup) => void
  - - (err: Error, monitoredItemGroup?: ClientMonitoredItemGroup): void
    - Parameters
      - err: Error
      - Optional monitoredItemGroup: ClientMonitoredItemGroup
      Returns void
Returns void

off

off(event: string | symbol, listener: (...args: any[]) => void): ClientSubscription

- Defined in node_modules/@types/node/events.d.ts:66
Parameters
- event: string | symbol
- listener: (...args: any[]) => void
  - - (...args: any[]): void
    - Parameters
      - Rest ...args: any[]
      Returns void
Returns ClientSubscription

once

once(event: string | symbol, listener: (...args: any[]) => void): ClientSubscription

- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:175
Parameters
- event: string | symbol
- listener: (...args: any[]) => void
  - - (...args: any[]): void
    - Parameters
      - Rest ...args: any[]
      Returns void
Returns ClientSubscription

prependListener

prependListener(event: string | symbol, listener: (...args: any[]) => void): ClientSubscription

- Defined in node_modules/@types/node/events.d.ts:75
Parameters
- event: string | symbol
- listener: (...args: any[]) => void
  - - (...args: any[]): void
    - Parameters
      - Rest ...args: any[]
      Returns void
Returns ClientSubscription

prependOnceListener

prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): ClientSubscription

- Defined in node_modules/@types/node/events.d.ts:76
Parameters
- event: string | symbol
- listener: (...args: any[]) => void
  - - (...args: any[]): void
    - Parameters
      - Rest ...args: any[]
      Returns void
Returns ClientSubscription

rawListeners

rawListeners(event: string | symbol): Function[]

- Defined in node_modules/@types/node/events.d.ts:71
Parameters
- event: string | symbol
Returns Function[]

removeAllListeners

removeAllListeners(event?: string | symbol): ClientSubscription

- Defined in node_modules/@types/node/events.d.ts:67
Parameters
- Optional event: string | symbol
Returns ClientSubscription

removeListener

removeListener(event: string | symbol, listener: (...args: any[]) => void): ClientSubscription

- Defined in node_modules/@types/node/events.d.ts:65
Parameters
- event: string | symbol
- listener: (...args: any[]) => void
  - - (...args: any[]): void
    - Parameters
      - Rest ...args: any[]
      Returns void
Returns ClientSubscription

setMaxListeners

setMaxListeners(n: number): ClientSubscription

- Defined in node_modules/@types/node/events.d.ts:68
Parameters
- n: number
Returns ClientSubscription

terminate

terminate(): Promise<void>
terminate(callback: ErrorCallback): void

- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:171
Returns Promise<void>
- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:172
Parameters
- callback: ErrorCallback
Returns void

Static create

create(clientSession: ClientSession, options: ClientSubscriptionOptions): ClientSubscription

- Defined in packages/node-opcua-client/dist/client_subscription.d.ts:222
Parameters
- clientSession: ClientSession
- options: ClientSubscriptionOptions
Returns ClientSubscription

subscribe now with sterfive to access the online-user manual

Hierarchy

Index

Constructors

Events

Properties

Methods

Constructors

constructor

Returns ClientSubscription

Events

on

Parameters

event: string | symbol

listener: (...args: any[]) => void

Parameters

Rest ...args: any[]

Returns void

Returns ClientSubscription

Parameters

event: "started"

eventHandler: (subscriptionId: number) => void

Parameters

subscriptionId: number

Returns void

Returns ClientSubscription

Parameters

event: "terminated"

eventHandler: () => void

Returns void

Returns ClientSubscription

Parameters

event: "item_added"

eventHandler: (monitoredItem: ClientMonitoredItem) => void

Parameters

monitoredItem: ClientMonitoredItem

Returns void

Returns ClientSubscription

Parameters

event: "keepalive"

eventHandler: () => void

Returns void

Returns ClientSubscription

Parameters

event: "internal_error"

eventHandler: (err: Error) => void

Parameters

err: Error

Returns void

Returns ClientSubscription

Parameters

event: "raw_notification"

eventHandler: (notificationMessage: NotificationMessage) => void

Parameters

notificationMessage: NotificationMessage

Returns void

Returns ClientSubscription

Parameters

event: "received_notifications"

eventHandler: (notificationMessage: NotificationMessage) => void

Parameters

notificationMessage: NotificationMessage

Returns void

Returns ClientSubscription

Parameters

event: "status_changed"

eventHandler: (status: StatusCode, diagnosticInfo: DiagnosticInfo) => void

Parameters

status: StatusCode

diagnosticInfo: DiagnosticInfo

Returns void

Returns ClientSubscription

Parameters

event: "error"

eventHandler: (err: Error) => void

Parameters

err: Error

Returns void

Returns ClientSubscription

Properties