Class Channel

Channel Class

Hierarchy

Channel

Constructors

constructor

new Channel(collection: ChannelCollection, id: string): Channel
Construct Channel
Parameters
- collection: ChannelCollection
  
  Collection
- id: string
  
  Channel Id
Returns Channel
- Defined in src/classes/Channel.ts:32

Properties

`Private` `Optional` #ackLimit

#ackLimit?: number

`Private` `Optional` #ackTimeout

#ackTimeout?: number

`Private` `Readonly` #collection

#collection: ChannelCollection

`Private` `Optional` #manuallyMarked

#manuallyMarked?: boolean

`Readonly` id

id: string

Accessors

$exists

get $exists(): boolean
Whether this object exists

Returns boolean
- Defined in src/classes/Channel.ts:48

active

get active(): boolean
Whether the conversation is active

Returns boolean
- Defined in src/classes/Channel.ts:119

animatedIconURL

get animatedIconURL(): undefined | string
URL to the animated channel icon

Returns undefined | string
- Defined in src/classes/Channel.ts:322

createdAt

get createdAt(): Date
Time when this server was created

Returns Date
- Defined in src/classes/Channel.ts:55

defaultPermissions

get defaultPermissions(): undefined | {
a: number;
d: number;
}
Default permissions for this server channel

Returns undefined | {
a: number;
d: number;
}
- Defined in src/classes/Channel.ts:224

description

get description(): undefined | string
Channel description

Returns undefined | string
- Defined in src/classes/Channel.ts:105

displayName

get displayName(): undefined | string
Display name

Returns undefined | string
- Defined in src/classes/Channel.ts:94

icon

get icon(): undefined | File
Channel icon

Returns undefined | File
- Defined in src/classes/Channel.ts:112

iconURL

get iconURL(): undefined | string
URL to the channel icon

Returns undefined | string
- Defined in src/classes/Channel.ts:306

lastMessage

get lastMessage(): undefined | Message
Last message sent in this channel

Returns undefined | Message
- Defined in src/classes/Channel.ts:252

lastMessageAt

get lastMessageAt(): undefined | Date
Time when the last message was sent

Returns undefined | Date
- Defined in src/classes/Channel.ts:259

lastMessageId

get lastMessageId(): undefined | string
ID of the last message sent in this channel

Returns undefined | string
- Defined in src/classes/Channel.ts:245

mature

get mature(): boolean
Whether this channel is marked as mature

Returns boolean
- Defined in src/classes/Channel.ts:238

mentions

get mentions(): undefined | ReactiveSet<string>
Get mentions in this channel for user.

Returns undefined | ReactiveSet<string>
- Defined in src/classes/Channel.ts:295

name

get name(): string
Channel name

Returns string
- Defined in src/classes/Channel.ts:87

owner

get owner(): undefined | User
Owner of the group

Returns undefined | User
- Defined in src/classes/Channel.ts:192

ownerId

get ownerId(): string
Owner ID

Returns string
- Defined in src/classes/Channel.ts:185

path

get path(): string
Absolute pathname to this channel in the client

Returns string
- Defined in src/classes/Channel.ts:69

permission

get permission(): number
Permission the currently authenticated user has against this channel

Returns number
- Defined in src/classes/Channel.ts:354

permissions

get permissions(): undefined | number
Permissions allowed for users in this group

Returns undefined | number
- Defined in src/classes/Channel.ts:217

potentiallyRestrictedChannel

get potentiallyRestrictedChannel(): undefined | string | boolean
Whether this channel may be hidden to some users

Returns undefined | string | boolean
- Defined in src/classes/Channel.ts:332

recipient

get recipient(): undefined | User
Find recipient of this DM

Returns undefined | User
- Defined in src/classes/Channel.ts:158

recipientIds

get recipientIds(): ReactiveSet<string>
User ids of recipients of the group

Returns ReactiveSet<string>
- Defined in src/classes/Channel.ts:142

recipients

get recipients(): User[]
Recipients of the group

