Skip to Content

broadcast

Phát một tin realtime từ code server tới mọi trang đang nghe kênh đó bằng useLive, để màn hình tự cập nhật khi dữ liệu đổi.

Cách dùng

app/orders/repository.ts
import { broadcast } from "manh/realtime"; export async function moveOrder(user, id: number, to: string) { // … kiểm và ghi database trước broadcast("orders", { id, status: to }); // mọi người đang nghe "orders" broadcast(`user:${row.assigneeId}`, { type: "status", id }); // chỉ một người đã đăng nhập return updated; }
app/orders/page.tsx
useLive("orders", () => refresh());

Chỉ dùng trong file .ts: handler, cron, job.

Chữ ký

manh/realtime
function broadcast(channel: string, data?: unknown): void;

Tham số

  • channel: tên kênh, bắt đầu bằng chữ thường hoặc số, gồm chữ thường, số và : _ -, tối đa 64 ký tự. Tên sai thì hàm ném lỗi. Kênh user:<id> chỉ tới trang đã chứng minh id đó bằng token đăng nhập.
  • data: dữ liệu gửi kèm, phải chuyển được sang JSON. Bỏ trống thì gửi null.

Trả về

Không trả gì. Tin được gửi đi khi request trả response, nên gọi broadcast sau khi ghi xong.

Tổng dữ liệu các tin trong một request tối đa 32 KB. Quá mức đó, trang nghe vẫn nhận tin trên đúng kênh nhưng data là null.

Ví dụ

Báo cho màn hình kho khi job đồng bộ chạy xong:

app/stock/sync.cron.ts
import { broadcast } from "manh/realtime"; import { syncStock } from "./repository"; export const schedule = "*/15 * * * *"; export default async function () { const changed = await syncStock(); if (changed > 0) broadcast("stock", { changed }); }
  • Kênh không phải user:<id> thì ai mở app cũng nghe được. Gửi id hoặc tín hiệu “có thay đổi”, không gửi dữ liệu riêng tư; trang tự tải lại qua API, nơi kiểm quyền.
  • Mỗi gói giới hạn số kết nối realtime cùng lúc của một app (Free 100).

Bước tiếp theo

Cập nhật