ChannelObject
✖
ChannelObject
gives a new anonymous channel specification.
ChannelObject["mqtts://…"]
represents a channel specified by a given URL.
ChannelObject["relpath"]
represents a channel for the currently authenticated user at a relative path.
ChannelObject["id:path"]
represents a channel for the user with the specified Wolfram ID at the given path.
ChannelObject["/abspath"]
represents a channel at an absolute path on the channel broker.
Details and Options

- ChannelObject does not create a channel but merely provides an object that can be used to refer to a channel. CreateChannel actually creates channels.
- New channel objects that are not specified with a full URL are created with reference to the channel broker specified by $ChannelBase.
- ChannelObject[CloudObject[…]] returns the associated channel object of a cloud object that represents a deployed ChannelReceiverFunction.
- ChannelObject allows the following options:
-
ChannelBase $ChannelBase default base URI for new channel specifications ChannelBrokerAction None action to execute on the channel broker server in addition to routing a message MetaInformation {} association or rules giving metainformation Permissions "Private" permissions for access etc. - Options[ChannelObject[…],…] gives the current options of a previously created ChannelObject. SetOptions can be used to change them.
- Information of a ChannelObject expression can include the following properties:
-
"ChannelBase" base URL of channel broker server for the channel "Path" path of the channel on the channel broker server "Permissions" access permissions of the channel "MetaInformation" MetaInformation option of the channel
Examples
open allclose allBasic Examples (2)Summary of the most common use cases
Scope (8)Survey of the scope of standard use cases

https://wolfram.com/xid/0dqukuqt3yq-nz7rcz

A channel in the home area of the currently authenticated user:

https://wolfram.com/xid/0dqukuqt3yq-k20ph8

A named channel in a subdirectory of the home area:

https://wolfram.com/xid/0dqukuqt3yq-dyx6uc

A named channel of another user:

https://wolfram.com/xid/0dqukuqt3yq-61tnzz

A channel referred to by the absolute path on the channel broker server:

https://wolfram.com/xid/0dqukuqt3yq-xxgpxk

A channel referred to by the URL:

https://wolfram.com/xid/0dqukuqt3yq-w962lp

A channel associated with a cloud object deployed for a channel receiver:

https://wolfram.com/xid/0dqukuqt3yq-etpmja


https://wolfram.com/xid/0dqukuqt3yq-hfcvdv

Delete the channel that was automatically created by CloudDeploy:

https://wolfram.com/xid/0dqukuqt3yq-9pdb8q

https://wolfram.com/xid/0dqukuqt3yq-fcyzdc

Options (2)Common values & functionality for each option
Permissions (2)

https://wolfram.com/xid/0dqukuqt3yq-obiafz


https://wolfram.com/xid/0dqukuqt3yq-f66tuu

Start listening on the channel and send some data:

https://wolfram.com/xid/0dqukuqt3yq-51mhbp


https://wolfram.com/xid/0dqukuqt3yq-tmg9yz

https://wolfram.com/xid/0dqukuqt3yq-rsxm1n

Other users can send data to your channel by referring to your $WolframID:

https://wolfram.com/xid/0dqukuqt3yq-c0h6nd


https://wolfram.com/xid/0dqukuqt3yq-mx75hd

https://wolfram.com/xid/0dqukuqt3yq-04sax1
A channel to which you can listen and everyone can send messages:

https://wolfram.com/xid/0dqukuqt3yq-7mzyqi

Properties & Relations (4)Properties of the function, and connections to other functions
ChannelObject creates a reference to the channel without creating a channel on the server:

https://wolfram.com/xid/0dqukuqt3yq-44d0en

Check that the channel does not exist:

https://wolfram.com/xid/0dqukuqt3yq-s13ea2


Create a channel and verify that it exists on the server:

https://wolfram.com/xid/0dqukuqt3yq-e7cbsb


https://wolfram.com/xid/0dqukuqt3yq-0y4jpt

Delete the channel from the server:

https://wolfram.com/xid/0dqukuqt3yq-62v7l7

CreateChannel returns a ChannelObject:

https://wolfram.com/xid/0dqukuqt3yq-5w6n2x


https://wolfram.com/xid/0dqukuqt3yq-libedg
ChannelObject is used by ChannelListen, ChannelSend, and other functions:

https://wolfram.com/xid/0dqukuqt3yq-6hiwiu


https://wolfram.com/xid/0dqukuqt3yq-4h8avm


https://wolfram.com/xid/0dqukuqt3yq-fiw72k

https://wolfram.com/xid/0dqukuqt3yq-00oyft

ChannelObject can be retrieved from the ChannelListener object:

https://wolfram.com/xid/0dqukuqt3yq-9bjptj


https://wolfram.com/xid/0dqukuqt3yq-kxn5rn


https://wolfram.com/xid/0dqukuqt3yq-pdvgyj
Wolfram Research (2016), ChannelObject, Wolfram Language function, https://reference.wolfram.com/language/ref/ChannelObject.html (updated 2017).
Text
Wolfram Research (2016), ChannelObject, Wolfram Language function, https://reference.wolfram.com/language/ref/ChannelObject.html (updated 2017).
Wolfram Research (2016), ChannelObject, Wolfram Language function, https://reference.wolfram.com/language/ref/ChannelObject.html (updated 2017).
CMS
Wolfram Language. 2016. "ChannelObject." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2017. https://reference.wolfram.com/language/ref/ChannelObject.html.
Wolfram Language. 2016. "ChannelObject." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2017. https://reference.wolfram.com/language/ref/ChannelObject.html.
APA
Wolfram Language. (2016). ChannelObject. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ChannelObject.html
Wolfram Language. (2016). ChannelObject. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ChannelObject.html
BibTeX
@misc{reference.wolfram_2025_channelobject, author="Wolfram Research", title="{ChannelObject}", year="2017", howpublished="\url{https://reference.wolfram.com/language/ref/ChannelObject.html}", note=[Accessed: 03-June-2025
]}
BibLaTeX
@online{reference.wolfram_2025_channelobject, organization={Wolfram Research}, title={ChannelObject}, year={2017}, url={https://reference.wolfram.com/language/ref/ChannelObject.html}, note=[Accessed: 03-June-2025
]}