> ## Documentation Index
> Fetch the complete documentation index at: https://www.chapterjs.org/llms.txt
> Use this file to discover all available pages before exploring further.

# GuildEmoji

> Lire, afficher, renommer et supprimer les emojis personnalisés d’un serveur

Un `GuildEmoji` est un emoji personnalisé d’un serveur. Vous en obtenez un depuis `guild.emojis`, `guild.fetchEmojis()` ou `guild.createEmoji()`. En mettre un dans un texte l’affiche.

```ts theme={"theme":{"light":"github-light","dark":"vesper"}}
import type { Guild } from 'chapterjs';

async function welcome(guild: Guild) {
  const emoji = [...guild.emojis.values()].find(emoji => emoji.name === 'party');
  const channel = guild.channels.get(guild.systemChannelId ?? '');
  if (!emoji || !channel?.isTextBased()) return;
  await channel.send(`Bienvenue ! ${emoji}`);
}
```

> [!NOTE]
>
> Comment mettre un emoji dans un message ou réagir avec est dans [Messages](https://www.chapterjs.org/fr/messages.md). Un emoji standard (🎉) est un texte, pas un `GuildEmoji`.

## Propriétés

**id** `Snowflake`

L’identifiant unique que Discord lui a donné.

**createdAt** `Date`

Quand il a été créé : un identifiant Discord contient sa date de création.

**guildId** `Snowflake`

L’identifiant du serveur de l’emoji.

**name** `string`

Le nom de l’emoji, sans les deux-points.

**animated** `boolean`

Si l’emoji bouge.

**available** `boolean`

`false` quand le serveur a perdu les boosts qui lui donnaient cet emoji.

**managed** `boolean`

Si l’emoji appartient à une intégration.

**roleIds** `readonly Snowflake[]`

Les identifiants des rôles autorisés à utiliser l’emoji ; vide pour tout le monde.

## Helpers

Ils lisent ce dont le bot se souvient : ils n’envoient jamais de requête.

### url()

```ts theme={"theme":{"light":"github-light","dark":"vesper"}}
url(options?: ImageOptions): string
```

L’URL de l’image de l’emoji. Voir [ImageOptions](https://www.chapterjs.org/fr/reference/helpers.md#imageoptions).

### toString()

```ts theme={"theme":{"light":"github-light","dark":"vesper"}}
toString(): string
```

`<:name:id>` : affiche l’emoji quand il est mis dans un message.

### toJSON()

```ts theme={"theme":{"light":"github-light","dark":"vesper"}}
toJSON(): object
```

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

## Actions

### edit()

```ts theme={"theme":{"light":"github-light","dark":"vesper"}}
edit(
  options: { name?: string; roles?: (Snowflake | { id: Snowflake })[] | null },
  reason?: string
): Promise<GuildEmoji>
```

Renomme l’emoji, ou change les rôles qui peuvent l’utiliser.

[Documentation de Discord](https://docs.discord.com/developers/resources/emoji#modify-guild-emoji)

### delete()

```ts theme={"theme":{"light":"github-light","dark":"vesper"}}
delete(reason?: string): Promise<void>
```

Supprime l’emoji.

[Documentation de Discord](https://docs.discord.com/developers/resources/emoji#delete-guild-emoji)

## Types

`ImageOptions` est dans [Helpers](https://www.chapterjs.org/fr/reference/helpers.md#imageoptions). Pour ajouter un emoji à un serveur, voir [`guild.createEmoji()`](https://www.chapterjs.org/fr/reference/guild#createemoji).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.