Langsung ke konten
Dialova

Dokumentasi IRC · Lanjutan

Message tags: metadata pesan IRC

Message tags menambahkan metadata sebelum bagian pesan IRC lainnya. Tag dapat berisi waktu, akun, atau referensi kelompok. Tag tidak dikenal boleh diabaikan dalam antarmuka, tetapi formatnya harus diurai dengan benar.

Tim Dialova · Diperiksa pada

Membaca bagian tag #

Pesan server dengan dua tag
@time=2026-10-29T10:00:00.000Z;account=alice :Alice!u@cloak.example PRIVMSG #atelier :Bonjour

Bagian ini dimulai dengan @ dan berakhir pada spasi pertama yang tidak di-escape. Tag dipisahkan dengan ;. Setiap kunci dapat memiliki nilai setelah =. Urutannya tidak memiliki makna dan kunci peka huruf besar-kecil. Jangan pecah parameter pesan sebelum memisahkan bagian ini.

Dekode nilai hanya sekali #

Urutan dalam protokolNilai setelah dekode
\:Titik koma
\sSpasi
\\Garis miring terbalik
\rCarriage return
\nBaris baru

Escape berlaku pada nilai tag, bukan seluruh teks pesan. Nilai tag menggunakan UTF-8. Nilai kosong dan tidak adanya nilai setara dalam mekanisme ini; antarmuka tidak boleh mengarang perbedaan makna.

Kemampuan umum dan ekstensi khusus #

message-tags mengumumkan dukungan format lengkap, termasuk tag khusus klien serta TAGMSG. Ekstensi seperti server-time, account-tag, dan batch juga mengandalkan format tag, tanpa menyamakan negosiasinya dengan kemampuan umum tersebut.

Tag klien rekaan: tidak diasumsikan memiliki fungsi tertentu
C: CAP REQ :message-tags
S: :irc.example CAP Alice ACK :message-tags
C: @+example.org/note=halo\sdi-sini TAGMSG #atelier

Prefiks + menandai tag klien. Ini tidak mengubah pernyataan klien menjadi informasi yang disahkan server. Akun yang diumumkan server harus dibedakan dari teks sembarang yang dikirim peserta.

Metadata berbatas, bukan pesan tanpa batas #

Tag memiliki jatah ukuran terpisah dari bagian pesan historis. Kehadirannya tidak membuat teks PRIVMSG menjadi tanpa batas. Tangani tag tidak dikenal, urutan tidak valid, dan kunci berulang sesuai spesifikasi; hindari parser yang menolak setiap perubahan atau menyimpan data tanpa batas selamanya.

Sumber dan verifikasi

Contoh menggunakan nama panggilan dan domain fiktif, kecuali titik koneksi yang didokumentasikan secara eksplisit. Ekstensi dan pengaturan khusus jaringan dijelaskan dalam teks.