Données

Certaines choses n’ont pas de classe à elles : vous les obtenez sous forme d’objets simples, avec les champs de Discord écrits en camelCase. Elles n’ont pas de méthodes, et rien sur elles n’envoie de requête.

Les structures qui ont leur propre page sont listées dans la vue d’ensemble. Ce que contient un message quand vous en envoyez un est dans Options des messages.

Deux choses valent partout sur cette page :

Une date est un string au format ISO 8601 ('2026-10-06T12:00:00.000000+00:00') : new Date(value) la transforme en Date.
Un utilisateur dans des données simples est lui aussi une donnée simple (id, username, globalName, avatar…), pas un User. Seul Ban contient un vrai User.

import type { Message } from 'chapterjs';

function images(message: Message) {
  return message.attachments.filter(file => file.contentType?.startsWith('image/'));
}

Attachment

Un fichier joint à un message. Vous les lisez dans message.attachments.

Snowflake

requis

L’identifiant de la pièce jointe.

string

requis

Le nom du fichier.

string

Le titre du fichier.

string

Ce que montre le fichier, pour les personnes qui ne peuvent pas le voir (1024 caractères au plus).

string

Le type de média du fichier (image/png).

number

requis

La taille du fichier, en octets.

string

requis

L’URL du fichier.

string

requis

L’URL du fichier à travers le relais de Discord.

number | null

La hauteur, pour une image ou une vidéo.

number | null

La largeur, pour une image ou une vidéo.

string

Un tout petit aperçu flou d’une image ou d’une vidéo, sous forme de thumbhash.

number

La version de cet aperçu.

boolean

Si le fichier appartient à un message éphémère : il disparaît avec lui.

number

La durée d’un fichier audio ou vidéo, en secondes.

string

La forme d’onde échantillonnée d’un message vocal, en base64.

number

Les drapeaux de la pièce jointe, sous forme de champ de bits.

object[]

Pour un clip d’un stream, les utilisateurs qui étaient dans le stream (données simples).

string

Pour un clip d’un stream, quand il a été enregistré.

object | null

Pour un clip d’un stream, l’application qui était streamée, quand Discord l’a reconnue (données simples).

Documentation de Discord

Reaction

Les réactions d’un emoji sur un message. Vous les lisez dans message.reactions, une entrée par emoji.

number

requis

Combien de fois l’emoji a été utilisé, super réactions comprises.

object

requis

Le même nombre, détaillé.

Afficher champs

number

requis

Combien de réactions normales.

number

requis

Combien de super réactions.

boolean

requis

Si le bot a réagi avec cet emoji.

boolean

requis

Si le bot a fait une super réaction avec cet emoji.

object

requis

L’emoji.

Afficher champs

Snowflake | null

L’identifiant d’un emoji personnalisé ; null pour un emoji standard.

string | null

Le nom d’un emoji personnalisé, ou le caractère d’un emoji standard.

boolean

Si un emoji personnalisé est animé.

string[]

requis

Les couleurs des super réactions, sous forme de texte hexadécimal.

Pour réagir ou lire qui a réagi, voir Message : react(), fetchReactionUsers(). Documentation de Discord

ReactionEmoji

L’emoji d’une réaction : un emoji standard n’a qu’un name ("👍"), un emoji personnalisé a aussi un id. Les événements de réactions en donnent un.

Snowflake | null

requis

L’identifiant d’un emoji personnalisé ; null pour un emoji standard.

string | null

requis

Le nom d’un emoji personnalisé, ou le caractère d’un emoji standard.

boolean

Si un emoji personnalisé est animé.

Documentation de Discord

ForumTag

Une étiquette que peuvent avoir les publications d’un forum. Vous les lisez dans forum.availableTags, et les passez dans availableTags quand vous créez ou modifiez un salon forum.

Snowflake

requis

L’identifiant de l’étiquette.

string

requis

Le nom de l’étiquette (0 à 20 caractères).

boolean

requis

Si seuls les membres avec la permission ManageThreads peuvent ajouter l’étiquette à une publication ou la retirer.

Snowflake | null

requis

L’identifiant d’un emoji personnalisé du serveur affiché à côté de l’étiquette.

string | null

requis

Un emoji standard affiché à côté de l’étiquette, sous forme de son caractère.

Une étiquette a soit emojiId, soit emojiName, ou aucun des deux. Documentation de Discord

