Class Message<T>

Represents a message.

Type Parameters

T extends AnyTextableChannel | Uncached = AnyTextableChannel | Uncached

Hierarchy

Base
- Message

Constructors

constructor

new Message<T>(data: RawMessage, client: Client<ClientEvents>): Message<T>
Type Parameters
- T extends Uncached | AnyTextableChannel = Uncached | AnyTextableChannel
Parameters
- data: RawMessage
- client: Client<ClientEvents>
Returns Message<T>
Overrides Base.constructor
- Defined in lib/structures/Message.ts:123

Properties

`Optional` activity

activity?: MessageActivity

The activity associated with this message.

`Optional` application

application?: ClientApplication | PartialApplication

The application associated with this message. This can be present in two scenarios:

If the message was from an interaction or application owned webhook (ClientApplication if any shard has reached READY, PartialApplication otherwise).
If the message has a rich presence embed (PartialApplication)

applicationID

applicationID: null | string

The ID of the application associated with this message. This can be present in two scenarios:

If the message was from an interaction or application owned webhook (ClientApplication if any shard has reached READY, PartialApplication otherwise).
If the message has a rich presence embed (PartialApplication)

attachments

attachments: TypedCollection<string, RawAttachment, Attachment, []>

The attachments on this message.

author

author: User

The author of this message.

channelID

channelID: string

The ID of the channel this message was created in.

client

client: Client<ClientEvents>

components

components: MessageActionRow[]

The components on this message.

content

content: string

The content of this message.

editedTimestamp

editedTimestamp: null | Date

The timestamp at which this message was last edited.

embeds

embeds: Embed[]

The embeds on this message.

flags

flags: number

The flags on this message.

guildID

guildID: T extends AnyTextableGuildChannel ? string : null | string

The ID of the guild this message is in.

id

id: string

`Optional` interaction

interaction?: MessageInteraction

The interaction info, if this message was the result of an interaction.

member

member: T extends AnyTextableGuildChannel ? Member : undefined | Member

The member that created this message, if this message is in a guild.

`Optional` mentionChannels

mentionChannels?: ChannelMention[]

Channels mentioned in a CROSSPOSTED channel follower message. See Discord's docs for more information.

mentions

mentions: {
    channels: string[];
    everyone: boolean;
    members: Member[];
    roles: string[];
    users: User[];
}

The mentions in this message.

Type declaration

channels: string[]

The ids of the channels mentioned in this message.
everyone: boolean

If @everyone/@here is mentioned in this message.
members: Member[]

The members mentioned in this message.
roles: string[]

The ids of the roles mentioned in this message.
users: User[]

The users mentioned in this message.

`Optional` messageReference

messageReference?: MessageReference

If this message is a REPLY or THREAD_STARTER_MESSAGE, some info about the referenced message.

`Optional` nonce

nonce?: string | number

A nonce for ensuring a message was sent.

pinned

pinned: boolean

If this message is pinned.

`Optional` position

position?: number

This message's relative position, if in a thread.

reactions

reactions: Record<string, MessageReaction>

The reactions on this message.

`Optional` referencedMessage

referencedMessage?: null | Message<Uncached | AnyTextableChannel>

If this message is a REPLY or THREAD_STARTER_MESSAGE, this will be the message that's referenced.

`Optional` stickerItems

stickerItems?: StickerItem[]

The sticker items on this message.

`Optional` thread

thread?: AnyThreadChannel

The thread associated with this message, if any.

timestamp

timestamp: Date

The timestamp at which this message was sent.

tts

tts: boolean

If this message was read aloud.

type

type: MessageTypes

The type of this message.

`Optional` webhookID

webhookID?: string

The webhook associated with this message, if sent via a webhook. This only has an id property.

Accessors

channel

get channel(): T extends AnyTextableChannel ? T : undefined
The channel this message was created in.

Returns T extends AnyTextableChannel ? T : undefined
- Defined in lib/structures/Message.ts:279

createdAt

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

guild

get guild(): T extends AnyTextableGuildChannel ? Guild : null | Guild
The guild this message is in. This will throw an error if the guild is not cached.

Returns T extends AnyTextableGuildChannel ? Guild : null | Guild
- Defined in lib/structures/Message.ts:284

jumpLink

get jumpLink(): string
A link to this message.

Returns string
- Defined in lib/structures/Message.ts:306

Methods

createReaction

createReaction(emoji: string): Promise<void>
Add a reaction to this message.
Parameters
- emoji: string
  
  The reaction to add to the message. name:id for custom emojis, and the unicode codepoint for default emojis.
Returns Promise<void>
- Defined in lib/structures/Message.ts:314

crosspost

crosspost(): Promise<Message<T>>
Crosspost this message in an announcement channel.

Returns Promise<Message<T>>
- Defined in lib/structures/Message.ts:321

delete

delete(reason?: string): Promise<void>
Delete this message.
Parameters
- Optional reason: string
  
  The reason for deleting the message.
Returns Promise<void>
- Defined in lib/structures/Message.ts:329

deleteReaction

deleteReaction(emoji: string, user?: string): Promise<void>
Remove a reaction from this message.
Parameters
- 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>
- Defined in lib/structures/Message.ts:338

deleteReactions

