Class
A message in a channel.
Extends Base
Construct a message from API data.
new Message(client: Client, data: APIMessage)ClientAPIMessageAPI message from REST or MESSAGE_CREATE| Name | Type | Description |
|---|---|---|
| attachmentsread-only | Collection<string, MessageAttachment> | Attached files (images, videos, etc.). |
| authorread-only | User | The user who sent this message. |
| call | MessageCall | null | Call data if this message represents a call event. |
| channelread-only | TextBasedChannel | null | Cached text-capable channel (guild text, guild voice, or DM), or null if uncached / not text-based. Narrowed type has channel.send and channel.delete. |
| channelIdread-only | string | Channel ID where this message was sent. |
| clientread-only | Client | The Client that instantiated this message. |
| content | string | Text content of the message. |
| createdAtread-only | Date | When the message was created. |
| editedAt | Date | null | When the message was last edited, or null if never edited. |
| embeds | MessageEmbed[] | Embedded content (camelCase read view; send with EmbedBuilder). |
| flags | MessageFlagsBitField | Message flags bitfield. |
| guildread-only | Guild | null | Cached guild, or null for DMs / uncached. |
| guildIdread-only | string | null | Guild ID if in a guild channel, null for DMs. |
| idread-only | string | Snowflake ID of this message. |
| memberread-only | GuildMember | null | Cached guild member for the author, or null in DMs / if uncached. |
| mentionEveryone | boolean | Whether @everyone or @here was mentioned. |
| mentionRoles | string[] | Role IDs mentioned in the message. |
| mentions | User[] | Users mentioned in the message. |
| messageReference | MessageReference | null | Reference to a replied-to message, if any. |
| messageSnapshots | MessageSnapshot[] | Message snapshots for forwarded messages. |
| nonce | string | null | Client-side nonce for deduplication. |
| partialread-only | false | Discriminant vs PartialMessage: always false on a hydrated Message. |
| pinned | boolean | Whether the message is pinned. |
| reactionsread-only | MessageReactionManager | Reactions on the message. |
| referencedMessage | Message | null | The full referenced (replied-to) message, or null. |
| stickers | MessageSticker[] | Stickers sent with the message. |
| tts | boolean | Whether this is a text-to-speech message. |
| typeread-only | MessageType | Message type (Default, Reply, etc.). |
| webhookId | string | null | Webhook ID if sent by a webhook. |
options?: ReactionCollectorOptions & { errors?: ReactionCollectorEndReason[] } → Promise<Collection<string, CollectedReaction>>
Wait for reactions matching the filter, then resolve the collected set. Pass errors: ['time'] to reject when the timer fires instead of resolving.
message.awaitReactions();options?: ReactionCollectorOptions → ReactionCollector
Create a ReactionCollector for this message.
message.createReactionCollector();→ Promise<void>
Delete this message.
await message.delete();attachmentId: string → Promise<void>
Delete a specific attachment from this message.
await message.deleteAttachment(attachmentId);options: MessageEditOptions → Promise<Message>
Edit this message (requires author or admin permissions).
await message.edit(options);→ Promise<Message>
Fetch the latest version of this message from the API.
await message.fetch();emoji: EmojiInput, options?: { limit?: number; after?: string; } → Promise<User[]>
Fetch users who reacted with a specific emoji.
await message.fetchReactionUsers(emoji);emoji: EmojiInput, options?: { limit?: number; after?: string; } → Promise<{ users: User[]; hasMore: boolean; nextAfter: string | null }>
Fetch reaction users with pagination metadata.
await message.fetchReactionUsersPage(emoji);→ Promise<void>
Pin this message in the channel.
await message.pin();emoji: EmojiInput → Promise<void>
React to this message with an emoji.
await message.react(emoji);→ Promise<void>
Remove all reactions from this message.
await message.removeAllReactions();emoji: EmojiInput, userId?: string → Promise<void>
Remove a reaction (bot's own or a user's if ID is provided).
await message.removeReaction(emoji);emoji: EmojiInput → Promise<void>
Remove all reactions of a specific emoji.
await message.removeReactionEmoji(emoji);options: string | (MessageSendOptions & ReplyOptions), replyOptions?: ReplyOptions → Promise<Message>
Reply to this message.
await message.reply('Pong!');
await message.reply('No ping!', { ping: false });
await message.reply({ content: 'Silent', allowedMentions: AllowedMentions.suppressReplyPing });message: Message | PartialMessage → Promise<Message>
Hydrate a partial message, or return the message as-is.
client.on(Events.MessageUpdate, async (_old, msg) => {
const message = await Message.resolve(msg);
});→ Promise<Channel>
Fetch this message's channel (cache first). The returned Channel has channel.delete and channel.send.
const channel = await message.resolveChannel();
await channel.delete();→ Promise<Guild | null>
Fetch and resolve the guild, or null if a DM. Propagates network/auth errors; only returns null when there is no guildId.
const guild = await message.resolveGuild();options: MessagePrepareInput → Promise<Message>
Send a standalone message in this channel (not a reply). Prefer channel.send or reply when you already have the channel or are answering.
await message.send(options);channelId: string, options: MessagePrepareInput → Promise<Message>
Send a message to another channel by ID. Prefer client.channels.fetch(channelId) then channel.send.
await message.sendTo(channelId, options);→ Promise<void>
Unpin this message from the channel.
await message.unpin();