ThreadMember

Quelqu’un dans un fil, et depuis quand. thread.fetchMembers() en renvoie une liste.

Snowflake

L’identifiant du fil.

Snowflake

L’identifiant de l’utilisateur.

string

requis

Quand l’utilisateur a rejoint le fil pour la dernière fois.

number

requis

Les réglages de l’utilisateur pour le fil, sous forme de champ de bits ; aujourd’hui seulement les notifications.

Pour obtenir le membre derrière, utilisez guild.fetchMember(threadMember.userId). Documentation de Discord

PermissionOverwrite

Ce qu’un rôle ou un membre a le droit ou non de faire dans un salon. Vous les lisez dans channel.permissionOverwrites.

Snowflake

requis

L’identifiant du rôle ou du membre.

'role' | 'member'

requis

S’il s’applique à un rôle ou à un membre.

Permissions

requis

Ce qui est autorisé, quoi que dise le serveur.

Permissions

requis

Ce qui est refusé, quoi que dise le serveur.

allow et deny sont des ensembles Permissions, donc overwrite.allow.has('SendMessages') fonctionne. Pour changer un remplacement, utilisez channel.setPermissions() et channel.deletePermissions() ; le champ permissionOverwrites de ChannelCreateOptions a une autre forme, celle que prend Discord. Documentation de Discord

Ban

Un bannissement d’un serveur. guild.fetchBan() en renvoie un, guild.fetchBans() une liste.

User

requis

Qui est banni.

string | null

requis

Pourquoi, quand une raison a été donnée.

Documentation de Discord

AuditLog

Ce que les modérateurs et les bots ont fait sur un serveur : ses entrées, de la plus récente à la plus ancienne, et ce à quoi elles font référence. guild.fetchAuditLog() en renvoie un.

object[]

requis

Les entrées, de la plus récente à la plus ancienne.

Afficher champs d’une entrée

Snowflake

requis

L’identifiant de l’entrée.

AuditLogEvent

requis

Ce qui s’est passé : une valeur de AuditLogEvent.

string | null

requis

L’identifiant de ce qui a été touché : un webhook, un utilisateur, un rôle…

Snowflake | null

requis

L’identifiant de l’utilisateur ou de l’app qui l’a fait.

string

La raison donnée (1 à 512 caractères).

object[]

Ce qui a changé sur la cible.

Afficher champs d’un changement

string

requis

Le nom de ce qui a changé, avec quelques exceptions que liste Discord.

unknown

La valeur avant.

unknown

La valeur après.

object

Plus de détails pour certaines sortes d’entrées. Chaque champ peut manquer ; les nombres et les jours sont du texte, tels que Discord les envoie.

Afficher champs

Snowflake

L’identifiant de l’app dont les permissions ont été changées.

string

Le nom de la règle de modération automatique qui s’est déclenchée.

string

Ce qui déclenche cette règle.

Snowflake

Le salon où c’est arrivé.

string

Combien de choses ont été touchées.

string

Au bout de combien de jours d’inactivité les membres ont été retirés.

Snowflake

L’identifiant du rôle ou du membre dont le remplacement a changé.

string

Combien de membres le nettoyage a retirés.

Snowflake

L’identifiant du message épinglé ou désépinglé.

string

Le nom du rôle, quand type vaut "0".

string

De qui le remplacement a changé : "0" un rôle, "1" un membre.

string

La sorte d’intégration qui l’a fait.

string

Le nouveau statut du salon vocal.

object[]

requis

Les utilisateurs auxquels font référence les entrées (données simples).

object[]

requis

Les webhooks auxquels font référence les entrées (données simples).

object[]

requis

Les fils auxquels font référence les entrées (données simples).

object[]

requis

Les intégrations auxquelles font référence les entrées, en partie (données simples).

object[]

requis

Les commandes auxquelles font référence les entrées (données simples).

AutoModerationRule[]

requis

Les règles de modération automatique auxquelles font référence les entrées.

ScheduledEvent[]

requis

Les événements programmés auxquels font référence les entrées.

Documentation de Discord

AuditLogEntry

Une chose qu’un modérateur ou un bot a faite sur un serveur : quoi, par qui, sur quoi, et ce qui a changé. auditLogEntryCreate en donne une ; ses champs sont ceux d’une entrée de AuditLog : id, actionType, targetId, userId, reason, changes et options. Documentation de Discord

