Notifications (Frontend)

Register a service worker, request push permission, and display local notifications.

notification.registerServiceWorker(swPath)

Registers the service worker (defaults to /sw.js). Must be served over HTTP(S) and the file must live at the site root.

await venjs.notification.registerServiceWorker("/sw.js");

notification.ask(phpUrl)

Requests the browser's notification permission. On "granted", it generates a device id and (optionally) POSTs it to phpUrl so your server can target this device later.

Returns the deviceId string, or false if permission was denied or notifications are unsupported.

const id = await venjs.notification.ask("/ven_notify.php");
if (id) console.log("device registered:", id);

notification.push(options)

Shows a local notification immediately (requires permission).

Option	Description
Content	Body text of the notification.
icon	Icon URL (defaults to "").
url	URL opened when the notification is clicked.

venjs.notification.push({
  Content: "New message from Ada",
  icon: "/icon/logo.png",
  url: "/messages/42"
});

Full flow

// logic/notifications.js
export const initNotifications = async () => {
  await venjs.notification.registerServiceWorker("/sw.js");
  const deviceId = await venjs.notification.ask("/ven_notify.php");

  if (deviceId) {
    venjs.notification.push({
      Content: "VenJS notifications are ready!",
      url: location.href
    });
  }
};