Returns User[]
- Defined in src/classes/Channel.ts:149

rolePermissions

get rolePermissions(): undefined | Record<string, {
a: number;
d: number;
}>
Role permissions for this server channel

Returns undefined | Record<string, {
a: number;
d: number;
}>
- Defined in src/classes/Channel.ts:231

server

get server(): undefined | Server
Server this channel is in

Returns undefined | Server
- Defined in src/classes/Channel.ts:208

serverId

get serverId(): string
Server ID

Returns string
- Defined in src/classes/Channel.ts:201

smallIconURL

get smallIconURL(): undefined | string
URL to a small variant of the channel icon

Returns undefined | string
- Defined in src/classes/Channel.ts:315

type

get type(): "SavedMessages" | "DirectMessage" | "Group" | "TextChannel" | "VoiceChannel"
Channel type

Returns "SavedMessages" | "DirectMessage" | "Group" | "TextChannel" | "VoiceChannel"
- Defined in src/classes/Channel.ts:62

typing

get typing(): User[]
Users currently trying in channel

Returns User[]
- Defined in src/classes/Channel.ts:133

typingIds

get typingIds(): ReactiveSet<string>
User ids of people currently typing in channel

Returns ReactiveSet<string>
- Defined in src/classes/Channel.ts:126

unread

get unread(): boolean
Get whether this channel is unread.

Returns boolean
- Defined in src/classes/Channel.ts:275

updatedAt

get updatedAt(): Date
Time when the channel was last updated (either created or a message was sent)

Returns Date
- Defined in src/classes/Channel.ts:268

url

get url(): string
URL to this channel

Returns string
- Defined in src/classes/Channel.ts:80

user

get user(): undefined | User
User this channel belongs to

Returns undefined | User
- Defined in src/classes/Channel.ts:176

userId

get userId(): string
User ID

Returns string
- Defined in src/classes/Channel.ts:169

Methods

ack

ack(message?: string | Message, skipRateLimiter?: boolean, skipRequest?: boolean, skipNextMarking?: boolean): Promise<void>
Mark a channel as read

Requires
SavedMessages, DirectMessage, Group, TextChannel
Parameters
- Optional message: string | Message
  
  Last read message or its ID
- Optional skipRateLimiter: boolean
  
  Whether to skip the internal rate limiter
- Optional skipRequest: boolean
  
  For internal updates only
- Optional skipNextMarking: boolean
  
  For internal usage only
Returns Promise<void>
- Defined in src/classes/Channel.ts:651

addMember

addMember(user_id: string): Promise<undefined>
Add a user to a group

Requires
Group
Parameters
- user_id: string
  
  ID of the target user
Returns Promise<undefined>
- Defined in src/classes/Channel.ts:448

createInvite

createInvite(): Promise<{
    _id: string;
    channel: string;
    creator: string;
    server: string;
    type: "Server";
} | {
    _id: string;
    channel: string;
    creator: string;
    type: "Group";
}>
Create an invite to the channel

Requires
TextChannel, VoiceChannel

Returns
Newly created invite code

Returns Promise<{
    _id: string;
    channel: string;
    creator: string;
    server: string;
    type: "Server";
} | {
    _id: string;
    channel: string;
    creator: string;
    type: "Group";
}>
- Defined in src/classes/Channel.ts:633

delete

delete(leaveSilently?: boolean): Promise<void>
Delete or leave a channel

Requires
DirectMessage, Group, TextChannel, VoiceChannel
Parameters
- Optional leaveSilently: boolean
  
  Whether to not send a message on leave
Returns Promise<void>
- Defined in src/classes/Channel.ts:430

deleteMessages

deleteMessages(ids: string[]): Promise<void>
Delete many messages by their IDs

Requires
SavedMessages, DirectMessage, Group, TextChannel
Parameters
- ids: string[]
  
  List of message IDs
Returns Promise<void>
- Defined in src/classes/Channel.ts:619

edit