ScheduledEvent

Un événement programmé sur un serveur : quand il a lieu, où, et à quelle fréquence. guild.fetchScheduledEvents() en renvoie une liste, guild.createScheduledEvent() celui qu’il a créé.

Snowflake

requis

L’identifiant de l’événement.

Snowflake

requis

L’identifiant du serveur.

Snowflake | null

requis

L’identifiant du salon où a lieu l’événement ; null quand il a lieu hors de Discord.

Snowflake | null

L’identifiant de l’utilisateur qui a créé l’événement.

string

requis

Le nom de l’événement (1 à 100 caractères).

string | null

La description de l’événement (1 à 1000 caractères).

string

requis

Quand l’événement commence.

string | null

requis

Quand l’événement se termine ; toujours réglé pour un événement hors de Discord.

requis

Qui peut voir l’événement : 2, les membres du serveur.

1 | 2 | 3 | 4

requis

1 programmé, 2 en cours, 3 terminé, 4 annulé.

1 | 2 | 3

requis

Où il a lieu : 1 un salon de conférence, 2 un salon vocal, 3 hors de Discord.

Snowflake | null

requis

L’identifiant de ce à quoi l’événement est lié, quand il y en a un.

object | null

requis

Plus de détails sur le lieu.

Afficher champs

string

Où a lieu l’événement, pour un événement hors de Discord (1 à 100 caractères).

object

L’utilisateur qui a créé l’événement (données simples).

number

Combien d’utilisateurs sont intéressés par l’événement.

string | null

Le hash de l’image de couverture.

object | null

requis

À quelle fréquence l’événement se répète ; null quand il n’a lieu qu’une fois.

Afficher champs

string

requis

Quand la répétition commence.

string | null

requis

Quand la répétition se termine.

0 | 1 | 2 | 3

requis

0 chaque année, 1 chaque mois, 2 chaque semaine, 3 chaque jour.

number

requis

L’espacement entre deux occurrences, en unités de frequency : chaque semaine avec un intervalle de 2 veut dire une semaine sur deux.

number[] | null

requis

Les jours de la semaine où il se répète, de 0 (lundi) à 6 (dimanche).

object[] | null

requis

Des jours d’une semaine donnée du mois : { n, day }, avec n la semaine (1 à 5) et day le jour.

number[] | null

requis

Les mois où il se répète, de 1 (janvier) à 12 (décembre).

number[] | null

requis

Les jours du mois où il se répète.

number[] | null

requis

Les jours de l’année où il se répète (1 à 364).

number | null

requis

Combien de fois il se répète avant de s’arrêter.

Documentation de Discord

AutoModerationRule

Une règle que Discord applique tout seul aux messages d’un serveur : ce qui la déclenche, et ce qu’elle fait alors. guild.fetchAutoModerationRules() en renvoie une liste.

Snowflake

requis

L’identifiant de la règle.

Snowflake

requis

L’identifiant du serveur.

string

requis

Le nom de la règle.

Snowflake

requis

L’identifiant de l’utilisateur qui a créé la règle.

1 | 2

requis

Quand la règle est vérifiée : 1 un membre envoie ou modifie un message, 2 un membre modifie son profil.

1 | 3 | 4 | 5 | 6

requis

Ce qui la déclenche : 1 des mots d’une liste, 3 du spam, 4 des mots d’une liste prédéfinie de Discord, 5 trop de mentions, 6 des mots d’une liste dans le profil d’un membre.

object

requis

Les détails du déclencheur. Les champs présents dépendent de triggerType.

Afficher champs

string[]

Les mots ou parties de mots recherchés (1000 au plus).

string[]

Les expressions régulières testées sur le contenu (10 au plus).

number[]

Les listes prédéfinies de Discord recherchées : 1 grossièretés, 2 contenu sexuel, 3 insultes.

string[]

Les mots qui ne déclenchent jamais la règle (100 ou 1000 au plus, selon le déclencheur).

number

Combien de rôles et d’utilisateurs différents un message peut mentionner (50 au plus).

boolean

Si les raids de mentions sont détectés tout seuls.

object[]

requis

Ce qui se passe quand la règle se déclenche.

Afficher champs d’une action

1 | 2 | 3 | 4

requis

1 bloquer le message, 2 envoyer une alerte dans un salon, 3 exclure temporairement le membre, 4 empêcher le membre d’utiliser le texte, le vocal et les autres interactions.

