Class TextChannel

Represents a guild text channel.

Hierarchy

TextableChannel<TextChannel>
- TextChannel

Constructors

constructor

new TextChannel(data: RawTextChannel, client: Client<ClientEvents>): TextChannel
Parameters
- data: RawTextChannel
- client: Client<ClientEvents>
Returns TextChannel
Overrides TextableChannel.constructor
- Defined in lib/structures/TextChannel.ts:28

Properties

client

client: Client<ClientEvents>

defaultAutoArchiveDuration

defaultAutoArchiveDuration: 60 | 1440 | 4320 | 10080

The default auto archive duration for threads created in this channel.

guildID

guildID: string

The id of the guild this channel is in.

id

id: string

`Optional` lastMessage

lastMessage?: null | Message<TextChannel>

The last message sent in this channel. This will only be present if a message has been sent within the current session.

lastMessageID

lastMessageID: null | string

The ID of last message sent in this channel.

messages

messages: TypedCollection<string, RawMessage, Message<TextChannel>, []>

The cached messages in this channel.

name

name: string

The name of this channel.

nsfw

nsfw: boolean

If this channel is age gated.

parentID

parentID: null | string

The ID of the parent of this channel, if applicable.

permissionOverwrites

permissionOverwrites: TypedCollection<string, RawOverwrite, PermissionOverwrite, []>

The permission overwrites of this channel.

position

position: number

The position of this channel on the sidebar.

rateLimitPerUser

rateLimitPerUser: number

The amount of seconds between non-moderators sending messages.

threads

threads: TypedCollection<string, RawPublicThreadChannel | RawPrivateThreadChannel, PublicThreadChannel | PrivateThreadChannel, []>

The threads in this channel.

topic

topic: null | string

The topic of the channel.

type

type: GUILD_TEXT

The type of this channel.

Accessors

createdAt

get createdAt(): Date
Returns Date
Inherited from TextableChannel.createdAt
- Defined in lib/structures/Base.ts:31

guild

get guild(): Guild
The guild associated with this channel. This will throw an error if the guild is not cached.

Returns Guild
Inherited from TextableChannel.guild
- Defined in lib/structures/GuildChannel.ts:45

mention

get mention(): string
A string that will mention this channel.

Returns string
Inherited from TextableChannel.mention
- Defined in lib/structures/Channel.ts:73

parent

get parent(): undefined | null | CategoryChannel
The parent of this channel, if applicable. This will be a text/announcement/forum channel if we're in a thread, category otherwise.

Returns undefined | null | CategoryChannel
Inherited from TextableChannel.parent
- Defined in lib/structures/TextableChannel.ts:101

Methods

convert

convert(): Promise<AnnouncementChannel>
Convert this text channel to a announcement channel.

Returns Promise<AnnouncementChannel>
- Defined in lib/structures/TextChannel.ts:37

createInvite

createInvite(options: CreateInviteOptions): Promise<Invite<"withMetadata", TextChannel>>
Create an invite for this channel.
Parameters
- options: CreateInviteOptions
  
  The options for the invite.
Returns Promise<Invite<"withMetadata", TextChannel>>
Inherited from TextableChannel.createInvite
- Defined in lib/structures/TextableChannel.ts:109

createMessage

createMessage(options: CreateMessageOptions): Promise<Message<TextChannel>>
Create a message in this channel.
Parameters
- options: CreateMessageOptions
  
  The options for the message.
Returns Promise<Message<TextChannel>>
Inherited from TextableChannel.createMessage
- Defined in lib/structures/TextableChannel.ts:117

createReaction

createReaction(messageID: string, emoji: string): Promise<void>
Add a reaction to a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to add a reaction to.
- emoji: string
  
  The reaction to add to the message. name:id for custom emojis, and the unicode codepoint for default emojis.
Returns Promise<void>
Inherited from TextableChannel.createReaction
- Defined in lib/structures/TextableChannel.ts:126

createWebhook

createWebhook(options: CreateWebhookOptions): Promise<Webhook>
Create a webhook in this channel.
Parameters
- options: CreateWebhookOptions
  
  The options to create the webhook with.
