Class ForumChannel

Represents a forum channel.

Hierarchy (view full)

GuildChannel
- ForumChannel

Index

Constructors

constructor

new ForumChannel(data, client): ForumChannel
Parameters
- data: {
      archivedAt?: string;
      archivedBy?: string;
      categoryId?: number;
      createdAt: string;
      createdBy: string;
      groupId: string;
      id: string;
      messageId?: string;
      name: string;
      parentId?: string;
      priority?: number;
      rootId?: string;
      serverId: string;
      topic?: string;
      type: ServerChannelType;
      updatedAt?: string;
      visibility?: null | "private" | "public";
  }
  raw data
  - OptionalarchivedAt?: string
    Archived at Format: date-time
    
    Description
    The ISO 8601 timestamp that the channel was archived at, if relevant
  - OptionalarchivedBy?: string
    Archived by
    
    Description
    The ID of the user who archived this channel
  - OptionalcategoryId?: number
    Description
    The category that the channel exists in. Only relevant for server channels
  - createdAt: string
    Created at Format: date-time
    
    Description
    The ISO 8601 timestamp that the channel was created at
  - createdBy: string
    Created by
    
    Description
    The ID of the user who created this channel
  - groupId: string
    Group ID
    
    Description
    The ID of the group
  - id: string
    Channel ID Format: uuid
    
    Description
    The ID of the channel
  - OptionalmessageId?: string
    Message ID Format: uuid
    
    Description
    The ID of the message that this channel was created off of. Only applicable to "chat", "voice", and "stream" channels and indicates that this channel is a thread, if present
  - name: string
    Description
    The name of the channel
  - OptionalparentId?: string
    Channel ID Format: uuid
    
    Description
    ID of the immediate parent channel or thread in the channel hierarchy. Only applicable to "chat", "voice", and "stream" channels and indicates that this channel is a thread, if present
  - Optionalpriority?: number
    Priority
    
    Description
    The priority of the channel will determine its position relative to other categories in the group. The higher the value, the higher up it will be displayed in the UI. Returned values can be null, in which case sorting will be done by createdAt in ascending order. Due to legacy issues, sending a null value is not possible
  - OptionalrootId?: string
    Channel ID Format: uuid
    
    Description
    ID of the root channel or thread in the channel hierarchy. Only applicable to "chat", "voice", and "stream" channels and indicates that this channel is a thread, if present
  - serverId: string
    Server ID
    
    Description
    The ID of the server
  - Optionaltopic?: string
    Description
    The topic of the channel. Not applicable to threads
  - type: ServerChannelType
    Description
    The type of channel. This will determine what routes to use for creating content in a channel. For example, if this "chat", then one must use the routes for creating channel messages
  - OptionalupdatedAt?: string
    Updated at Format: date-time
    
    Description
    The ISO 8601 timestamp that the channel was updated at, if relevant
  - Optionalvisibility?: null | "private" | "public"
    Description
    What users can access the channel. Only applicable to server channels. If not present, this channel will respect normal permissions. public is accessible to everyone, even those who aren't of the server. private is only accessible to explicitly mentioned users. Currently, threads cannot be public and other channels cannot be private. Additionally, private threads can only exist with an associated messageId that is for a private message
- client: Client
  client
Returns ForumChannel
Overrides GuildChannel.constructor
- Defined in lib/structures/ForumChannel.ts:29

Properties

archivedAt

archivedAt: null | Date

When the channel was last archived.

archivedBy

archivedBy: null | string

ID of the member that archived the channel (if archived)

categoryID

categoryID: null | number

ID of the category the channel is in.

client

client: Client

App's client.

createdAt

createdAt: Date

When this channel was created.

creatorID

creatorID: string

ID of the member who created this channel.

description

description: null | string

Channel description

editedTimestamp

editedTimestamp: null | Date

Timestamp at which this channel was last edited.

groupID

groupID: string

ID of the group the channel is in.

guildID

guildID: string

Guild ID

id

id: string

Item ID

isPublic

isPublic: boolean

If the channel is public, this boolean is set to true.

name

name: string

Channel name

parentID

parentID: null | string

ID of the parent category.

threads

threads: TypedCollection<number, {
    bumpedAt?: string;
    channelId: string;
    content: string;
    createdAt: string;
    createdBy: string;
    groupId: string;
    id: number;
    isLocked: boolean;
    isPinned: boolean;
    mentions?: {
        channels?: {
            id: string;
        }[];
        everyone?: boolean;
        here?: boolean;
        roles?: {
            id: number;
        }[];
        users?: {
            id: string;
        }[];
    };
    serverId: string;
    title: string;
    updatedAt?: string;
}, ForumThread<ForumChannel>, []>

Cached threads.

Type declaration

OptionalbumpedAt?: string
Bumped at Format: date-time

Description
The ISO 8601 timestamp that the forum topic was bumped at. This timestamp is updated whenever there is any activity on the posts within the forum topic.
channelId: string
Channel ID Format: uuid

Description
The ID of the channel
content: string
Content Format: long-form markdown

Description
The content of the forum topic
createdAt: string
Created at Format: date-time

Description
The ISO 8601 timestamp that the forum topic was created at
createdBy: string
Created by

Description
The ID of the user who created this forum topic (Note: If this event has createdByWebhookId present, this field will still be populated, but can be ignored. In this case, the value of this field will always be Ann6LewA)
groupId: string
Group ID