object

Ce dont l’action a besoin.

Afficher champs

Snowflake

Le salon où l’alerte est envoyée.

number

Combien de temps dure l’exclusion, en secondes.

string | null

Ce qui est dit au membre quand son message est bloqué.

boolean

requis

Si la règle est active.

Snowflake[]

requis

Les identifiants des rôles que la règle ignore (20 au plus).

Snowflake[]

requis

Les identifiants des salons que la règle ignore (50 au plus).

Documentation de Discord

Sticker

Un sticker : celui d’un serveur, ou un sticker standard d’un pack. guild.fetchStickers() renvoie ceux d’un serveur.

Snowflake

requis

L’identifiant du sticker.

Snowflake

Pour un sticker standard, l’identifiant de son pack.

string

requis

Le nom du sticker.

string | null

requis

La description du sticker.

string

requis

Les mots qui suggèrent le sticker pendant la saisie (200 caractères au plus).

1 | 2

requis

1 un sticker standard d’un pack, 2 un sticker d’un serveur.

1 | 2 | 3 | 4

requis

Le format de l’image : 1 PNG, 2 APNG, 3 Lottie, 4 GIF.

boolean

Si le sticker d’un serveur peut être utilisé ; false quand le serveur a perdu les boosts nécessaires.

Snowflake

L’identifiant du serveur à qui appartient le sticker.

object

L’utilisateur qui a téléversé le sticker (données simples).

number

La place d’un sticker standard dans son pack.

Pour en envoyer un, passez son identifiant dans les stickers d’un message : voir Options des messages. Documentation de Discord

VoiceState

Où se trouve quelqu’un en vocal, et comment : micro coupé, casque coupé, en stream… Les événements vocaux en donnent un.

Snowflake | null

requis

L’identifiant du salon vocal où se trouve la personne.

Snowflake

requis

L’identifiant de la personne.

string

requis

L’identifiant de sa session vocale.

boolean

requis

Si le serveur lui a coupé le son.

boolean

requis

Si le serveur lui a coupé le micro.

boolean

requis

Si la personne a coupé son casque.

boolean

requis

Si la personne a coupé son micro.

boolean

Si la personne diffuse avec Go Live.

boolean

requis

Si sa caméra est allumée.

boolean

requis

Si la personne ne peut pas parler (dans un salon de conférence, un membre du public).

string | null

requis

Quand la personne a demandé la parole, dans un salon de conférence.

Documentation de Discord

UserPresence

Si quelqu’un est en ligne et ce qu’il fait : son statut, ses activités, et sur quels appareils. presenceUpdate en donne une.

'online' | 'idle' | 'dnd' | 'offline'

requis

Son statut.

object[]

requis

Ce que fait la personne, la première étant ce que Discord affiche.

Afficher champs d’une activité

string

requis

Le nom de l’activité : le jeu, le service de musique…

0 | 1 | 2 | 3 | 4 | 5

requis

0 joue, 1 diffuse, 2 écoute, 3 regarde, 4 un statut personnalisé, 5 participe à une compétition.

string | null

Le lien d’un stream.

number

requis

Quand l’activité a commencé, en millisecondes depuis 1970.

object

Quand la partie a commencé ou finit : start et end, en millisecondes depuis 1970.

Snowflake

L’identifiant de l’application du jeu.

string | null

Ce que la personne y fait.

string | null

L’état de son groupe, ou le texte d’un statut personnalisé.

object | null

L’emoji d’un statut personnalisé (données simples).

object

Son groupe : id, et size sous la forme [actuel, max].

object

Les images de l’activité et leurs textes (données simples).

boolean

Si c’est une session de jeu instanciée.

number

Ce que contient l’activité, en champ de bits.

object

requis

Son statut sur chaque sorte d’appareil utilisé ; un appareil non utilisé est absent.

Afficher champs

string

Sur une application d’ordinateur.

string

Sur un téléphone.

string

Dans un navigateur.

string

En réalité virtuelle.

Documentation de Discord

Référence

Vos fichiers

Structures

Types

CLI

Attachment

Reaction

ReactionEmoji

ForumTag

ThreadMember

PermissionOverwrite

Ban

AuditLog

AuditLogEntry

ScheduledEvent

AutoModerationRule

Sticker

VoiceState

UserPresence