edit(data: {
    archived?: null | boolean;
    description?: null | string;
    icon?: null | string;
    name?: null | string;
    nsfw?: null | boolean;
    owner?: null | string;
    remove?: null | ("Description" | "Icon" | "DefaultPermissions")[];
}): Promise<void>
Edit a channel
Parameters
- data: {
      archived?: null | boolean;
      description?: null | string;
      icon?: null | string;
      name?: null | string;
      nsfw?: null | boolean;
      owner?: null | string;
      remove?: null | ("Description" | "Icon" | "DefaultPermissions")[];
  }
  
  Changes
  - Optional archived?: null | boolean
    
    Description
    Whether this channel is archived
  - Optional description?: null | string
    
    Description
    Channel description
  - Optional icon?: null | string
    
    Description
    Icon
    
    Provide an Autumn attachment Id.
  - Optional name?: null | string
    
    Description
    Channel name
  - Optional nsfw?: null | boolean
    
    Description
    Whether this channel is age-restricted
  - Optional owner?: null | string
    
    Description
    Group owner
  - Optional remove?: null | ("Description" | "Icon" | "DefaultPermissions")[]
Returns Promise<void>
- Defined in src/classes/Channel.ts:421

fetchMembers

fetchMembers(): Promise<User[]>
Fetch a channel's members.

Requires
Group

Returns
An array of the channel's members.

Returns Promise<User[]>
- Defined in src/classes/Channel.ts:388

fetchMessage

fetchMessage(messageId: string): Promise<Message>
Fetch a message by its ID

Requires
SavedMessages, DirectMessage, Group, TextChannel

Returns
Message
Parameters
- messageId: string
  
  ID of the target message
Returns Promise<Message>
- Defined in src/classes/Channel.ts:501

fetchMessages

fetchMessages(params?: Omit<undefined | {
    after?: null | string;
    before?: null | string;
    include_users?: null | boolean;
    limit?: null | number;
    nearby?: null | string;
    sort?: null | "Relevance" | "Latest" | "Oldest";
}, "include_users">): Promise<Message[]>
Fetch multiple messages from a channel

Requires
SavedMessages, DirectMessage, Group, TextChannel

Returns
Messages
Parameters
- Optional params: Omit<undefined | {
      after?: null | string;
      before?: null | string;
      include_users?: null | boolean;
      limit?: null | number;
      nearby?: null | string;
      sort?: null | "Relevance" | "Latest" | "Oldest";
  }, "include_users">
  
  Message fetching route data
Returns Promise<Message[]>
- Defined in src/classes/Channel.ts:515

fetchMessagesWithUsers

fetchMessagesWithUsers(params?: Omit<undefined | {
    after?: null | string;
    before?: null | string;
    include_users?: null | boolean;
    limit?: null | number;
    nearby?: null | string;
    sort?: null | "Relevance" | "Latest" | "Oldest";
}, "include_users">): Promise<{
    members: undefined | ServerMember[];
    messages: Message[];
    users: User[];
}>
Fetch multiple messages from a channel including the users that sent them

Requires
SavedMessages, DirectMessage, Group, TextChannel

Returns
Object including messages and users
Parameters
- Optional params: Omit<undefined | {
      after?: null | string;
      before?: null | string;
      include_users?: null | boolean;
      limit?: null | number;
      nearby?: null | string;
      sort?: null | "Relevance" | "Latest" | "Oldest";
  }, "include_users">
  
  Message fetching route data
Returns Promise<{
    members: undefined | ServerMember[];
    messages: Message[];
    users: User[];
}>
- Defined in src/classes/Channel.ts:540

fetchWebhooks

fetchWebhooks(): Promise<ChannelWebhook[]>
Fetch a channel's webhooks

Requires
TextChannel, Group

Returns
Webhooks

Returns Promise<ChannelWebhook[]>
- Defined in src/classes/Channel.ts:405

havePermission

