Nickersoft/push.jsArchived
Push.js
Push.js is a cross-browser JavaScript library for displaying native desktop notifications from web applications. It wraps the divergent browser notification APIs into a single consistent interface, handling permission requests through a promise-based flow and providing graceful fallback when the native Notification API is unavailable.
The library distinguishes itself through its event-driven lifecycle hooks, which expose callbacks for notification events such as show, click, close, and error. It also supports programmatic dismissal by returning a notification handle with a close method, and includes a timeout-based queue that stores notifications during user absence and replays them upon return. Scheduled delivery is handled through an internal timer that delays notification display to a specified future timestamp.
The project covers the full lifecycle of desktop notification management, including display, permission requests, queuing during absence, programmatic closure, and scheduled delivery. It accepts a single configuration object with properties for title, body, icon, timeout, and scheduling, and degrades to in-page or console notifications when the native API is not supported.
Features
- Cross-Browser Notification Libraries - Provides a cross-browser wrapper for displaying native desktop notifications with permission handling and scheduling support.
- Cross-Browser Notification Wrappers - Wraps browser notification APIs with fallback support for consistent desktop notification behavior across different browsers.
- Desktop - Displays and manages native desktop notifications from web applications across different browsers with permission handling and programmatic control.
- Cross-Browser Desktop Notification Displays - Shows native desktop notifications across different browsers with fallback for unsupported APIs.
- Web-Based Desktop Notification Dispatchers - Displays native operating-system notifications from a web page using a cross-browser wrapper.
- Desktop Notification Permission Requests - Manages the promise-based permission request flow for displaying native desktop notifications from web applications.
- Desktop Notification API Wrappers - Unifies browser notification APIs with fallback support for unsupported environments.
- Browser API Normalizers - Normalizes divergent browser notification APIs into a single consistent interface.
- Lifecycle Event Hooks - Exposes callbacks for notification lifecycle events such as show, click, close, and error.
- Scheduled Notification Triggers - Delays the display of desktop notifications to specific future times for timed alerts and reminders.
- Desktop Notification Schedulers - Schedules and displays delayed desktop notifications from web applications.
- Timer-Based Notification Schedulers - Uses setTimeout internally to delay notification display to a specified future timestamp.
- Notification Queues - Stores notifications in a queue during user absence and replays them after a configurable timeout.
- Absence - Queues notifications during user absence and replays them upon return for non-disruptive delivery.
- Programmatic Notification Closers - Returns a notification handle with a close method for programmatic dismissal of desktop notifications.
- Programmatic Close Handles - Returns a notification handle that allows the caller to dismiss the notification later via a close method.
- Fallback Notification Strategies - Degrades gracefully to in-page or console notifications when the native Notification API is unavailable.
- JavaScript Libraries - Desktop notification library using the browser API.
