GuildTextableChannel

GuildTextableChannel

Represents a textable guild channel. You also probably want to look at NewsChannel, StageChannel, TextChannel, ThreadChannel, and VoiceChannel. See GuildChannel for more properties

Constructor

new GuildTextableChannel()

Properties:
Name Type Attributes Description
lastMessageID String <nullable>

The ID of the last message in the channel. This can be null if there has never been a message in the channel
messages Collection.<Message>

Collection of Messages in this channel
rateLimitPerUser Number

The time in seconds a user has to wait before sending another message (0-21600) (does not affect bots or users with manageMessages/manageChannel permissions)
Source:

Methods

addMessageReaction(messageID, reaction) → {Promise}

Add a reaction to a message

Source:
Parameters:
Name Type Description
messageID String

The ID of the message
reaction String

The reaction (Unicode string if Unicode emoji, emojiName:emojiID if custom emoji)
Returns:
Type:
Promise

createMessage(content, fileopt) → {Promise.<Message>}

Create a message in the channel

Source:
Parameters:
Name Type Attributes Description
content String | Object

A string or object. If an object is passed:

Name Type Attributes Description
allowedMentions Object <optional>

A list of mentions to allow (overrides default)

Name Type Attributes Description
everyone Boolean <optional>

Whether or not to allow @everyone/@here
repliedUser Boolean <optional>

Whether or not to mention the author of the message being replied to
roles Boolean | Array.<String> <optional>

Whether or not to allow all role mentions, or an array of specific role mentions to allow
users Boolean | Array.<String> <optional>

Whether or not to allow all user mentions, or an array of specific user mentions to allow
attachments Array.<Object> <optional>

An array of attachment objects with the filename and description

Name Type Attributes Description
description String <optional>

The description of the file
filename String <optional>

The name of the file
id Number

The index of the file
components Array.<Object> <optional>

An array of component objects
content String <optional>

A content string
embed Object <optional>

[DEPRECATED] An embed object. See the official Discord API documentation entry for object structure
embeds Array.<Object> <optional>

An array of embed objects. See the official Discord API documentation entry for object structure
enforceNonce Boolean <optional>

If true and content.nonce is present, if multiple messages are sent with the same nonce within a few minutes of each other, that message will be returned and no new message created
flags Number <optional>

A number representing the flags to apply to the message (only SUPPRESS_EMBEDS and SUPPRESS_NOTIFICATIONS)
messageReference Object <optional>

The message reference, used when replying to or forwarding messages

Name Type Attributes Default Description
channelID String <optional>

The channel ID of the referenced message. Required when forwarding messages
failIfNotExists Boolean <optional>
 true

Whether to throw an error if the message reference doesn't exist. If false, and the referenced message doesn't exist, the message is created without a referenced message
guildID String <optional>

The guild ID of the referenced message
messageID String

The message ID of the referenced message. This cannot reference a system message
type String <optional>
 0

The type of reference. Either 0 (REPLY) or 1 (FORWARDED). Will become required in the future
messageReferenceID String <optional>

[DEPRECATED] The ID of the message should be replied to. Use messageReference instead
poll Object <optional>

A poll object. See the official Discord API documentation entry for object structure
nonce String | Number <optional>

A nonce value which will also appear in the messageCreate event
stickerIDs Array.<String> <optional>

An array of IDs corresponding to stickers to send
tts Boolean <optional>

Set the message TTS flag
file Object | Array.<Object> <optional>

A file object (or an Array of them)

Name Type Description
file Buffer

A buffer containing file data
name String

What to name the file
Returns:
Type:
Promise.<Message>

deleteMessage(messageID, reasonopt) → {Promise}

Delete a message

Source:
Parameters:
Name Type Attributes Description
messageID String

The ID of the message
reason String <optional>

The reason to be displayed in audit logs
Returns:
Type:
Promise

deleteMessages(messageIDs, reasonopt) → {Promise}

Bulk delete messages (bot accounts only)

Source:
Parameters:
Name Type Attributes Description
messageIDs Array.<String>

Array of message IDs to delete
reason String <optional>

The reason to be displayed in audit logs
Returns:
Type:
Promise

editMessage(messageID, content) → {Promise.<Message>}

Edit a message

Source:
Parameters:
Name Type Description
messageID String

The ID of the message
content String | Array | Object

A string, array of strings, or object. If an object is passed:

Name Type Attributes Description
allowedMentions Object <optional>

A list of mentions to allow (overrides default)

Name Type Attributes Description
everyone Boolean <optional>

Whether or not to allow @everyone/@here
roles Boolean | Array.<String> <optional>

Whether or not to allow all role mentions, or an array of specific role mentions to allow
users Boolean | Array.<String> <optional>

Whether or not to allow all user mentions, or an array of specific user mentions to allow
attachments Array.<Object> <optional>

An array of attachment objects that will be appended to the message, including new files. Only the provided files will be appended

Name Type Attributes Description
description String <optional>

The description of the file
filename String <optional>

The name of the file. This is not required if you are attaching a new file
id Number | String

The ID of the file. If you are attaching a new file, this would be the index of the file
components Array.<Object> <optional>

An array of component objects
content String <optional>

A content string
embed Object <optional>

[DEPRECATED] An embed object. See the official Discord API documentation entry for object structure
embeds Array.<Object> <optional>