Returns Promise<Webhook>
Inherited from TextableChannel.createWebhook
- Defined in lib/structures/TextableChannel.ts:134

delete

delete(): Promise<void>
Close a direct message, leave a group channel, or delete a guild channel.

Returns Promise<void>
Inherited from TextableChannel.delete
- Defined in lib/structures/Channel.ts:80

deleteMessage

deleteMessage(messageID: string, reason?: string): Promise<void>
Delete a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to delete.
- Optional reason: string
  
  The reason for deleting the message.
Returns Promise<void>
Inherited from TextableChannel.deleteMessage
- Defined in lib/structures/TextableChannel.ts:143

deleteMessages

deleteMessages(messageIDs: string[], reason?: string): Promise<number>
Bulk delete messages in this channel.
Parameters
- messageIDs: string[]
  
  The IDs of the messages to delete. Any duplicates or messages older than two weeks will cause an error.
- Optional reason: string
  
  The reason for deleting the messages.
Returns Promise<number>
Inherited from TextableChannel.deleteMessages
- Defined in lib/structures/TextableChannel.ts:152

deletePermission

deletePermission(overwriteID: string, reason?: string): Promise<void>
Delete a permission overwrite on this channel.
Parameters
- overwriteID: string
  
  The ID of the permission overwrite to delete.
- Optional reason: string
  
  The reason for deleting the permission overwrite.
Returns Promise<void>
Inherited from TextableChannel.deletePermission
- Defined in lib/structures/TextableChannel.ts:161

deleteReaction

deleteReaction(messageID: string, emoji: string, user?: string): Promise<void>
Remove a reaction from a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to remove a reaction from.
- emoji: string
  
  The reaction to remove from the message. name:id for custom emojis, and the unicode codepoint for default emojis.
- user: string = "@me"
  
  The user to remove the reaction from, @me for the current user (default).
Returns Promise<void>
Inherited from TextableChannel.deleteReaction
- Defined in lib/structures/TextableChannel.ts:171

deleteReactions

deleteReactions(messageID: string, emoji?: string): Promise<void>
Remove all, or a specific emoji's reactions from a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to remove reactions from.
- Optional emoji: string
  
  The reaction to remove from the message. name:id for custom emojis, and the unicode codepoint for default emojis. Omit to remove all reactions.
Returns Promise<void>
Inherited from TextableChannel.deleteReactions
- Defined in lib/structures/TextableChannel.ts:180

edit

edit(options: EditTextChannelOptions): Promise<TextChannel>
Edit this channel.
Parameters
- options: EditTextChannelOptions
  
  The options for editing the channel
Returns Promise<TextChannel>
Overrides TextableChannel.edit
- Defined in lib/structures/TextChannel.ts:45

editMessage

editMessage(messageID: string, options: EditMessageOptions): Promise<Message<TextChannel>>
Edit a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to edit.
- options: EditMessageOptions
  
  The options for editing the message.
Returns Promise<Message<TextChannel>>
Inherited from TextableChannel.editMessage
- Defined in lib/structures/TextableChannel.ts:197

editPermission

editPermission(overwriteID: string, options: EditPermissionOptions): Promise<void>
Edit a permission overwrite on this channel.
Parameters
- overwriteID: string
  
  The ID of the permission overwrite to edit.
- options: EditPermissionOptions
  
  The options for editing the permission overwrite.
Returns Promise<void>
Inherited from TextableChannel.editPermission
- Defined in lib/structures/TextableChannel.ts:206

followAnnouncement

followAnnouncement(webhookChannelID: string): Promise<FollowedChannel>
Follow an announcement channel to this channel.
Parameters
- webhookChannelID: string
  
  The ID of the channel to follow the announcement channel to.
Returns Promise<FollowedChannel>
- Defined in lib/structures/TextChannel.ts:53

getInvites

getInvites(): Promise<Invite<"withMetadata", TextChannel>[]>
Get the invites of this channel.

Returns Promise<Invite<"withMetadata", TextChannel>[]>
Inherited from TextableChannel.getInvites
- Defined in lib/structures/TextableChannel.ts:213

getJoinedPrivateArchivedThreads

