IRCドキュメント · 上級
CAP:IRC拡張機能を確認して交渉する
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確認