Content update & fix of Notification in Service Worker

[skyclouds2001]

Description

move the note in ServiceWorkerGlobalScope.notificationclose event to Notification() constructor

and update content indicating relative event on Notification in ServiceWorkerGlobalScope.notificationclick

also update example description by replacing event handler property usage to event

Motivation

Additional details

Related issues and pull requests

[github-actions]

Preview URLs

• /en-US/docs/Web/API/Notification/Notification
• /en-US/docs/Web/API/Notifications_API/Using_the_Notifications_API
• /en-US/docs/Web/API/ServiceWorkerGlobalScope/notificationclick_event
• /en-US/docs/Web/API/ServiceWorkerGlobalScope/notificationclose_event
• /en-US/docs/Web/API/ServiceWorkerRegistration/showNotification

External URLs (2)

URL: /en-US/docs/Web/API/Notifications_API/Using_the_Notifications_API
Title: Using the Notifications API

• https://mdn.github.io/dom-examples/to-do-notifications/ (1 time)
• https://slack.com/ (1 time)

(comment last updated: 2024-02-09 06:15:03)

[hamishwillee]

Flyby. If the parent is optional, aren't all of the sub items (i.e why not action and title too)? Or are you saying that IFF actions is specified, then the action and title must be specified, but icon is optional?

[wbamberg]

IFF actions is specified, then the action and title must be specified, but icon is optional?

Basically, yes:

• options is optional (https://notifications.spec.whatwg.org/#service-worker-api)
• options has an optional attribute actions (https://notifications.spec.whatwg.org/#dictdef-notificationoptions)
• actions is an array of NotificationAction objects, which have mandatory action and title properties, and an optional icon property (https://notifications.spec.whatwg.org/#dictdef-notificationaction)

[wbamberg]

Although weirdly it seems as if, if you call this constructor, you must not pass any actions, or you get a TypeError exception? https://notifications.spec.whatwg.org/#create-a-notification

[hamishwillee]

Thanks.

Although weirdly it seems as if, if you call this constructor, you must not pass any actions, or you get a TypeError exception? https://notifications.spec.whatwg.org/#create-a-notification

It says "If a serviceWorkerRegistration was not provided and options["actions"] is not empty, then throw a TypeError."

So you you can only have actions if the serviceworker registration is provided.

Looking through this there are lots of missing cases that can throw a typerror

[wbamberg]

So you you can only have actions if the serviceworker registration is provided.

Right, but that operation I linked, https://notifications.spec.whatwg.org/#create-a-notification , can I think be reached from two paths:

• calling the Notification() constructor (https://notifications.spec.whatwg.org/#ref-for-create-a-notification)
• calling ServiceWorkerRegistration.showNotification() (https://notifications.spec.whatwg.org/#ref-for-create-a-notification%E2%91%A0)

...and it's only in the second of these cases that the registration gets passed. So if you call the constructor, you must not provide actions.

[skyclouds2001]

Right, but that operation I linked, https://notifications.spec.whatwg.org/#create-a-notification , can I think be reached from two paths:

• calling the Notification() constructor (https://notifications.spec.whatwg.org/#ref-for-create-a-notification)
• calling ServiceWorkerRegistration.showNotification() (https://notifications.spec.whatwg.org/#ref-for-create-a-notification%E2%91%A0)

...and it's only in the second of these cases that the registration gets passed. So if you call the constructor, you must not provide actions.

yes, actions parameter can not use with Notification() constructor

[wbamberg]

Although weirdly it seems as if, if you call this constructor, you must not pass any actions, or you get a TypeError exception? https://notifications.spec.whatwg.org/#create-a-notification

[wbamberg]

👍 thank you!