havePermission(...permission: ("Video" | "Masquerade" | "ManageChannel" | "ManageServer" | "ManagePermissions" | "ManageRole" | "ManageCustomisation" | "KickMembers" | "BanMembers" | "TimeoutMembers" | "AssignRoles" | "ChangeNickname" | "ManageNicknames" | "ChangeAvatar" | "RemoveAvatars" | "ViewChannel" | "ReadMessageHistory" | "SendMessage" | "ManageMessages" | "ManageWebhooks" | "InviteOthers" | "SendEmbeds" | "UploadFiles" | "React" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "GrantAllSafe")[]): boolean
Check whether we have a given permission in a channel

Returns
Whether we have this permission
Parameters
- Rest ...permission: ("Video" | "Masquerade" | "ManageChannel" | "ManageServer" | "ManagePermissions" | "ManageRole" | "ManageCustomisation" | "KickMembers" | "BanMembers" | "TimeoutMembers" | "AssignRoles" | "ChangeNickname" | "ManageNicknames" | "ChangeAvatar" | "RemoveAvatars" | "ViewChannel" | "ReadMessageHistory" | "SendMessage" | "ManageMessages" | "ManageWebhooks" | "InviteOthers" | "SendEmbeds" | "UploadFiles" | "React" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "GrantAllSafe")[]
  
  Permission Names
Returns boolean
- Defined in src/classes/Channel.ts:363

orPermission

orPermission(...permission: ("Video" | "Masquerade" | "ManageChannel" | "ManageServer" | "ManagePermissions" | "ManageRole" | "ManageCustomisation" | "KickMembers" | "BanMembers" | "TimeoutMembers" | "AssignRoles" | "ChangeNickname" | "ManageNicknames" | "ChangeAvatar" | "RemoveAvatars" | "ViewChannel" | "ReadMessageHistory" | "SendMessage" | "ManageMessages" | "ManageWebhooks" | "InviteOthers" | "SendEmbeds" | "UploadFiles" | "React" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "GrantAllSafe")[]): boolean
Check whether we have at least one of the given permissions in a channel

Returns
Whether we have one of the permissions
Parameters
- Rest ...permission: ("Video" | "Masquerade" | "ManageChannel" | "ManageServer" | "ManagePermissions" | "ManageRole" | "ManageCustomisation" | "KickMembers" | "BanMembers" | "TimeoutMembers" | "AssignRoles" | "ChangeNickname" | "ManageNicknames" | "ChangeAvatar" | "RemoveAvatars" | "ViewChannel" | "ReadMessageHistory" | "SendMessage" | "ManageMessages" | "ManageWebhooks" | "InviteOthers" | "SendEmbeds" | "UploadFiles" | "React" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "GrantAllSafe")[]
  
  Permission Names
Returns boolean
- Defined in src/classes/Channel.ts:375

removeMember

removeMember(user_id: string): Promise<undefined>
Remove a user from a group

Requires
Group
Parameters
- user_id: string
  
  ID of the target user
Returns Promise<undefined>
- Defined in src/classes/Channel.ts:459

search

search(params: Omit<{
    after?: null | string;
    before?: null | string;
    include_users?: null | boolean;
    limit?: null | number;
    query: string;
    sort?: "Relevance" | "Latest" | "Oldest";
}, "include_users">): Promise<Message[]>
Search for messages

Requires
SavedMessages, DirectMessage, Group, TextChannel

Returns
Messages
Parameters
- params: Omit<{
      after?: null | string;
      before?: null | string;
      include_users?: null | boolean;
      limit?: null | number;
      query: string;
      sort?: "Relevance" | "Latest" | "Oldest";
  }, "include_users">
  
  Message searching route data
Returns Promise<Message[]>
- Defined in src/classes/Channel.ts:573

searchWithUsers

searchWithUsers(params: Omit<{
    after?: null | string;
    before?: null | string;
    include_users?: null | boolean;
    limit?: null | number;
    query: string;
    sort?: "Relevance" | "Latest" | "Oldest";
}, "include_users">): Promise<{
    members: undefined | ServerMember[];
    messages: Message[];
    users: User[];
}>
Search for messages including the users that sent them