deleteReactions(emoji?: string): Promise<void>
Remove all, or a specific emoji's reactions from this message.
Parameters
- 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>
- Defined in lib/structures/Message.ts:346

deleteWebhook

deleteWebhook(token: string, options: DeleteWebhookMessageOptions): Promise<void>
Delete this message as a webhook.
Parameters
- token: string
  
  The token of the webhook.
- options: DeleteWebhookMessageOptions
  
  Options for deleting the message.
Returns Promise<void>
- Defined in lib/structures/Message.ts:355

edit

edit(options: EditMessageOptions): Promise<Message<T>>
Edit this message.
Parameters
- options: EditMessageOptions
  
  The options for editing the message.
Returns Promise<Message<T>>
- Defined in lib/structures/Message.ts:366

editWebhook

editWebhook(token: string, options: EditWebhookMessageOptions): Promise<Message<T>>
Edit this message as a webhook.
Parameters
- token: string
  
  The token of the webhook.
- options: EditWebhookMessageOptions
  
  The options for editing the message.
Returns Promise<Message<T>>
- Defined in lib/structures/Message.ts:375

getReactions

getReactions(emoji: string, options?: GetReactionsOptions): Promise<User[]>
Get the users who reacted with a specific emoji on this message.
Parameters
- 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[]>
- Defined in lib/structures/Message.ts:387

inCachedGuildChannel

inCachedGuildChannel(): this is Message<AnyTextableGuildChannel>
Whether this message belongs to a cached guild channel. The only difference on using this method over a simple if statement is to easily update all the message properties typing definitions based on the channel it belongs to.

Returns this is Message<AnyTextableGuildChannel>
- Defined in lib/structures/Message.ts:392

inDirectMessageChannel

inDirectMessageChannel(): this is Message<Uncached | PrivateChannel>
Whether this message belongs to a direct message channel (PrivateChannel or uncached). The only difference on using this method over a simple if statement is to easily update all the message properties typing definitions based on the channel it belongs to.

Returns this is Message<Uncached | PrivateChannel>
- Defined in lib/structures/Message.ts:397

pin(reason?: string): Promise<void>
Pin this message.
Parameters
- Optional reason: string
  
  The reason for pinning the message.
Returns Promise<void>
- Defined in lib/structures/Message.ts:405

startThread

startThread(options: StartThreadFromMessageOptions): Promise<T extends AnnouncementChannel ? AnnouncementThreadChannel : T extends TextChannel ? PublicThreadChannel : never>
Create a thread from this message.
Parameters
- options: StartThreadFromMessageOptions
  
  The options for creating the thread.
Returns Promise<T extends AnnouncementChannel ? AnnouncementThreadChannel : T extends TextChannel ? PublicThreadChannel : never>
- Defined in lib/structures/Message.ts:414

toJSON

toJSON(): JSONMessage
Returns JSONMessage
Overrides Base.toJSON
- Defined in lib/structures/Message.ts:417

toString

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

unpin

unpin(reason?: string): Promise<void>
Unpin this message.
Parameters
- Optional reason: string
  
  The reason for unpinning the message.
Returns Promise<void>
- Defined in lib/structures/Message.ts:465

`Static` generateID

generateID(timestamp?: number | Date): string
Parameters
- timestamp: number | Date = ...
Returns string
Inherited from Base.generateID
- Defined in lib/structures/Base.ts:21

`Static` getCreatedAt

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

`Static` getDiscordEpoch

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

Class Message<T>

Type Parameters

T extends AnyTextableChannel | Uncached = AnyTextableChannel | Uncached

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

T extends Uncached | AnyTextableChannel = Uncached | AnyTextableChannel

Parameters

data: RawMessage

client: Client<ClientEvents>

Returns Message<T>

Properties

Optional activity

Optional application

applicationID

attachments

author

channelID

client

components

content

editedTimestamp

embeds

flags

guildID

id

Optional interaction

member

Optional mentionChannels

mentions

Type declaration

channels: string[]

everyone: boolean

members: Member[]

roles: string[]

users: User[]

Optional messageReference

Optional nonce

pinned

Optional position

reactions

Optional referencedMessage

Optional stickerItems

Optional thread

timestamp

tts

type

Optional webhookID

Accessors

channel

Returns T extends AnyTextableChannel ? T : undefined

createdAt

Returns Date

guild

Returns T extends AnyTextableGuildChannel ? Guild : null | Guild

jumpLink

Returns string

Methods

createReaction

Parameters

emoji: string

Returns Promise<void>

crosspost

Returns Promise<Message<T>>

delete

Parameters

Optional reason: string

Returns Promise<void>

deleteReaction

Parameters

emoji: string

user: string = "@me"

Returns Promise<void>

deleteReactions

`Optional` activity

`Optional` application

`Optional` interaction

`Optional` mentionChannels

`Optional` messageReference

`Optional` nonce

`Optional` position

`Optional` referencedMessage

`Optional` stickerItems

`Optional` thread

`Optional` webhookID

`Optional` reason: string

`Optional` emoji: string

`Optional` options: GetReactionsOptions

`Optional` reason: string

`Optional` reason: string

`Static` generateID

`Static` getCreatedAt

`Static` getDiscordEpoch