---
url: https://docs.juniper.bot/message-templates/types/discord/role.md
description: Тип данных Role, используемый в шаблонном движке JuniperBot.
---

[Число]: /message-templates/types/index#literals

[Строка]: /message-templates/types/index#literals

[Логический]: /message-templates/types/index#literals

[Список]: /message-templates/types/index#lists

[Карта]: /message-templates/types/index#maps

[DateTime]: /message-templates/types/index#datetime

[TwitchChannel]: /message-templates/types/subscriptions/twitch#twitch-channel

[TwitchStream]: /message-templates/types/subscriptions/twitch#twitch-stream

[TwitchGame]: /message-templates/types/subscriptions/twitch#twitch-game

[YouTubeChannel]: /message-templates/types/subscriptions/youtube#youtube-channel

[YouTubeVideo]: /message-templates/types/subscriptions/youtube#youtube-video

[VkWallPost]: /message-templates/types/subscriptions/vk#vkwallpost

[Rank]: /message-templates/types/discord/rank

[Guild]: /message-templates/types/discord/guild

[Member]: /message-templates/types/discord/member

[Role]: /message-templates/types/discord/role

[Message]: /message-templates/types/discord/message

[Attachment]: /message-templates/types/discord/attachment

[Embed]: /message-templates/types/discord/embed

[Activity]: /message-templates/types/discord/activity

[MemberVoiceState]: /message-templates/types/discord/member-voice-state

[MemberPrimaryGuild]: /message-templates/types/discord/member-primary-guild

[MenuBuilder]: /message-templates/types/discord/menu-builder

[UserFlag]: /message-templates/types/discord/user-flag

[Permission]: /message-templates/types/discord/permission

[Category]: /message-templates/types/discord/category

[TextChannel]: /message-templates/types/discord/text-channel

[VoiceChannel]: /message-templates/types/discord/voice-channel

[NewsChannel]: /message-templates/types/discord/news-channel

[StageChannel]: /message-templates/types/discord/stage-channel

[ForumChannel]: /message-templates/types/discord/forum-channel

[MediaChannel]: /message-templates/types/discord/media-channel

[ThreadChannel]: /message-templates/types/discord/thread-channel

[Page]: /message-templates/types/storage/page

[GuildIndex]: /message-templates/types/storage/guild-index

[GuildIndexEntry]: /message-templates/types/storage/guild-index-entry

[GuildIndexes]: /message-templates/types/storage/guild-indexes

[MemberAttribute]: /message-templates/types/storage/member-attribute

[MemberAttributes]: /message-templates/types/storage/member-attributes

[Arguments]: /message-templates/types/custom-commands/arguments

[Parameters]: /message-templates/types/custom-commands/parameters

[Component]: /message-templates/types/custom-commands/component

[Modal]: /message-templates/types/custom-commands/modal

# Role

Этот тип данных описывает все доступные данные о роли сервера.

## Свойства { #properties }

| Свойство         | Тип          | Описание                                                                          |
|:-----------------|:-------------|:----------------------------------------------------------------------------------|
| `id`             | \[Число]      | Уникальный идентификатор роли                                                     |
| `name`           | \[Строка]     | Название роли                                                                     |
| `iconUrl`        | \[Строка]     | Ссылка на иконку роли                                                             |
| `position`       | \[Число]      | Номер позиции роли                                                                |
| `createdAt`      | \[DateTime]   | Дата и время создания роли                                                        |
| `permissionsRaw` | \[Число]      | Числовое представление всех прав доступа этой роли                                |
| `managed`        | \[Логический] | Признак того, управляется ли эта роль интеграцией                                 |
| `hoisted`        | \[Логический] | Признак того, отображаются ли участники с этой ролью отдельно в списке участников |
| `publicRole`     | \[Логический] | Признак того, является ли эта роль публичной ролью `@everyone`                    |
| `color`          | \[Строка]     | Цвет роли в формате `#RRGGBB`                                                     |
| `guild`          | \[Guild]      | Данные о сервере роли                                                             |

## Методы { #methods }

### `hasPermission(Название)`  { #method-haspermission .template-method }

::: tabs

\== Описание | mdi-text

Проверяет, есть ли у роли указанное право доступа (глобально).

**Возвращаемые типы:** \[Логический]

\== Параметры | mdi-code-parentheses

| Параметр   | Тип          | Описание                   |
|:-----------|:-------------|:---------------------------|
| `Название` | \[Permission] | Право доступа для проверки |

\== Пример | mdi-code-block-braces

```template{2}
{% set role = guild.getRole(313987336041922560) %}
{% if role.hasPermission('ADMINISTRATOR') %}
Эта роль - администратор этого сервера.
{% endif %}
```

:::

### `hasPermissions(Названия)`  { #method-haspermissions .template-method }

::: tabs

\== Описание | mdi-text

Проверяет, есть ли у роли указанные права доступа (глобально).

**Возвращаемые типы:** \[Логический]

\== Параметры | mdi-code-parentheses

| Параметр   | Тип                    | Описание                   |
|:-----------|:-----------------------|:---------------------------|
| `Названия` | \[Список]<\[Permission]> | Права доступа для проверки |

\== Пример | mdi-code-block-braces

```template{2}
{% set role = guild.getRole(313987336041922560) %}
{% if role.hasPermissions(['KICK_MEMBERS', 'BAN_MEMBERS']) %}
У этой роли есть возможность кикать и банить.
{% endif %}
```

:::

### `hasPermission(Канал, Название)`  { #method-haspermission-channel .template-method }

::: tabs

\== Описание | mdi-text

Проверяет, есть ли у роли указанное право доступа в указанном канале.

**Возвращаемые типы:** \[Логический]

\== Параметры | mdi-code-parentheses

| Параметр   | Тип                                                        | Описание                                   |
|:-----------|:-----------------------------------------------------------|:-------------------------------------------|
| `Канал`    | \[Число], \[TextChannel], \[NewsChannel], \[VoiceChannel], \[StageChannel], \[ForumChannel], \[MediaChannel], \[ThreadChannel], \[Category] | Идентификатор или объект текстового канала |
| `Название` | \[Permission]                                               | Право доступа для проверки                 |

\== Пример | mdi-code-block-braces

```template{2}
{% set role = guild.getRole(313987336041922560) %}
{% if role.hasPermission(channel, 'MESSAGE_MANAGE') %}
Эта роль может управлять сообщениями в текущем канале.
{% endif %}
```

:::

### `hasPermissions(Канал, Названия)`  { #method-haspermissions-channel .template-method }

::: tabs

\== Описание | mdi-text

Проверяет, есть ли у роли указанные права доступа в указанном канале.

**Возвращаемые типы:** \[Логический]

\== Параметры | mdi-code-parentheses

| Параметр   | Тип                                                        | Описание                                   |
|:-----------|:-----------------------------------------------------------|:-------------------------------------------|
| `Канал`    | \[Число], \[TextChannel], \[NewsChannel], \[VoiceChannel], \[StageChannel], \[ForumChannel], \[MediaChannel], \[ThreadChannel], \[Category] | Идентификатор или объект текстового канала |
| `Названия` | \[Список]<\[Permission]>                                     | Права доступа для проверки                 |

\== Пример | mdi-code-block-braces

```template{2}
{% set role = guild.getRole(313987336041922560) %}
{% if role.hasPermissions(channel, ['MESSAGE_EMBED_LINKS', 'MESSAGE_SEND']) %}
Эта роль может отправлять сообщения и прикреплять ссылки в текущем канале.
{% endif %}
```

:::