Перейти к содержимому
Dialova

Документация IRC · Продвинутый

Message tags: метаданные сообщений IRC

Теги добавляют метаданные перед остальной частью сообщения IRC. Они могут содержать время, учётную запись или ссылку на группу сообщений. Незнакомый тег можно не показывать, но его формат всё равно нужно правильно разобрать.

Команда Dialova · Проверено

Чтение области тегов #

Сообщение сервера с двумя тегами
@time=2026-10-29T10:00:00.000Z;account=alice :Alice!u@cloak.example PRIVMSG #atelier :Bonjour

Область начинается с @ и заканчивается первым неэкранированным пробелом. Теги разделяются знаком ;. После ключа может следовать значение со знаком =. Порядок не имеет значения, а регистр ключей важен. Выделите эту область до разбора параметров сообщения.

Декодировать значения только один раз #

Последовательность в протоколеДекодированное значение
\:Точка с запятой
\sПробел
\\Обратная косая черта
\rВозврат каретки
\nПеревод строки

Экранирование относится к значению тега, а не ко всему тексту сообщения. Значения используют UTF-8. Пустое значение и отсутствие значения в этом механизме равнозначны: интерфейс не должен придумывать смысловое различие.

Общая возможность и специальные расширения #

message-tags объявляет полную поддержку формата и, в частности, разрешает клиентские теги и TAGMSG. Server-time, account-tag и batch тоже используют формат тегов, но их согласование не следует смешивать с согласованием общей возможности.

Условный клиентский тег без подразумеваемой функции
C: CAP REQ :message-tags
S: :irc.example CAP Alice ACK :message-tags
C: @+example.org/note=привет\sздесь TAGMSG #atelier

Префикс + обозначает клиентский тег. Он не превращает заявление клиента в информацию, подтверждённую сервером. Учётную запись, объявленную сервером, нужно отличать от произвольного текста участника.

Метаданные ограничены по размеру #

Для тегов предусмотрен отдельный размерный бюджет, отличный от исторической части сообщения. Их наличие не делает текст PRIVMSG неограниченным. Обрабатывайте неизвестные теги, некорректные последовательности и повторяющиеся ключи по спецификации. Парсер не должен отвергать любое развитие протокола или бесконечно хранить данные без ограничений.

Источники и проверка

В примерах используются вымышленные ники и домены, кроме явно указанных реальных точек подключения. Расширения и настройки отдельных сетей отмечены в тексте.