Passer au contenu principal
Un salon est l’endroit où les choses se passent dans Discord : un salon textuel, un salon vocal, une catégorie, un forum, un fil ou une conversation privée. Chaque sorte a sa propre classe, et toutes partagent ce qu’a Channel. Vous en obtenez un depuis guild.channels, message.channel, le channel d’une commande, ou une option channel.
Comment envoyer, modifier et lire des messages est dans Envoyer des messages. Cette page liste ce qu’ont les salons ; chaque sorte a sa propre page ci-dessous.

Quelle sorte de salon

Un salon obtenu depuis guild.channels ou message.channel peut être de n’importe quelle sorte. Demandez-le avant d’utiliser ce que seule une sorte possède : à l’intérieur du if, votre éditeur connaît la sorte. type dit la même chose sous forme de valeur de ChannelType : Une sorte que Discord a ajoutée après cette version reste utilisable : comme GuildChannel quand elle est dans un serveur, comme Channel sinon.

TextChannel

Un salon textuel ou d’annonces d’un serveur.

VoiceChannel

Un salon vocal ou de conférence : on y parle, et on peut aussi y écrire.

CategoryChannel

Une catégorie : elle regroupe des salons.

ForumChannel

Un salon forum ou média : il ne contient que des publications, qui sont des fils.

ThreadChannel

Un fil, ou une publication d’un forum.

DMChannel

Une conversation privée entre le bot et un utilisateur.

Channel

Un salon de n’importe quelle sorte. Utilisez les méthodes is...() pour savoir de quelle sorte il est et obtenir les propriétés et les actions de cette sorte. Chaque classe de cette section a ce qui est listé ici.

Propriétés

Snowflake
L’identifiant unique que Discord lui a donné.
Date
Quand il a été créé : un identifiant Discord contient sa date de création.
ChannelType
La sorte de salon, sous forme de valeur de ChannelType.
Snowflake | null
L’identifiant du serveur du salon ; null pour un salon privé.
Guild | null
Le serveur du salon ; null pour un salon privé.

Helpers

Ils lisent ce que le bot sait déjà : ils n’envoient jamais de requête.

isTextBased()

Si des messages peuvent y être envoyés.

isGuildChannel()

S’il appartient à un serveur et n’est pas un fil.

isText()

Un salon textuel ou d’annonces d’un serveur.

isVoice()

Un salon vocal ou de conférence.

isCategory()

Une catégorie, qui regroupe des salons.

isForum()

Un salon forum ou média, fait de publications.

isThread()

Un fil, ou une publication d’un forum.

isDM()

Une conversation privée.

toString()

<#id> : fait un lien vers le salon quand il est mis dans un message.

toJSON()

Les données de Discord sous forme d’objet simple, avec des noms en camelCase.

Lire depuis Discord

fetch()

Demande à Discord les dernières données du salon.

Actions

delete()

Supprime le salon (le ferme, pour une conversation privée). Documentation de Discord

GuildChannel

Un salon d’un serveur (pas un fil). TextChannel, VoiceChannel, CategoryChannel et ForumChannel ont tout ce qui est listé ici, plus ce qu’a Channel.

Propriétés

Snowflake
L’identifiant du serveur du salon.
Guild
Le serveur du salon.
string
Le nom du salon.
number
Où se trouve le salon dans la liste.
Snowflake | null
L’identifiant de la catégorie du salon, quand il est dans une.
CategoryChannel | null
La catégorie du salon, quand il est dans une et qu’elle est connue.
boolean
Si le salon est soumis à une limite d’âge.
PermissionOverwrite[]
Ce que les rôles et les membres ont le droit ou non de faire dans ce salon. Chaque entrée est un PermissionOverwrite.

Helpers

permissionsFor()

Ce qu’un membre peut faire dans ce salon : ses permissions sur le serveur, modifiées par les remplacements du salon. Documentation de Discord

Lire depuis Discord

fetchInvites()

Les invitations qui mènent à ce salon. Documentation de Discord

fetchWebhooks()

Les webhooks qui publient dans ce salon. Documentation de Discord

Actions

edit()

