Namespace: Channel

InterApplicationBus. Channel

The Channel namespace allows an OpenFin application to create a channel as a ChannelProvider, or connect to a channel as a ChannelClient. The "handshake" between the communication partners is simplified when using a channel. A request to connect to a channel as a client will return a promise that resolves if/when the channel has been created. Both the provider and client can dispatch actions that have been registered on their opposites, and dispatch returns a promise that resolves with a payload from the other communication participant. There can be only one provider per channel, but many clients. Version 9.61.35.* or later is required for both communication partners.

Asynchronous Methods

Methods

(static) connect(channelName, options) → {Promise.<Channel#ChannelClient>}

Connect to a channel. Returns a promise for a ChannelClient instance for that channel. If you wish to send a payload to the provider, add a payload property to the options argument.

Parameters:
Name Type Description
channelName string

Name of the target channel.

options InterApplicationBus.Channel~ConnectOptions

Connection options.

Tutorials:
Returns:

Returns promise that resolves with an instance of ChannelClient.

Type
Promise.<Channel#ChannelClient>

(static) create(channelName) → {Promise.<Channel#ChannelProvider>}

Create a new channel. Returns a promise that resolves with a ChannelProvider instance for your channel. You must provide a unique channelName. If a channelName is not provided, or it is not unique, the creation will fail.

Parameters:
Name Type Description
channelName string

Name of the channel to be created.

Tutorials:
Returns:

Returns promise that resolves with an instance of ChannelProvider.

Type
Promise.<Channel#ChannelProvider>

(static) onChannelConnect(listener) → {Promise.<void>}

Listens for channel connections.

Parameters:
Name Type Description
listener InterApplicationBus.Channel~ConnectionEvent

callback to execute.

Tutorials:
Returns:
Type
Promise.<void>

(static) onChannelDisconnect(listener) → {Promise.<void>}

Listen for channel disconnections.

Parameters:
Name Type Description
listener InterApplicationBus.Channel~ConnectionEvent

callback to execute.

Tutorials:
Returns:
Type
Promise.<void>

Type Definitions

ClientIdentity

Client Identity.

Type:
  • object
Properties:
Name Type Description
uuid string

Channel client uuid.

name string

Channel client name.

endpointId string

Unique identifier for a client, because there can be multiple clients at one name/uuid entity.

ConnectionEvent

Callback for onChannelConnect or onChannelDisconnect.

Type:
  • object
Properties:
Name Type Attributes Description
channelId string

Identifier of the channel.

uuid string

Channel provider uuid.

name string <optional>

Channel provider name.

channelName string

Name of the channel.

ConnectOptions

Options provided on a client connection to a channel.

Type:
  • object
Properties:
Name Type Attributes Default Description
payload any <optional>

Payload to pass to ChannelProvider onConnection action.

wait boolean <optional>
true

If true will wait for ChannelProvider to connect. If false will fail if ChannelProvider is not found.

ProviderIdentity

Provider Identity.

Type:
  • object
Properties:
Name Type Attributes Description
uuid string

Channel provider uuid.

name string <optional>

Channel provider name.

channelId string

Identifier of the channel.

isExternal boolean <optional>

true if it's external connection.

channelName string

Name of the channel.