EmojiManager

Gère le cache des émojis personnalisés d'un serveur. Instancié par serveur (guild.emojis) — étend BaseManager. Ajouté en 1.5.0.

Notation des signatures

Les signatures sont écrites en notation TypeScript, mais s'appellent à l'identique en JavaScript — voir Utiliser le SDK en JavaScript.

Le cache (guild.emojis.cache) est une Collection<string, Emoji> indexée par publicId — voir Emoji pour la structure complète.

Méthodes

fetchAll(cache = true): Promise<Emoji[]>

Récupère tous les émojis personnalisés du serveur. Vide et repeuple cache si cache vaut true (par défaut).

TypeScript

const emojis = await guild.emojis.fetchAll();
const partyParrot = emojis.find((e) => e.name === "party_parrot");

JavaScript

const emojis = await guild.emojis.fetchAll();
const partyParrot = emojis.find((e) => e.name === "party_parrot");

create(options): Promise<Emoji>

Ajoute un nouvel émoji personnalisé au serveur. Nouveau en 1.5.0 — cette action n'était pas exposée auparavant sur Guild.

create(options: { name: string; imageUrl: string; isAnimated?: boolean }): Promise<Emoji>

Paramètre	Type	Requis	Description
options.name	string	Oui	Nom de l'émoji — alphanumérique et underscores uniquement, 2 à 32 caractères.
options.imageUrl	string	Oui	URL directe de l'image source.
options.isAnimated	boolean	Non	true si l'image est un GIF animé.

Ajoute automatiquement l'émoji créé à cache. Rejette (BloumeChatAPIError, statut 400) si name ne respecte pas le format attendu.

TypeScript

const emoji = await guild.emojis.create({
  name: "party_parrot",
  imageUrl: "https://cdn.example.com/party-parrot.gif",
  isAnimated: true,
});
await message.reply(`Ambiance ${emoji}`);

JavaScript

const emoji = await guild.emojis.create({
  name: "party_parrot",
  imageUrl: "https://cdn.example.com/party-parrot.gif",
  isAnimated: true,
});
await message.reply(`Ambiance ${emoji}`);

delete(emojiId): Promise<void>

Supprime un émoji personnalisé par son publicId. Retire aussi l'entrée de cache.

TypeScript

await guild.emojis.delete(emoji.id);

JavaScript

await guild.emojis.delete(emoji.id);

Guild.fetchEmojis() / Guild.deleteEmoji() délèguent ici

Les raccourcis historiques sur Guild appellent respectivement guild.emojis.fetchAll() et guild.emojis.delete() — même comportement. guild.emojis.create() en revanche n'a pas d'équivalent raccourci sur Guild : c'est la seule façon de créer un émoji via le SDK.

Voir aussi

• Emoji — la structure gérée par ce manager (toString(), delete()).
• Guild — fetchEmojis() / deleteEmoji(), les raccourcis historiques.
• Webhooks, emojis & invitations.