Description
The ID of the group
id: number
Description
The ID of the forum topic
isLocked: boolean
Is locked
Default
```
false
```
isPinned: boolean
Is pinned
Default
```
false
```
Optionalmentions?: {
    channels?: {
        id: string;
    }[];
    everyone?: boolean;
    here?: boolean;
    roles?: {
        id: number;
    }[];
    users?: {
        id: string;
    }[];
}
- Optionalchannels?: {
  id: string;
  }[]
  Channels
  
  Description
  Info on mentioned channels
- Optionaleveryone?: boolean
  Everyone
  
  Description
  If
  
  Everyone
  was mentioned
- Optionalhere?: boolean
  Here
  
  Description
  If
  
  Here
  was mentioned
- Optionalroles?: {
  id: number;
  }[]
  Roles
  
  Description
  Info on mentioned roles
- Optionalusers?: {
  id: string;
  }[]
  Users
  
  Description
  Info on mentioned users
serverId: string
Server ID

Description
The ID of the server
title: string
Title

Description
The title of the forum topic
OptionalupdatedAt?: string
Updated at Format: date-time

Description
The ISO 8601 timestamp that the forum topic was updated at, if relevant

type

type: string

Channel type

visibility

visibility: string

Channel visibility

Methods

createThread

createThread(options): Promise<ForumThread<ForumChannel>>
Create a thread in this channel.
Parameters
- options: CreateForumThreadOptions
  Thread's options including title & content.
Returns Promise<ForumThread<ForumChannel>>
- Defined in lib/structures/ForumChannel.ts:42

delete

delete(): Promise<void>
Delete the channel.

Returns Promise<void>
Inherited from GuildChannel.delete
- Defined in lib/structures/GuildChannel.ts:135

deleteThread

deleteThread(threadID): Promise<void>
Delete a thread from this channel.
Parameters
- threadID: number
  ID of a thread.
Returns Promise<void>
- Defined in lib/structures/ForumChannel.ts:49

edit

edit(options): Promise<Channel>
Edit the channel.
Parameters
- options: EditChannelOptions
Returns Promise<Channel>
Inherited from GuildChannel.edit
- Defined in lib/structures/GuildChannel.ts:139

editThread

editThread(threadID, options): Promise<ForumThread<ForumChannel>>
Edit a thread from this channel.
Parameters
- threadID: number
  ID of a thread.
- options: EditForumThreadOptions
  Edit options.
Returns Promise<ForumThread<ForumChannel>>
- Defined in lib/structures/ForumChannel.ts:57

lockThread

lockThread(threadID): Promise<void>
Lock a thread.
Parameters
- threadID: number
  ID of a thread.
Returns Promise<void>
- Defined in lib/structures/ForumChannel.ts:64

pinThread

pinThread(threadID): Promise<void>
Pin a thread.
Parameters
- threadID: number
  ID of a thread.
Returns Promise<void>
- Defined in lib/structures/ForumChannel.ts:71

restore

restore(): Promise<void>
Restore the archived channel

Returns Promise<void>
Inherited from GuildChannel.restore
- Defined in lib/structures/GuildChannel.ts:143

toJSON

toJSON(): JSONForumChannel
Returns JSONForumChannel
Overrides GuildChannel.toJSON
- Defined in lib/structures/ForumChannel.ts:75

unlockThread

unlockThread(threadID): Promise<void>
Unlock a thread.
Parameters
- threadID: number
  ID of a thread.
Returns Promise<void>
- Defined in lib/structures/ForumChannel.ts:85

unpinThread

unpinThread(threadID): Promise<void>
Unpin a thread.
Parameters
- threadID: number
  ID of a thread.
Returns Promise<void>
- Defined in lib/structures/ForumChannel.ts:92

Class ForumChannel

Hierarchy (view full)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

OptionalarchivedAt?: string

Description

OptionalarchivedBy?: string

Description

OptionalcategoryId?: number

Description

createdAt: string

Description

createdBy: string

Description

groupId: string

Description

id: string

Description

OptionalmessageId?: string

Description

name: string

Description

OptionalparentId?: string

Description

Optionalpriority?: number

Description

OptionalrootId?: string

Description

serverId: string

Description

Optionaltopic?: string

Description

type: ServerChannelType

Description

OptionalupdatedAt?: string

Description

Optionalvisibility?: null | "private" | "public"

Description

Returns ForumChannel

Properties

archivedAt

archivedBy

categoryID

client

createdAt

creatorID

description

editedTimestamp

groupID

guildID

id

isPublic

name

parentID

threads

Type declaration

OptionalbumpedAt?: string

Description

channelId: string

Description

content: string

Description

createdAt: string

Description

createdBy: string

Description

groupId: string

Description

id: number

Description

isLocked: boolean

Default

isPinned: boolean

Default

Optionalmentions?: { channels?: { id: string; }[]; everyone?: boolean; here?: boolean; roles?: { id: number; }[]; users?: { id: string; }[]; }

`Optional`archivedAt?: string

`Optional`archivedBy?: string

`Optional`categoryId?: number

`Optional`messageId?: string

`Optional`parentId?: string

`Optional`priority?: number

`Optional`rootId?: string

`Optional`topic?: string

`Optional`updatedAt?: string

`Optional`visibility?: null | "private" | "public"

`Optional`bumpedAt?: string

`Optional`mentions?: {
channels?: {
id: string;
}[];
everyone?: boolean;
here?: boolean;
roles?: {
id: number;
}[];
users?: {
id: string;
}[];
}

`Optional`channels?: {
id: string;
}[]

`Optional`everyone?: boolean

`Optional`here?: boolean

`Optional`roles?: {
id: number;
}[]

`Optional`users?: {
id: string;
}[]

`Optional`updatedAt?: string