Requires
SavedMessages, DirectMessage, Group, TextChannel

Returns
Object including messages and users
Parameters
- params: Omit<{
      after?: null | string;
      before?: null | string;
      include_users?: null | boolean;
      limit?: null | number;
      query: string;
      sort?: "Relevance" | "Latest" | "Oldest";
  }, "include_users">
  
  Message searching route data
Returns Promise<{
    members: undefined | ServerMember[];
    messages: Message[];
    users: User[];
}>
- Defined in src/classes/Channel.ts:592

sendMessage

sendMessage(data: string | {
    attachments?: null | string[];
    content?: null | string;
    embeds?: null | {
        colour?: null | string;
        description?: null | string;
        icon_url?: null | string;
        media?: null | string;
        title?: null | string;
        url?: null | string;
    }[];
    interactions?: null | {
        reactions?: null | string[];
        restrict_reactions?: boolean;
    };
    masquerade?: null | {
        avatar?: null | string;
        colour?: null | string;
        name?: null | string;
    };
    nonce?: null | string;
    replies?: null | {
        id: string;
        mention: boolean;
    }[];
}, idempotencyKey?: string): Promise<Message>
Send a message

Requires
SavedMessages, DirectMessage, Group, TextChannel

Returns
Sent message
Parameters
- data: string | {
      attachments?: null | string[];
      content?: null | string;
      embeds?: null | {
          colour?: null | string;
          description?: null | string;
          icon_url?: null | string;
          media?: null | string;
          title?: null | string;
          url?: null | string;
      }[];
      interactions?: null | {
          reactions?: null | string[];
          restrict_reactions?: boolean;
      };
      masquerade?: null | {
          avatar?: null | string;
          colour?: null | string;
          name?: null | string;
      };
      nonce?: null | string;
      replies?: null | {
          id: string;
          mention: boolean;
      }[];
  }
  
  Either the message as a string or message sending route data
- idempotencyKey: string = ...
Returns Promise<Message>
- Defined in src/classes/Channel.ts:471

setPermissions

setPermissions(role_id?: string, permissions: {
    allow: number;
    deny: number;
}): Promise<{
    _id: string;
    analytics?: boolean;
    banner?: null | {
        _id: string;
        content_type: string;
        deleted?: null | boolean;
        filename: string;
        message_id?: null | string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: null | string;
        reported?: null | boolean;
        server_id?: null | string;
        size: number;
        tag: string;
        user_id?: null | string;
    };
    categories?: null | {
        channels: string[];
        id: string;
        title: string;
    }[];
    channels: string[];
    default_permissions: number;
    description?: null | string;
    discoverable?: boolean;
    flags?: number;
    icon?: null | {
        _id: string;
        content_type: string;
        deleted?: null | boolean;
        filename: string;
        message_id?: null | string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: null | string;
        reported?: null | boolean;
        server_id?: null | string;
        size: number;
        tag: string;
        user_id?: null | string;
    };
    name: string;
    nsfw?: boolean;
    owner: string;
    roles?: {
        [key: string]: components["schemas"]["Role"];
    };
    system_messages?: null | {
        user_banned?: null | string;
        user_joined?: null | string;
        user_kicked?: null | string;
        user_left?: null | string;
    };
}>
Set role permissions

Requires
Group, TextChannel, VoiceChannel
Parameters
- role_id: string = "default"
  
  Role Id, set to 'default' to affect all users
- permissions: {
  allow: number;
  deny: number;
  }
  
  Permission value
  - allow: number
    
    Format: uint64
    
    Description
    Allow bit flags
  - deny: number
    
    Format: uint64
    
    Description
    Disallow bit flags