Modifie le salon. Les options sont un GuildChannelEditOptions. Documentation de Discord

setPermissions()

Autorise ou refuse des permissions à un rôle ou à un membre dans ce salon. Les permissions qui ne sont dans aucune des deux listes suivent le serveur. Documentation de Discord

deletePermissions()

Retire ce qui a été réglé pour un rôle ou un membre dans ce salon. Documentation de Discord

createInvite()

Crée une invitation vers ce salon. Les options sont un InviteCreateOptions. Documentation de Discord

createWebhook()

Crée un webhook qui publie dans ce salon : voir Webhook.
string
requis
Le nom du webhook (1 à 80 caractères).
string | null
L’image de l’avatar par défaut du webhook, sous forme de data URI (data:image/png;base64,...).
Documentation de Discord

Salons avec des messages

TextChannel, VoiceChannel, ThreadChannel et DMChannel peuvent tous envoyer et lire des messages : ils partagent les propriétés et méthodes de cette section. Ensemble, ils forment le type TextBasedChannel.

Propriétés

ReadonlyMap<Snowflake, Message>
Les messages du salon dont le bot se souvient.
Snowflake | null
L’identifiant du dernier message envoyé dans le salon, quand il est connu.
messages est vide sauf si l’un de vos fichiers demande de se souvenir des messages : voir ce dont le bot se souvient. fetchMessage() et fetchMessages() fonctionnent toujours.

Lire depuis Discord

fetchMessage()

Un message du salon : depuis la mémoire du bot, sinon depuis Discord. Documentation de Discord

fetchMessages()

Les derniers messages du salon, du plus récent au plus ancien. Les options sont un FetchMessagesOptions. Documentation de Discord

fetchPins()

Les messages épinglés du salon, le dernier épinglé en premier. Documentation de Discord

Actions

send()

Envoie un message dans le salon. Ce qu’elle accepte est un MessageInput. Documentation de Discord

bulkDelete()

Supprime plusieurs messages d’un coup. Les messages de plus de deux semaines ne peuvent pas être supprimés en masse : ils sont laissés de côté, et ne sont pas comptés dans le résultat. Renvoie combien de messages ont été supprimés. Documentation de Discord

sendTyping()

Affiche « le bot est en train d’écrire… » pendant 10 secondes, ou jusqu’à ce qu’il envoie un message. Documentation de Discord

Attendre

Elles attendent ce qui suit dans le salon, tant que votre bot tourne : un redémarrage termine l’attente. Comment les utiliser est dans le guide.

waitForMessage()

Attend le prochain message du salon qui convient : d’une personne (from), qui dit quelque chose (matches). Celui de n’importe qui sauf un bot par défaut. Donne le message, ou null quand within (une minute par défaut) est passé avant. Un redémarrage du bot termine l’attente.

collectMessages()

Rassemble les messages du salon qui conviennent, jusqu’à ce que within (une minute par défaut) soit passé ou que max soient arrivés. Les donne, dans l’ordre.

Types

TextBasedChannel

Tout salon où des messages peuvent être envoyés. C’est ce que donnent message.channel et interaction.channel ; isTextBased() restreint un Channel à ce type.

GuildTextBasedChannel

Tout salon d’un serveur où des messages peuvent être envoyés. C’est le channel d’un GuildMessage et d’une commande utilisée sur un serveur.

WaitForMessageOptions

Ce que prend waitForMessage().
PersonInput
Seulement un message de cette personne. N’importe qui sauf un bot par défaut.
string | RegExp | ((message: Message) => boolean)
Seulement un message qui dit ceci : un texte (le même, quelles que soient les majuscules et les espaces autour), une expression régulière, ou une fonction du message.
Duration
Combien de temps attendre : '30s', '2m'. Une minute par défaut, une seconde au moins, un jour au plus.

CollectMessagesOptions

Ce que prend collectMessages() : tout ce qu’a WaitForMessageOptions, et :
number
S’arrête une fois ce nombre de messages arrivés. Pas de limite par défaut : jusqu’à within.

PersonInput

Une personne, telle qu’une attente la prend : un utilisateur, un membre, ou un identifiant.

Ailleurs