Inconsistency: notifications.NotificationOptions

[erosman]

Available options in notifications.NotificationOptions (Chrome NotificationOptions) differ considerably between browsers, as evident in the Browser compatibility.

	🖥 desktop					📱 mobile
	Chrome	Edge	Firefox	Opera	Safari	Firefox for Android	Safari on iOS
NotificationOptions	✅	✅ (17)	✅ (45)	✅	❌	✅ (48)	❌
appIconMaskUrl	✅	✅ (79)	❌	✅	❌	❌	❌
buttons	✅	✅ (79)	❌	❌	❌	❌	❌
contextMessage	✅ (31)	✅ (79)	❌	❌	❌	❌	❌
eventTime	✅	✅ (79)	❌	✅	❌	❌	❌
imageUrl	✅	✅ (79)	❌	❌	❌	❌	❌
isClickable	✅ (32)	✅ (79)	❌	❌	❌	❌	❌
items	✅	✅ (79)	❌	❌	❌	❌	❌
priority	✅	✅ (79)	❌	✅	❌	❌	❌
progress	✅ (30)	✅ (79)	❌	❌	❌	❌	❌
requireInteraction	✅ (50)	✅ (79)	❌	❌	❌	❌	❌

[carlosjeurissen]

@erosman what happens when you use any of the unsupported properties? Will they be ignored or will an exception be thrown? If browsers just ignore unsupported properties I do not see any big issue for now.

[erosman]

Example:

browser.notifications.create('', {
  type: 'basic',
  iconUrl: '/image/icon48.png',
  title: 'Reminder',
  message: "Proceed?",
  buttons: [
    {
      title: "Yes, get me there"
    }, 
    {
      title: "Get out of my way"
    }
  ]
});

It results in an error.

Uncaught Error: Type error for parameter options (Property "buttons" is unsupported by Firefox) for notifications.create.
Schemas.sys.mjs:2704:19

https://searchfox.org/mozilla-central/source/toolkit/components/extensions/Schemas.sys.mjs#2703,2705

  throwError(context, msg) {
    throw context.makeError(`${msg} for ${this.path.join(".")}.${this.name}.`);
  }

[patrickkettner]

As requested during the 2023-09-28 meeting , I pulled the notification API usage from Chrome. In the below chart, 100% represents all usages of notifications.create. Each section makes up the percentage of extensions that use that API.

Note that the usages are not mutually exclusive. A single call could use multiple listed options. The exception is the (None) section. That is made up of calls to notifications.create that explicitly do not use any of the other listed options.

[patrickkettner]

TIL github supports mermaid charts

pie  title browser.notification API usage in Chrome Web Store
        "NotificationOptions": 1
        ".appIconMaskUrl": 1
        ".buttons": 16
        ".contextMessage": 5
        ".eventTime": 4
        ".imageUrl": 5
        ".isClickable": 5
        ".items": 16
        ".priority": 14
        ".progress": 12
        ".requireInteraction": 9
        "(None)": 14

Loading

[Rob--W]

@patrickkettner Is there any difference if you filter by extensions with users?

E.g. >10 users to exclude extensions with barely any usage
vs >1000
vs >10000