Returns Promise<{
    _id: string;
    analytics?: boolean;
    banner?: null | {
        _id: string;
        content_type: string;
        deleted?: null | boolean;
        filename: string;
        message_id?: null | string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: null | string;
        reported?: null | boolean;
        server_id?: null | string;
        size: number;
        tag: string;
        user_id?: null | string;
    };
    categories?: null | {
        channels: string[];
        id: string;
        title: string;
    }[];
    channels: string[];
    default_permissions: number;
    description?: null | string;
    discoverable?: boolean;
    flags?: number;
    icon?: null | {
        _id: string;
        content_type: string;
        deleted?: null | boolean;
        filename: string;
        message_id?: null | string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: null | string;
        reported?: null | boolean;
        server_id?: null | string;
        size: number;
        tag: string;
        user_id?: null | string;
    };
    name: string;
    nsfw?: boolean;
    owner: string;
    roles?: {
        [key: string]: components["schemas"]["Role"];
    };
    system_messages?: null | {
        user_banned?: null | string;
        user_joined?: null | string;
        user_kicked?: null | string;
        user_left?: null | string;
    };
}>
- Defined in src/classes/Channel.ts:717

startTyping

startTyping(): void
Start typing in this channel

Requires
DirectMessage, Group, TextChannel

Returns void
- Defined in src/classes/Channel.ts:728

stopTyping

stopTyping(): void
Stop typing in this channel

Requires
DirectMessage, Group, TextChannel

Returns void
- Defined in src/classes/Channel.ts:739

toString

toString(): string
Write to string as a channel mention

Returns
Formatted String

Returns string
- Defined in src/classes/Channel.ts:41

Class Channel

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

collection: ChannelCollection

id: string

Returns Channel

Properties

Private Optional #ackLimit

Private Optional #ackTimeout

Private Readonly #collection

Private Optional #manuallyMarked

Readonly id

Accessors

$exists

Returns boolean

active

Returns boolean

animatedIconURL

Returns undefined | string

createdAt

Returns Date

defaultPermissions

Returns undefined | { a: number; d: number; }

description

Returns undefined | string

displayName

Returns undefined | string

icon

Returns undefined | File

iconURL

Returns undefined | string

lastMessage

Returns undefined | Message

lastMessageAt

Returns undefined | Date

lastMessageId

Returns undefined | string

mature

Returns boolean

mentions

Returns undefined | ReactiveSet<string>

name

Returns string

owner

Returns undefined | User

ownerId

Returns string

path

Returns string

permission

Returns number

permissions

Returns undefined | number

potentiallyRestrictedChannel

Returns undefined | string | boolean

recipient

Returns undefined | User

recipientIds

Returns ReactiveSet<string>

recipients

Returns User[]

rolePermissions

Returns undefined | Record<string, { a: number; d: number; }>

server

Returns undefined | Server

serverId

Returns string

smallIconURL

Returns undefined | string

type

Returns "SavedMessages" | "DirectMessage" | "Group" | "TextChannel" | "VoiceChannel"

typing

Returns User[]

`Private` `Optional` #ackLimit

`Private` `Optional` #ackTimeout

`Private` `Readonly` #collection

`Private` `Optional` #manuallyMarked

`Readonly` id

Returns undefined | {
a: number;
d: number;
}

Returns undefined | Record<string, {
a: number;
d: number;
}>

`Optional` message: string | Message

`Optional` skipRateLimiter: boolean

`Optional` skipRequest: boolean

`Optional` skipNextMarking: boolean

Returns Promise<{
_id: string;
channel: string;
creator: string;
server: string;
type: "Server";
} | {
_id: string;
channel: string;
creator: string;
type: "Group";
}>

`Optional` leaveSilently: boolean

data: {
archived?: null | boolean;
description?: null | string;
icon?: null | string;
name?: null | string;
nsfw?: null | boolean;
owner?: null | string;
remove?: null | ("Description" | "Icon" | "DefaultPermissions")[];
}

`Optional` archived?: null | boolean

`Optional` description?: null | string

`Optional` icon?: null | string

`Optional` name?: null | string

`Optional` nsfw?: null | boolean

`Optional` owner?: null | string

`Optional` remove?: null | ("Description" | "Icon" | "DefaultPermissions")[]