discord.js | GuildTextThreadManager

Search...

GuildTextThreadManager

export class GuildTextThreadManager<AllowedThreadType> extends ThreadManager<false>

export class GuildTextThreadManager<AllowedThreadType> extends ThreadManager<false>

Manages API methods for ThreadChannel objects and stores their cache.

Extends

ThreadManager<false>

Name	Constraints	Optional	Default	Description
AllowedThreadType		No		None

cache:Collection<Snowflake, ThreadChannel>

The cache of this Manager

channel:TextChannel | NewsChannel

The channel this Manager belongs to

Readonly

client:Client

The client that instantiated this Manager

Readonly

holds:Constructable<Holds>

The data structure belonging to this manager.

Inherited from DataManager

create(options):Promise<ThreadChannel>

Creates a new thread in the channel.

Example

// Create a new public thread
channel.threads
  .create({
    name: 'food-talk',
    autoArchiveDuration: ThreadAutoArchiveDuration.OneHour,
    reason: 'Needed a separate thread for food',
  })
  .then(threadChannel => console.log(threadChannel))
  .catch(console.error);

// Create a new public thread
channel.threads
  .create({
    name: 'food-talk',
    autoArchiveDuration: ThreadAutoArchiveDuration.OneHour,
    reason: 'Needed a separate thread for food',
  })
  .then(threadChannel => console.log(threadChannel))
  .catch(console.error);

Example

// Create a new private thread
channel.threads
  .create({
     name: 'mod-talk',
     autoArchiveDuration: ThreadAutoArchiveDuration.OneHour,
     type: ChannelType.PrivateThread,
     reason: 'Needed a separate thread for moderation',
   })
  .then(threadChannel => console.log(threadChannel))
  .catch(console.error);

// Create a new private thread
channel.threads
  .create({
     name: 'mod-talk',
     autoArchiveDuration: ThreadAutoArchiveDuration.OneHour,
     type: ChannelType.PrivateThread,
     reason: 'Needed a separate thread for moderation',
   })
  .then(threadChannel => console.log(threadChannel))
  .catch(console.error);

Name	Type	Optional	Description
options	GuildTextThreadCreateOptions<AllowedThreadType>	No	Options to create a new thread

fetch(options, cacheOptions?):Promise<AnyThreadChannel | null>

Obtains a thread from Discord, or the channel cache if it's already available.

Returns

FetchedThreads if active & FetchedThreadsMore if archived.

Example

// Fetch a thread by its id
channel.threads.fetch('831955138126104859')
  .then(channel => console.log(channel.name))
  .catch(console.error);

// Fetch a thread by its id
channel.threads.fetch('831955138126104859')
  .then(channel => console.log(channel.name))
  .catch(console.error);

Name	Type	Optional	Description
options	ThreadChannelResolvable	No	The options to fetch threads. If it is a ThreadChannelResolvable then the specified thread will be fetched. Fetches all active threads if `undefined`
cacheOptions	BaseFetchOptions	Yes	Additional options for this fetch. The `force` field gets ignored if `options` is not a ThreadChannelResolvable

fetchActive(cache?):Promise<FetchedThreads>

Obtains all active threads in the channel.

Name	Type	Optional	Description
cache	boolean	Yes	Whether to cache the fetched data

Inherited from ThreadManager

fetchArchived(options?, cache?):Promise<FetchedThreadsMore>

Obtains a set of archived threads from Discord. This method requires the PermissionFlagsBits.ReadMessageHistory permission in the parent channel.

Name	Type	Optional	Description
options	FetchArchivedThreadOptions	Yes	The options to fetch archived threads
cache	boolean	Yes	Whether to cache the new thread objects if they aren't already

Inherited from ThreadManager

resolve(thread):ThreadChannel

Resolves a ThreadChannelResolvable to a ThreadChannel object.

Name	Type	Optional	Description
thread	ThreadChannelResolvable	No	The ThreadChannel resolvable to resolve

Inherited from ThreadManager

resolveId(thread):Snowflake

Resolves a ThreadChannelResolvable to a ThreadChannel id.

Name	Type	Optional	Description
thread	ThreadChannelResolvable	No	The ThreadChannel resolvable to resolve

Inherited from ThreadManager

valueOf():Collection<Key, Holds>