getJoinedPrivateArchivedThreads(options?: GetArchivedThreadsOptions): Promise<ArchivedThreads<PrivateThreadChannel>>
Get the private archived threads the current user has joined in this channel.
Parameters
- Optional options: GetArchivedThreadsOptions
  
  The options for getting the joined private archived threads.
Returns Promise<ArchivedThreads<PrivateThreadChannel>>
- Defined in lib/structures/TextChannel.ts:61

getMessage

getMessage(messageID: string): Promise<Message<TextChannel>>
Get a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to get.
Returns Promise<Message<TextChannel>>
Inherited from TextableChannel.getMessage
- Defined in lib/structures/TextableChannel.ts:221

getMessages

getMessages(options?: GetChannelMessagesOptions): Promise<Message<TextChannel>[]>
Get messages in this channel.
Parameters
- Optional options: GetChannelMessagesOptions
  
  The options for getting the messages. before, after, and around All are mutually exclusive.
Returns Promise<Message<TextChannel>[]>
Inherited from TextableChannel.getMessages
- Defined in lib/structures/TextableChannel.ts:229

getPinnedMessages

getPinnedMessages(): Promise<Message<TextChannel>[]>
Get the pinned messages in this channel.

Returns Promise<Message<TextChannel>[]>
Inherited from TextableChannel.getPinnedMessages
- Defined in lib/structures/TextableChannel.ts:236

getPrivateArchivedThreads

getPrivateArchivedThreads(options?: GetArchivedThreadsOptions): Promise<ArchivedThreads<PrivateThreadChannel>>
Get the private archived threads in this channel.
Parameters
- Optional options: GetArchivedThreadsOptions
  
  The options for getting the private archived threads.
Returns Promise<ArchivedThreads<PrivateThreadChannel>>
- Defined in lib/structures/TextChannel.ts:69

getPublicArchivedThreads

getPublicArchivedThreads(options?: GetArchivedThreadsOptions): Promise<ArchivedThreads<PublicThreadChannel>>
Get the public archived threads in this channel.
Parameters
- Optional options: GetArchivedThreadsOptions
  
  The options for getting the public archived threads.
Returns Promise<ArchivedThreads<PublicThreadChannel>>
Inherited from TextableChannel.getPublicArchivedThreads
- Defined in lib/structures/TextableChannel.ts:244

getReactions

getReactions(messageID: string, emoji: string, options?: GetReactionsOptions): Promise<User[]>
Get the users who reacted with a specific emoji on a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to get reactions from.
- emoji: string
  
  The reaction to remove from the message. name:id for custom emojis, and the unicode codepoint for default emojis.
- Optional options: GetReactionsOptions
  
  The options for getting the reactions.
Returns Promise<User[]>
Inherited from TextableChannel.getReactions
- Defined in lib/structures/TextableChannel.ts:254

getWebhooks

getWebhooks(): Promise<Webhook[]>
Get the webhooks in this channel.

Returns Promise<Webhook[]>
Inherited from TextableChannel.getWebhooks
- Defined in lib/structures/TextableChannel.ts:261

permissionsOf

permissionsOf(member: string | Member): Permission
Get the permissions of a member. If providing an id, the member must be cached.
Parameters
- member: string | Member
  
  The member to get the permissions of.
Returns Permission
Inherited from TextableChannel.permissionsOf
- Defined in lib/structures/TextableChannel.ts:269

pinMessage

pinMessage(messageID: string, reason?: string): Promise<void>
Pin a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to pin.
- Optional reason: string
  
  The reason for pinning the message.
Returns Promise<void>
Inherited from TextableChannel.pinMessage
- Defined in lib/structures/TextableChannel.ts:306

purge

purge(options: PurgeOptions<TextChannel>): Promise<number>
Purge an amount of messages from this channel.
Parameters
- options: PurgeOptions<TextChannel>
  
  The options to purge. before, after, and around All are mutually exclusive.
Returns Promise<number>
Inherited from TextableChannel.purge
- Defined in lib/structures/TextableChannel.ts:314

sendTyping

sendTyping(): Promise<void>
Show a typing indicator in this channel. How long users see this varies from client to client.

