Документация IRC · Продвинутый
Команда CAP: узнать и согласовать расширения
CAP согласует расширения IRC. С её помощью клиент включает поддерживаемые им механизмы. Раздел IRCv3 CAP подробно объясняет состояния обмена, а эта памятка помогает распознать синтаксис в журнале.
Команда Dialova · Проверено
Синтаксис и параметры #
CAP <LS [302] | LIST | REQ :<возможности> | END>| Параметр | Значение |
|---|---|
| LS 302 | Запрашивает список в современном формате объявления, включая значения и ответы, которые могут состоять из нескольких сообщений. |
| REQ | Запрашивает включение выбранных возможностей; сервер отвечает ACK или NAK. |
| LIST / END | LIST перечисляет активные возможности; END завершает приостановку регистрации подключения. |
Пример с пояснениями #
C: CAP LS 302
C: NICK Alice
C: USER alice 0 * :Alice
S: :irc.example CAP * LS :message-tags server-time
C: CAP REQ :server-time
S: :irc.example CAP Alice ACK :server-time
C: CAP ENDНики, адреса и тексты примера вымышлены. Клиент может показывать ответы в более удобном виде, чем приведённые строки протокола.
Возможные ответы и ошибки #
| Ответ | Значение |
|---|---|
| CAP LS | Предлагаемый список; промежуточный маркер * означает продолжение. |
| CAP ACK / NAK | Включение подтверждено или запрос отклонён. |
| CAP LIST | Список активных возможностей. |
| Ошибка | Обычная причина |
|---|---|
| 410 | Недопустимая подкоманда CAP; ответ зависит от реализации. |
| 421 | Старый сервер не распознаёт CAP. |
Права, совместимость и меры предосторожности #
Объявление LS ничего не включает. Клиент использует возможность только после подтверждения её включения. CAP END — не сообщение в комнату, а этап установления подключения.
CAP может работать и после регистрации подключения. Однако подкоманды, объявленная версия и уведомления NEW/DEL должны обрабатываться по спецификации. Значение возможности, например sasl=PLAIN, не является её названием.
Частые вопросы #
Почему CAP написано без /? Здесь показан протокол. Интерфейс обрабатывает эту команду внутри клиента.
Выполняют ли CAP и 005 ISUPPORT одну задачу? Нет. ISUPPORT описывает свойства и ограничения, CAP включает согласуемые расширения.
Источники и проверка
В примерах используются вымышленные ники и домены, кроме явно указанных реальных точек подключения. Расширения и настройки отдельных сетей отмечены в тексте.
- Modern IRC — спецификация клиентского протокола ↗Источник: спецификация · дата обращения: 2026-10-29
- IRCv3 — согласование возможностей клиента ↗Источник: спецификация · дата обращения: 2026-10-29