BAB 58: Server-Sent Events
Menerima update real-time dari server menggunakan Server-Sent Events.
Web Workers di bab sebelumnya memungkinkan halaman menjalankan tugas berat tanpa memblokir UI. Tapi semua pemrosesan itu terjadi di sisi klien, di browser pengguna. Dalam banyak kasus nyata, data justru berasal dari server: harga saham terbaru, notifikasi baru, skor pertandingan langsung, atau status pengiriman paket. Halaman perlu terus menerima data terbaru dari server tanpa harus di-refresh.
Server-Sent Events (SSE) adalah mekanisme di mana server mengirim data ke browser secara otomatis dan terus-menerus melalui koneksi HTTP yang tetap terbuka. Berbeda dengan request biasa di mana browser bertanya dan server menjawab sekali, SSE membuat koneksi yang tetap hidup: server bisa mengirim data kapan saja tanpa browser harus memintanya lagi.
SSE vs Polling vs WebSocket
Ada beberapa pendekatan untuk mendapatkan data real-time dari server. SSE menempati posisi di antaranya:
| Aspek | Polling | Server-Sent Events | WebSocket |
|---|---|---|---|
| Arah komunikasi | Klien ke server (berulang) | Server ke klien | Dua arah |
| Protokol | HTTP biasa | HTTP | WS (protokol sendiri) |
| Kompleksitas | Rendah | Rendah | Tinggi |
| Efisiensi | Rendah (banyak request sia-sia) | Tinggi | Tinggi |
| Reconnect otomatis | Harus dibuat sendiri | Bawaan browser | Harus dibuat sendiri |
| Cocok untuk | Data yang jarang berubah | Feed satu arah (notifikasi, log) | Chat, game, kolaborasi |
SSE adalah pilihan tepat ketika kamu hanya butuh data mengalir dari server ke klien, tidak perlu mengirim data balik ke server melalui koneksi yang sama.
Cara Kerja SSE
Alur SSE sederhana:
Browser Server
| |
|--- GET /stream --------------->|
| | (koneksi tetap terbuka)
|<--- data: Pesan pertama -------|
| |
|<--- data: Pesan kedua ---------|
| |
|<--- data: Pesan ketiga --------|
| ... |
Browser membuka koneksi sekali, dan server terus mengirimkan data melalui koneksi yang sama. Jika koneksi terputus (misalnya karena jaringan), browser otomatis mencoba menyambung kembali: ini adalah fitur bawaan SSE yang tidak perlu kamu kode sendiri.
Sisi Klien: EventSource
Di sisi browser, SSE diakses melalui objek EventSource. Kamu cukup memberikan URL endpoint server yang mengirimkan event stream:
<!-- sse-klien.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Server-Sent Events</title>
<style>
body { font-family: sans-serif; max-width: 500px; margin: 20px auto; }
button { padding: 10px 20px; margin: 4px; }
#log {
background: #f1f5f9;
padding: 12px;
border-radius: 8px;
min-height: 150px;
max-height: 400px;
overflow-y: auto;
}
.pesan { margin: 4px 0; padding: 4px 0; border-bottom: 1px solid #e2e8f0; }
.status { font-weight: bold; }
.terbuka { color: #16a34a; }
.tertutup { color: #dc2626; }
</style>
</head>
<body>
<h1>Menerima Event dari Server</h1>
<button id="sambung">Sambungkan</button>
<button id="putus">Putuskan</button>
<p class="status" id="status">Status: belum tersambung</p>
<div id="log"></div>
<script>
var log = document.getElementById("log");
var statusEl = document.getElementById("status");
var sumberEvent = null;
function tambahLog(teks) {
var p = document.createElement("p");
p.className = "pesan";
p.textContent = new Date().toLocaleTimeString("id-ID") + " - " + teks;
log.appendChild(p);
log.scrollTop = log.scrollHeight;
}
document.getElementById("sambung").addEventListener("click", function() {
if (sumberEvent) {
tambahLog("Sudah tersambung.");
return;
}
sumberEvent = new EventSource("stream.php");
sumberEvent.addEventListener("open", function() {
statusEl.textContent = "Status: tersambung";
statusEl.className = "status terbuka";
tambahLog("Koneksi terbuka.");
});
sumberEvent.addEventListener("message", function(e) {
tambahLog("Data: " + e.data);
});
sumberEvent.addEventListener("error", function() {
if (sumberEvent.readyState === EventSource.CLOSED) {
statusEl.textContent = "Status: terputus";
statusEl.className = "status tertutup";
tambahLog("Koneksi ditutup oleh server.");
} else {
tambahLog("Koneksi bermasalah, mencoba menyambung ulang...");
}
});
});
document.getElementById("putus").addEventListener("click", function() {
if (sumberEvent) {
sumberEvent.close();
sumberEvent = null;
statusEl.textContent = "Status: terputus";
statusEl.className = "status tertutup";
tambahLog("Koneksi diputus oleh pengguna.");
}
});
</script>
</body>
</html>
EventSource memiliki tiga event utama:
open: Koneksi berhasil dibukamessage: Server mengirim data baru. Data tersedia die.data.error: Koneksi bermasalah atau ditutup oleh server
Properti readyState menunjukkan status koneksi:
| Nilai | Konstanta | Arti |
|---|---|---|
| 0 | EventSource.CONNECTING | Sedang mencoba menyambung |
| 1 | EventSource.OPEN | Tersambung dan menerima data |
| 2 | EventSource.CLOSED | Koneksi ditutup |
Sisi Server: Format Event Stream
Server harus mengirimkan respons dengan Content-Type: text/event-stream. Setiap event diformat sebagai baris teks yang diawali dengan data: dan diakhiri dengan dua baris kosong:
<!-- stream.php -->
<?php
header("Content-Type: text/event-stream");
header("Cache-Control: no-cache");
header("Connection: keep-alive");
$waktuMulai = time();
while (true) {
$waktu = date("H:i:s");
echo "data: Server time: $waktu\n\n";
ob_flush();
flush();
// Berhenti setelah 30 detik
if (time() - $waktuMulai > 30) {
break;
}
sleep(2);
}
?>
Contoh server di atas menggunakan PHP karena sederhana dan mudah dipahami. Dalam praktik nyata, SSE bisa diimplementasikan di bahasa apapun: Node.js, Python, Go, Java, dan lainnya. Yang penting adalah format respons yang benar (text/event-stream) dan koneksi yang tetap terbuka.
Format event stream mengikuti aturan sederhana:
- Setiap baris data diawali dengan
data:(perhatikan spasi setelah titik dua) - Event dipisahkan oleh dua baris kosong (
\n\n) - Baris yang diawali dengan
:dianggap komentar dan diabaikan oleh browser
Event dengan Nama Kustom
Selain event message default, server bisa mengirim event dengan nama kustom menggunakan field event::
event: notifikasi
data: Ada pesan baru dari Admin
event: harga
data: {"saham": "BBCA", "harga": 9250}
data: Ini adalah event message biasa (tanpa nama kustom)
Di sisi klien, event kustom ditangkap dengan addEventListener() menggunakan nama event yang sesuai:
<!-- sse-kustom.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Event Kustom SSE</title>
<style>
body { font-family: sans-serif; max-width: 500px; margin: 20px auto; }
.notifikasi {
padding: 10px;
margin: 6px 0;
border-radius: 6px;
border-left: 4px solid;
}
.tipe-notifikasi { border-color: #3b82f6; background: #eff6ff; }
.tipe-harga { border-color: #f59e0b; background: #fffbeb; }
.tipe-umum { border-color: #6b7280; background: #f9fafb; }
</style>
</head>
<body>
<h1>Event Kustom SSE</h1>
<div id="wadah"></div>
<script>
var wadah = document.getElementById("wadah");
var sumber = new EventSource("stream-kustom.php");
function tampilkan(teks, kelas) {
var div = document.createElement("div");
div.className = "notifikasi " + kelas;
div.textContent = teks;
wadah.insertBefore(div, wadah.firstChild);
}
// Tangkap event bernama "notifikasi"
sumber.addEventListener("notifikasi", function(e) {
tampilkan("Notifikasi: " + e.data, "tipe-notifikasi");
});
// Tangkap event bernama "harga"
sumber.addEventListener("harga", function(e) {
var data = JSON.parse(e.data);
tampilkan("Harga " + data.saham + ": Rp " + data.harga, "tipe-harga");
});
// Tangkap event tanpa nama (message default)
sumber.addEventListener("message", function(e) {
tampilkan(e.data, "tipe-umum");
});
</script>
</body>
</html>
Server PHP yang mengirim event kustom:
<!-- stream-kustom.php -->
<?php
header("Content-Type: text/event-stream");
header("Cache-Control: no-cache");
$saham = ["BBCA", "TLKM", "BMRI", "UNVR"];
$waktuMulai = time();
while (true) {
$tipe = rand(0, 2);
if ($tipe === 0) {
echo "event: notifikasi\n";
echo "data: Laporan harian sudah tersedia\n\n";
} elseif ($tipe === 1) {
$s = $saham[array_rand($saham)];
$h = rand(1000, 15000);
echo "event: harga\n";
echo "data: {\"saham\": \"$s\", \"harga\": $h}\n\n";
} else {
echo "data: Update sistem pada " . date("H:i:s") . "\n\n";
}
ob_flush();
flush();
if (time() - $waktuMulai > 60) break;
sleep(3);
}
?>
Field ID dan Retry
Event stream juga mendukung dua field tambahan:
id:: Memberikan ID unik ke setiap event. Jika koneksi terputus dan tersambung kembali, browser mengirim headerLast-Event-IDsehingga server tahu event terakhir yang diterima klien.retry:: Mengatur berapa milidetik browser menunggu sebelum mencoba reconnect setelah koneksi terputus. Default-nya bervariasi antar browser.
id: 1
data: Pesan pertama
id: 2
retry: 5000
data: Pesan kedua (retry diatur ke 5 detik)
id: 3
data: Pesan ketiga
Di sisi klien, ID event bisa diakses lewat e.lastEventId:
sumber.addEventListener("message", function(e) {
console.log("ID: " + e.lastEventId);
console.log("Data: " + e.data);
});
Simulasi SSE Tanpa Server
Untuk mempraktikkan SSE tanpa harus menjalankan server PHP atau server lain, kamu bisa membuat file teks statis yang mengikuti format event stream. Namun pendekatan ini terbatas, server tidak benar-benar mengirim data secara terus-menerus.
Alternatif yang lebih praktis untuk belajar adalah menggunakan layanan SSE publik untuk testing, atau menjalankan server lokal sederhana. Jika kamu sudah menginstal PHP:
cd folder-proyek
php -S localhost:8000
Lalu buka http://localhost:8000/sse-klien.html di browser. Server built-in PHP sudah cukup untuk menjalankan semua contoh di bab ini.
Jika belum menginstal PHP, kamu bisa menggunakan Node.js atau Python untuk membuat server SSE sederhana. Yang penting adalah server mengirim respons dengan header Content-Type: text/event-stream dan mempertahankan koneksi tetap terbuka.
Menutup Koneksi dengan Benar
Selalu tutup koneksi SSE saat tidak diperlukan lagi, misalnya saat pengguna meninggalkan halaman:
// Tutup saat pengguna meninggalkan halaman
window.addEventListener("beforeunload", function() {
if (sumberEvent) {
sumberEvent.close();
}
});
Tanpa penutupan yang benar, koneksi SSE tetap terbuka dan mengonsumsi sumber daya di sisi server.
Latihan
-
Buat halaman "Jam Server" yang menampilkan waktu dari server (diperbarui setiap detik melalui SSE). Tampilkan waktu dalam format besar dan jelas di tengah halaman. Tambahkan tombol untuk menghentikan dan memulai ulang koneksi.
-
Buat halaman notifikasi sederhana yang menerima tiga jenis event dari server:
info(warna biru),peringatan(warna kuning), danerror(warna merah). Setiap notifikasi ditampilkan sebagai kartu berwarna yang bisa ditutup oleh pengguna. -
Buat dashboard sederhana yang menampilkan "harga saham" dari empat perusahaan fiktif. Server mengirim update harga secara acak setiap 2 detik melalui event bernama
harga. Tampilkan harga terkini dalam tabel dan beri warna hijau jika naik, merah jika turun dari harga sebelumnya.
Dengan Server-Sent Events, halaman web bisa menerima data real-time dari server tanpa harus terus-menerus bertanya. Ini melengkapi rangkaian Web API yang sudah kita pelajari sepanjang enam bab terakhir, dari mengetahui lokasi pengguna, menyeret elemen di layar, menyimpan data di browser, menjalankan tugas berat di background, hingga menerima update langsung dari server. Semua API ini sudah ada di dalam browser, menunggu untuk digunakan di proyek web kamu. Di bab terakhir ebook ini, kita akan membahas satu topik yang menyentuh semua hal yang sudah kita pelajari: bagaimana memastikan halaman web yang kita buat bisa digunakan oleh semua orang: termasuk mereka yang menggunakan screen reader atau keyboard saja.