discord.js | CategoryChannel

Search...

CategoryChannel

export class CategoryChannel extends GuildChannel

export class CategoryChannel extends GuildChannel

Represents a guild category channel on Discord.

Extends

GuildChannel

Readonly

children:CategoryChannelChildManager

A manager of the channels belonging to this category

Readonly

client:Client

The client that instantiated this

Readonly

createdAt:Date

The time the channel was created at

Readonly

createdTimestamp:number

The timestamp the channel was created at

Readonly

deletable:boolean

Whether the channel is deletable by the client user

flags?:Readonly<ChannelFlagsBitField>

The flags that are applied to the channel. This is only null in a PartialGroupDMChannel. In all other cases, it is not null.

guild:Guild

The guild the channel is in

guildId:Snowflake

The id of the guild the channel is in

id:Snowflake

The channel's id

Readonly

manageable:boolean

Whether the channel is manageable by the client user

Readonly

members:Collection<Snowflake, GuildMember>

A collection of cached members of this channel, mapped by their ids. Members that can view this channel, if the channel is text-based. Members in the channel, if the channel is voice-based.

name:string

The name of the guild channel

Readonly

parent:null

The parent of this channel.

parentId:null

The id of the parent of this channel.

Readonly

partial:boolean

Whether this Channel is a partial This is always false outside of DM channels.

permissionOverwrites:PermissionOverwriteManager

A manager of permission overwrites that belong to this channel

Readonly

permissionsLocked?:boolean

If the permissionOverwrites match the parent channel, null if no parent

Readonly

position:number

The position of the channel

rawPosition:number

The raw position of the channel from Discord

type:ChannelType.GuildCategory

The type of the channel

Readonly

url:string

The URL to the channel

Readonly

viewable:boolean

Whether the channel is viewable by the client user

clone(options?):Promise<this>

Clones this channel.

Name	Type	Optional	Description
options	GuildChannelCloneOptions	Yes	The options for cloning this channel

Inherited from GuildChannel

delete(reason?):Promise<this>

Deletes this channel.

Example

// Delete the channel
channel.delete('making room for new channels')
  .then(console.log)
  .catch(console.error);

// Delete the channel
channel.delete('making room for new channels')
  .then(console.log)
  .catch(console.error);

Name	Type	Optional	Description
reason	string	Yes	Reason for deleting this channel

Inherited from GuildChannel

edit(options):Promise<this>

Edits the channel.

Example

// Edit a channel
channel.edit({ name: 'new-channel' })
  .then(console.log)
  .catch(console.error);

// Edit a channel
channel.edit({ name: 'new-channel' })
  .then(console.log)
  .catch(console.error);

Name	Type	Optional	Description
options	GuildChannelEditOptions	No	The options to provide

Inherited from GuildChannel

equals(channel):boolean

Checks if this channel has the same type, topic, position, name, overwrites, and id as another channel. In most cases, a simple channel.id === channel2.id will do, and is much faster too.

Name	Type	Optional	Description
channel	GuildChannel	No	Channel to compare with

Inherited from GuildChannel

fetch(force?):Promise<this>

Fetches this channel.

Name	Type	Optional	Description
force	boolean	Yes	Whether to skip the cache check and request the API

Inherited from BaseChannel

isDMBased():this is PartialGroupDMChannel | DMChannel | PartialDMChannel

Indicates whether this channel is DM-based (either a DMChannel or a PartialGroupDMChannel).

Inherited from BaseChannel

isTextBased():this is GuildBasedChannel & TextBasedChannel

Indicates whether this channel is .

Inherited from GuildChannel

isThread():this is AnyThreadChannel

Indicates whether this channel is a ThreadChannel.

Inherited from BaseChannel

isThreadOnly():this is ThreadOnlyChannel

Indicates whether this channel is thread-only.

Inherited from BaseChannel

isVoiceBased():this is VoiceBasedChannel

Indicates whether this channel is voice-based.

Inherited from BaseChannel

lockPermissions():Promise<this>

Locks in the permission overwrites from the parent channel.

Inherited from GuildChannel

permissionsFor(memberOrRole, checkAdmin?):Readonly<PermissionsBitField>

Gets the overall set of permissions for a member or role in this channel, taking into account channel overwrites.

Returns

Name	Type	Optional	Description
memberOrRole	GuildMember \| Role	No	The member or role to obtain the overall permissions for
checkAdmin	boolean	Yes	Whether having the PermissionFlagsBits.Administrator permission will return all permissions

setName(name, reason?):Promise<this>

Sets a new name for the guild channel.

Example

// Set a new channel name
channel.setName('not_general')
  .then(newChannel => console.log(`Channel's new name is ${newChannel.name}`))
  .catch(console.error);

// Set a new channel name
channel.setName('not_general')
  .then(newChannel => console.log(`Channel's new name is ${newChannel.name}`))
  .catch(console.error);

Name	Type	Optional	Description
name	string	No	The new name for the guild channel
reason	string	Yes	Reason for changing the guild channel's name

Inherited from GuildChannel

setParent(channel, options?):Promise<GuildChannel>

Sets the category parent of this channel. It is not possible to set the parent of a CategoryChannel.

Name	Type	Optional	Description
channel	CategoryChannelResolvable	No	The channel to set as parent
options	SetParentOptions	Yes	The options for setting the parent

setPosition(position, options?):Promise<this>

Sets a new position for the guild channel.

Example

// Set a new channel position
channel.setPosition(2)
  .then(newChannel => console.log(`Channel's new position is ${newChannel.position}`))
  .catch(console.error);

// Set a new channel position
channel.setPosition(2)
  .then(newChannel => console.log(`Channel's new position is ${newChannel.position}`))
  .catch(console.error);

Name	Type	Optional	Description
position	number	No	The new position for the guild channel
options	SetChannelPositionOptions	Yes	Options for setting position

Inherited from GuildChannel

toJSON(...props):unknown

Name	Type	Optional	Description
...props	Record<string, boolean \| string>[]	No	None

Inherited from Base

toString():ChannelMention

When concatenated with a string, this automatically returns the channel's mention instead of the Channel object.

Example

// Logs: Hello from <#123456789012345678>!
console.log(`Hello from ${channel}!`);

// Logs: Hello from <#123456789012345678>!
console.log(`Hello from ${channel}!`);

Inherited from GuildChannel

valueOf():string