mikaelbr/node-notifier
Node Notifier
node-notifier هو مكتبة Node.js وغلاف عبر الأنظمة الأساسية يوفر واجهة JavaScript موحدة لإرسال إشعارات سطح المكتب الأصلية على macOS و Windows و Linux. يعمل كجسر بين كود JavaScript وملفات إشعارات النظام الثنائية مثل libnotify و Growl و Windows Toasters.
يدعم المشروع دمج التنبيهات الأصلية في تطبيقات Node.js، وتطبيقات سطح المكتب Electron، ونصوص shell. ويتضمن أداة سطر أوامر لتشغيل تنبيهات سطح المكتب مباشرة من طرفية باستخدام وسيطات أو مدخلات ممررة.
تدير المكتبة تسليم التنبيهات الأصلية، بما في ذلك تشغيل صوت إشعار مخصص. كما تراقب تفاعل المستخدم، مما يسمح للتطبيقات بالاستماع للنقرات أو المهلات لتشغيل استجابات برمجية. تتوفر خيارات التكوين لضبط إعدادات مراسل نظام التشغيل، مثل معرفات التطبيق ومستويات الإلحاح.
Features
- Cross-Platform Desktop Notifications - Provides a unified JavaScript interface for sending native desktop notifications on macOS, Windows, and Linux.
- Native Module Bridges - Acts as a bridge between JavaScript code and system-level notification binaries like libnotify, Growl, and Windows Toasters.
- Notification Command Line Tools - Provides a command-line utility to trigger desktop alerts using arguments or piped input.
- Native Alert Delivery - Sends native operating system alerts by automatically selecting the most compatible reporting tool for the current environment.
- Cross-Platform Command Wrappers - Translates high-level JavaScript calls into low-level shell commands tailored for macOS, Windows, and Linux.
- System Binary Execution - Triggers notifications by executing pre-installed system binaries or scripts via child processes.
- Node.js Desktop Integration - Interacts with low-level operating system notification services to provide real-time feedback to a local user via Node.js.
- Notification Libraries - Ships a library for sending native cross-platform desktop notifications from Node.js applications.
- Cross-Platform Wrapper Interfaces - Provides a unified interface that abstracts different operating system notification systems into a single consistent API.
- Notification Integrations - Integrates native desktop alerts into Electron applications to notify users of background events or system updates.
- Command Line Notification Tools - Triggering desktop popups directly from a terminal or shell script to notify a developer of task completion.
- Dynamic Provider Switching - Implements runtime selection between different notification provider implementations based on the detected operating system.
- Notification Tooling - Provides a utility for triggering native system alerts and monitoring user interactions within Electron desktop applications.
- Notification Command Mappings - Provides an internal API to map generic notification properties to OS-specific command-line flags.
- Process Output Monitoring - Tracks the exit codes and output of spawned shell processes to detect user interaction and timeouts.
- Notification Monitoring - Listens for user actions like clicks or timeouts to trigger specific programmatic responses when alerts are accessed.
- Notification Interaction Handling - Provides functionality to wait for a user to click an alert or for a timeout to occur to execute a callback.
- Desktop UI - Cross-platform desktop notifications.
- Node.js Frameworks and Tools - Native system notifications for Node.js.
