diff --git a/doc/api/diagnostics_channel.md b/doc/api/diagnostics_channel.md index 8a591da61f43ca..1faa6bee24deb4 100644 --- a/doc/api/diagnostics_channel.md +++ b/doc/api/diagnostics_channel.md @@ -79,6 +79,12 @@ if (channel.hasSubscribers) { #### `diagnostics_channel.hasSubscribers(name)` + + * `name` {string|symbol} The channel name * Returns: {boolean} If there are active subscribers @@ -106,6 +112,12 @@ if (diagnostics_channel.hasSubscribers('my-channel')) { #### `diagnostics_channel.channel(name)` + + * `name` {string|symbol} The channel name * Returns: {Channel} The named channel object @@ -127,6 +139,12 @@ const channel = diagnostics_channel.channel('my-channel'); ### Class: `Channel` + + The class `Channel` represents an individual named channel within the data pipeline. It is use to track subscribers and to publish messages when there are subscribers present. It exists as a separate object to avoid channel @@ -137,6 +155,12 @@ with `new Channel(name)` is not supported. #### `channel.hasSubscribers` + + * Returns: {boolean} If there are active subscribers Check if there are active subscribers to this channel. This is helpful if @@ -167,6 +191,12 @@ if (channel.hasSubscribers) { #### `channel.publish(message)` + + * `message` {any} The message to send to the channel subscribers Publish a message to any subscribers to the channel. This will trigger @@ -194,6 +224,12 @@ channel.publish({ #### `channel.subscribe(onMessage)` + + * `onMessage` {Function} The handler to receive channel messages * `message` {any} The message data * `name` {string|symbol} The name of the channel @@ -224,6 +260,12 @@ channel.subscribe((message, name) => { #### `channel.unsubscribe(onMessage)` + + * `onMessage` {Function} The previous subscribed handler to remove Remove a message handler previously registered to this channel with