Notification
Crea las notificaciones de escritorio del sistema operativo
Proceso: principal</0>
Utilizando el proceso de renderizado
Si quieres mostrar notificaciones desde un proceso de renderizado se debe utilizar HTML5 Notification API
Clase: Notification
Crea las notificaciones de escritorio del sistema operativo
Proceso: principal</0>
Notification
es un EventEmitter.
Crea una nueva Notification
con propiedades nativas como las configuradas por options
.
Métodos Estáticos
La clase Notification
tiene los siguientes métodos estáticos:
Notification.isSupported()
Devuelve boolean
- Si las notificaciones de escritorio son soportadas o no en el sistema actual
new Notification([options])
Eventos de Instancia
Los objetos creados con new Notification
emite los siguientes eventos:
Nota: Algunos eventos sólo están disponibles en sistemas operativos específicos y se etiquetan como tal.
Evento: "show"
Devuelve:
event
Se emite cuando la notificación se muestra al usuario. Tenga en cuenta que este puede emitirse tantas veces como se muestre la notificación a través del método show()
.
Evento: "click"
Devuelve:
event
Se emite cuando el usuario hace clic en la notificación.
Evento: "close"
Devuelve:
event
Se emite cuando se cierra la notificación por medio de la intervención manual del usuario.
No se garantiza que este evento se emita en todos los casos donde se cierre la notificación.
Evento: "reply" macOS
Devuelve:
event
reply
string - La cadena que ingreso el usuario dentro del campo de respuesta insertado.
Se emite cuando el usuario hace clic en el botón "Reply" en una notificación con hasReply: true
.
Evento: "action" macOS
Devuelve:
event
index
númerp - El indice de la acción que fue activado.
Evento: 'failed' Windows
Devuelve:
event
error
string - El error encontrado durante la ejecución del métodoshow()
.
Se emite cuando un error ocurre mientras se esta creando y mostrando una notificación nativa.
Métodos de Instancia
Los objetos creados con new Notification
tienen los siguientes métodos de instancia:
notification.show()
Muestra inmediatamente la notificación al usuario, por favor tenga en cuenta, esto quiere decir que a diferencia de la implementación de notificación de HTML5, iniciando una new Notificación
no se mostrará inmediatamente al usuario, usted necesita llamar este método antes que el sistema operativo lo muestre.
Si la notificación ha sido mostrada con anterioridad, este método descartará la notificación previa y creará una nueva con propiedades idénticas.
notification.close()
Descarta la notificación.
Propiedades de la instancia
notification.title
Una propiedad string
que representa el título de la notificación.
notification.subtitle
Una propiedad string
que representa el subtítulo de la notificación.
notification.body
Una propiedad string
que representa el cuerpo de la notificación.
notification.replyPlaceholder
Una propiedad string
que representa el marcador de respuesta de la notificación.
notification.sound
Una propiedad string
que representa el sonido de la notificación.
notification.closeButtonText
Una propiedad string
que representa el texto del botón cerrar en la notificación.
notification.silent
Una propiedad boolean
que representa si la notificación es silenciosa.
notification.hasReply
Una propiedad boolean
que representa si al notificación tiene a una acción de respuesta.
notification.urgency
Linux
Un propiedad string
que representa el nivel de prioridad de la notificación. Puede ser 'normal', 'critical', o 'low'.
Por defecto es 'low' - vea NotifyUrgency para más información.
notification.timeoutType
Linux Windows
Una propiedad string
que representa el tipo de tiempo de espera para la notificación. Puede ser 'default' o 'never'.
Si timeoutType
es especificado como 'never', la notificación nunca expirará. Se queda abierta hasta que se cierra por el llamado de la API o del usuario.
notification.actions
Una propiedad NotificationAction[]
que representa las acciones de la notificación.
notification.toastXml
Windows
Una propiedad string
que representa el Toast XML de la notificación.
Reproducción de Sonidos
En macOS, se puede especificar el nombre del sonido que se desee reproducir cuando se muestre la notificación. Cualquier sonido por defecto (en Preferencias del sistema > Sonido) pueden ser usados en adición a los sonidos personalizados del sistema. Asegúrese de que el archivo de sonido sea copiado en el paquete de la aplicación (por ejemplo, YourApp.app/Contents/Resources
), o uno de los siguientes direcciones:
~/Library/Sounds
/Library/Sounds
/Network/Library/Sounds
/System/Library/Sounds
Ver la documentación NSSound
para más información.