An array of embed objects. See the official Discord API documentation entry for object structure
file Object | Array.<Object> <optional>

A file object (or an Array of them)

Name Type Description
file Buffer

A buffer containing file data
name String

What to name the file
flags Number <optional>

A number representing the flags to apply to the message. See the official Discord API documentation entry for flags reference
Returns:
Type:
Promise.<Message>

endPoll(messageID) → {Promise.<Message>}

Immediately end a poll. Note: You cannot end polls from other users.

Source:
Parameters:
Name Type Description
messageID String

The ID of the message that the poll is in
Returns:
Type:
Promise.<Message>

getMessage(messageID) → {Promise.<Message>}

Get a previous message in the channel

Source:
Parameters:
Name Type Description
messageID String

The ID of the message
Returns:
Type:
Promise.<Message>

getMessageReaction(messageID, reaction, optionsopt, beforeopt, afteropt) → {Promise.<Array.<User>>}

Get a list of users who reacted with a specific reaction

Source:
Parameters:
Name Type Attributes Description
messageID String

The ID of the message
reaction String

The reaction (Unicode string if Unicode emoji, emojiName:emojiID if custom emoji)
options Object <optional>

Options for the request. If this is a number, it is treated as options.limit ([DEPRECATED] behavior)

Name Type Attributes Default Description
after String <optional>

Get users after this user ID
limit Number <optional>
 100

The maximum number of users to get
type Number <optional>
 0

The type of reaction (0 for normal, 1 for burst)
before String <optional>

[DEPRECATED] Get users before this user ID. Discord no longer supports this parameter
after String <optional>

[DEPRECATED] Get users after this user ID
Returns:
Type:
Promise.<Array.<User>>

getMessages(optionsopt, beforeopt, afteropt, aroundopt) → {Promise.<Array.<Message>>}

Get previous messages in the channel

Source:
Parameters:
Name Type Attributes Description
options Object <optional>

Options for the request. If this is a number ([DEPRECATED] behavior), it is treated as options.limit

Name Type Attributes Default Description
after String <optional>

Get messages after this message ID
around String <optional>

Get messages around this message ID (does not work with limit > 100)
before String <optional>

Get messages before this message ID
limit Number <optional>
 50

The max number of messages to get
before String <optional>

[DEPRECATED] Get messages before this message ID
after String <optional>

[DEPRECATED] Get messages after this message ID
around String <optional>

[DEPRECATED] Get messages around this message ID (does not work with limit > 100)
Returns:
Type:
Promise.<Array.<Message>>

getPollAnswerVoters(messageID, answerID, optionsopt) → {Promise.<Array.<User>>}

Get a list of users that voted for a specific poll answer

Source:
Parameters:
Name Type Attributes Description
messageID String

The ID of the message that the poll is in
answerID Number

The ID of the answer to get voters for
options Object <optional>

Options for the request

Name Type Attributes Default Description
after String <optional>

Get users after this user ID
limit Number <optional>
 25

The max number of users to get
Returns:
Type:
Promise.<Array.<User>>

An array of users who voted for this answer

purge(options, filteropt, beforeopt, afteropt, reasonopt) → {Promise.<Number>}

Purge previous messages in the channel with an optional filter

Source:
Parameters:
Name Type Attributes Description
options Object

Options for the request. If this is a number ([DEPRECATED] behavior), it is treated as options.limit

Name Type Attributes Description
after String <optional>

Get messages after this message ID
before String <optional>

Get messages before this message ID
filter function <optional>

Optional filter function that returns a boolean when passed a Message object
limit Number

The max number of messages to search through, -1 for no limit
reason String <optional>

The reason to be displayed in audit logs
filter function <optional>

[DEPRECATED] Optional filter function that returns a boolean when passed a Message object
before String <optional>

[DEPRECATED] Get messages before this message ID
after String <optional>

[DEPRECATED] Get messages after this message ID
reason String <optional>

[DEPRECATED] The reason to be displayed in audit logs
Returns:
Type:
Promise.<Number>

Resolves with the number of messages deleted

removeMessageReaction(messageID, reaction, userIDopt) → {Promise}

Remove a reaction from a message

Source:
Parameters:
Name Type Attributes Default Description
messageID String

The ID of the message
reaction String

The reaction (Unicode string if Unicode emoji, emojiName:emojiID if custom emoji)
userID String <optional>
 "@me"

The ID of the user to remove the reaction for
Returns:
Type:
Promise

removeMessageReactionEmoji(messageID, reaction) → {Promise}

Remove all reactions from a message for a single emoji

Source:
Parameters:
Name Type Description
messageID String

The ID of the message
reaction String

The reaction (Unicode string if Unicode emoji, emojiName:emojiID if custom emoji)
Returns:
Type:
Promise

removeMessageReactions(messageID) → {Promise}

Remove all reactions from a message

Source:
Parameters:
Name Type Description
messageID String

The ID of the message
Returns:
Type:
Promise

sendTyping() → {Promise}

Send typing status in the channel

Source:
Returns:
Type:
Promise

unsendMessage(messageID) → {Promise}

Un-send a message. You're welcome Programmix

Source:
Parameters:
Name Type Description
messageID String

The ID of the message
Returns:
Type:
Promise