Returns Promise<void>
Inherited from TextableChannel.sendTyping
- Defined in lib/structures/TextableChannel.ts:321

startThreadFromMessage

startThreadFromMessage(messageID: string, options: StartThreadFromMessageOptions): Promise<AnnouncementThreadChannel>
Create a thread from an existing message in this channel.
Parameters
- messageID: string
  
  The ID of the message to create a thread from.
- options: StartThreadFromMessageOptions
  
  The options for creating the thread.
Returns Promise<AnnouncementThreadChannel>
Inherited from TextableChannel.startThreadFromMessage
- Defined in lib/structures/TextableChannel.ts:330

startThreadWithoutMessage

startThreadWithoutMessage(options: StartThreadWithoutMessageOptions): Promise<AnnouncementThreadChannel>
Create a thread without an existing message in this channel.
Parameters
- options: StartThreadWithoutMessageOptions
  
  The options for creating the thread.
Returns Promise<AnnouncementThreadChannel>
Inherited from TextableChannel.startThreadWithoutMessage
- Defined in lib/structures/TextableChannel.ts:338

toJSON

toJSON(): JSONTextChannel
Returns JSONTextChannel
Overrides TextableChannel.toJSON
- Defined in lib/structures/TextChannel.ts:73

toString

toString(): string
Returns string
Inherited from TextableChannel.toString
- Defined in lib/structures/Base.ts:56

unpinMessage

unpinMessage(messageID: string, reason?: string): Promise<void>
Unpin a message in this channel.
Parameters
- messageID: string
  
  The ID of the message to unpin.
- Optional reason: string
  
  The reason for unpinning the message.
Returns Promise<void>
Inherited from TextableChannel.unpinMessage
- Defined in lib/structures/TextableChannel.ts:361

`Static` from

from<T>(data: RawChannel, client: Client<ClientEvents>): T
Type Parameters
- T extends AnyChannel = AnyChannel
Parameters
- data: RawChannel
- client: Client<ClientEvents>
Returns T
Inherited from TextableChannel.from
- Defined in lib/structures/Channel.ts:31

`Static` getCreatedAt

getCreatedAt(id: string): Date
Parameters
- id: string
Returns Date
Inherited from TextableChannel.getCreatedAt
- Defined in lib/structures/Base.ts:20

`Static` getDiscordEpoch

getDiscordEpoch(id: string): number
Parameters
- id: string
Returns number
Inherited from TextableChannel.getDiscordEpoch
- Defined in lib/structures/Base.ts:24

Class TextChannel

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

data: RawTextChannel

client: Client<ClientEvents>

Returns TextChannel

Properties

client

defaultAutoArchiveDuration

guildID

id

Optional lastMessage

lastMessageID

messages

name

nsfw

parentID

permissionOverwrites

position

rateLimitPerUser

threads

topic

type

Accessors

createdAt

Returns Date

guild

Returns Guild

mention

Returns string

parent

Returns undefined | null | CategoryChannel

Methods

convert

Returns Promise<AnnouncementChannel>

createInvite

Parameters

options: CreateInviteOptions

Returns Promise<Invite<"withMetadata", TextChannel>>

createMessage

Parameters

options: CreateMessageOptions

Returns Promise<Message<TextChannel>>

createReaction

Parameters

messageID: string

emoji: string

Returns Promise<void>

createWebhook

Parameters

options: CreateWebhookOptions

Returns Promise<Webhook>

delete

Returns Promise<void>

deleteMessage

Parameters

messageID: string

Optional reason: string

Returns Promise<void>

deleteMessages

Parameters

messageIDs: string[]

Optional reason: string

Returns Promise<number>

deletePermission

Parameters

overwriteID: string

Optional reason: string

Returns Promise<void>

deleteReaction

Parameters

messageID: string

emoji: string

`Optional` lastMessage

`Optional` reason: string

`Optional` reason: string

`Optional` reason: string

`Optional` emoji: string

`Optional` options: GetArchivedThreadsOptions

`Optional` options: GetChannelMessagesOptions

`Optional` options: GetArchivedThreadsOptions

`Optional` options: GetArchivedThreadsOptions

`Optional` options: GetReactionsOptions

`Optional` reason: string