chrome.meldingen

Beschrijving

Gebruik de chrome.notifications API om uitgebreide meldingen te maken met behulp van sjablonen en deze meldingen aan gebruikers in het systeemvak weer te geven.

Machtigingen

notifications

Soorten

NotificationBitmap

NotificationButton

Eigenschappen

  • iconUrl

    tekenreeks optioneel

    Verouderd sinds Chrome 59

    Knoppictogrammen zijn niet zichtbaar voor Mac OS X-gebruikers.

  • titel

    snaar

NotificationItem

Eigenschappen

  • bericht

    snaar

    Aanvullende details over dit artikel.

  • titel

    snaar

    Titel van één item van een lijstmelding.

NotificationOptions

Eigenschappen

  • appIconMaskUrl

    tekenreeks optioneel

    Verouderd sinds Chrome 59

    Het app-pictogrammasker is niet zichtbaar voor Mac OS X-gebruikers.

    Een URL naar het app-pictogrammasker. URL's hebben dezelfde beperkingen als iconUrl .

    Het app-pictogrammasker moet in het alfakanaal staan, omdat alleen het alfakanaal van de afbeelding in aanmerking wordt genomen.

  • knoppen

    Notificatieknop [] optioneel

    Tekst en pictogrammen voor maximaal twee actieknoppen voor meldingen.

  • contextBericht

    tekenreeks optioneel

    Alternatieve inhoud van meldingen met een lichter lettertype.

  • evenementTijd

    nummer optioneel

    Een tijdstempel die aan de melding is gekoppeld, in milliseconden na het tijdperk (bijvoorbeeld Date.now() + n ).

  • iconUrl

    tekenreeks optioneel

    Een URL naar de avatar van de afzender, het app-pictogram of een miniatuur voor afbeeldingsmeldingen.

    URL's kunnen een gegevens-URL, een blob-URL of een URL zijn die relatief is aan een bron in het .crx-bestand van deze extensie

    **Opmerking:**Deze waarde is vereist voor de notifications.create () methode.

  • afbeeldingUrl

    tekenreeks optioneel

    Verouderd sinds Chrome 59

    De afbeelding is niet zichtbaar voor Mac OS X-gebruikers.

    Een URL naar de miniatuur van de afbeelding voor meldingen over het afbeeldingstype. URL's hebben dezelfde beperkingen als iconUrl .

  • isKlikbaar

    Booleaans optioneel

    Verouderd sinds Chrome 67

    Deze UI-hint wordt genegeerd vanaf Chrome 67

  • artikelen

    NotificationItem [] optioneel

    Artikelen voor meldingen met meerdere artikelen. Gebruikers van Mac OS X zien alleen het eerste item.

  • bericht

    tekenreeks optioneel

    Belangrijkste inhoud van de melding.

    **Opmerking:**Deze waarde is vereist voor de notifications.create () methode.

  • prioriteit

    nummer optioneel

    Prioriteit varieert van -2 tot 2. -2 is de laagste prioriteit. 2 is het hoogst. Nul is standaard. Op platforms die geen meldingscentrum ondersteunen (Windows, Linux en Mac), resulteren -2 en -1 in een foutmelding, omdat meldingen met die prioriteiten helemaal niet worden weergegeven.

  • voortgang

    nummer optioneel

    De huidige voortgang varieert van 0 tot 100.

  • vereiseninteractie

    Booleaans optioneel

    Chroom 50+

    Geeft aan dat de melding zichtbaar moet blijven op het scherm totdat de gebruiker de melding activeert of sluit. Dit is standaard ingesteld op false.

  • stil

    Booleaans optioneel

    Chroom 70+

    Geeft aan dat er geen geluiden of trillingen mogen worden gemaakt wanneer de melding wordt getoond. Dit is standaard ingesteld op false.

  • titel

    tekenreeks optioneel

    Titel van de melding (bijvoorbeeld afzendernaam voor e-mail).

    **Opmerking:**Deze waarde is vereist voor de notifications.create () methode.

  • type

    TemplateType optioneel

    Welk type melding moet worden weergegeven. Vereist voor notifications.create - methode.

PermissionLevel

Enum

"toegekend"
Geeft aan dat de gebruiker ervoor heeft gekozen meldingen van de app of extensie weer te geven. Dit is de standaard tijdens de installatie.

"geweigerd"
Geeft aan dat de gebruiker ervoor heeft gekozen geen meldingen van de app of extensie weer te geven.

TemplateType

Enum

"basis"
Bevat een pictogram, titel, bericht, uitgevouwen bericht en maximaal twee knoppen.

"afbeelding"
Bevat een pictogram, titel, bericht, uitgevouwen bericht, afbeelding en maximaal twee knoppen.

"lijst"
Bevat een pictogram, titel, bericht, items en maximaal twee knoppen. Gebruikers van Mac OS X zien alleen het eerste item.

"voortgang"
Bevat een pictogram, titel, bericht, voortgang en maximaal twee knoppen.

Methoden

clear()

Belofte
chrome.notifications.clear(
  notificationId: string,
  callback?: function,
)

Wist de opgegeven melding.

Parameters

  • notificatieId

    snaar

    De ID van de melding die moet worden gewist. Dit wordt geretourneerd door notifications.create methode.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (wasCleared: boolean) => void

    • werd gewist

      Booleaans

Retouren

  • Beloof<boolean>

    Chroom 116+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

create()

Belofte
chrome.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
  callback?: function,
)

Creëert en toont een melding.

Parameters

  • notificatieId

    tekenreeks optioneel

    Identificatie van de melding. Indien niet ingesteld of leeg, wordt er automatisch een ID gegenereerd. Als het overeenkomt met een bestaande melding, wist deze methode eerst die melding voordat u doorgaat met de aanmaakbewerking. De ID mag niet langer zijn dan 500 tekens.

    De parameter notificationId is vereist vóór Chrome 42.

  • Inhoud van de melding.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (notificationId: string) => void

    • notificatieId

      snaar

Retouren

  • Beloof<tekenreeks>

    Chroom 116+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getAll()

Belofte
chrome.notifications.getAll(
  callback?: function,
)

Haalt alle meldingen van deze app of extensie op.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (notifications: object) => void

    • meldingen

      voorwerp

Retouren

  • Beloof<object>

    Chroom 116+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getPermissionLevel()

Belofte
chrome.notifications.getPermissionLevel(
  callback?: function,
)

Haalt op of de gebruiker meldingen van deze app of extensie heeft ingeschakeld.

Parameters

Retouren

  • Belofte < Toestemmingsniveau >

    Chroom 116+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

update()

Belofte
chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
  callback?: function,
)

Werkt een bestaande melding bij.

Parameters

  • notificatieId

    snaar

    De ID van de melding die moet worden bijgewerkt. Dit wordt geretourneerd door notifications.create methode.

  • Inhoud van de melding waarnaar moet worden bijgewerkt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (wasUpdated: boolean) => void

    • is bijgewerkt

      Booleaans

Retouren

  • Beloof<boolean>

    Chroom 116+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

Evenementen

onButtonClicked

chrome.notifications.onButtonClicked.addListener(
  callback: function,
)

De gebruiker drukte op een knop in de melding.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (notificationId: string, buttonIndex: number) => void

    • notificatieId

      snaar

    • knopIndex

      nummer

onClicked

chrome.notifications.onClicked.addListener(
  callback: function,
)

De gebruiker heeft in een gebied zonder knop in de melding geklikt.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (notificationId: string) => void

    • notificatieId

      snaar

onClosed

chrome.notifications.onClosed.addListener(
  callback: function,
)

De melding is gesloten, hetzij door het systeem, hetzij door actie van de gebruiker.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (notificationId: string, byUser: boolean) => void

    • notificatieId

      snaar

    • doorGebruiker

      Booleaans

onPermissionLevelChanged

chrome.notifications.onPermissionLevelChanged.addListener(
  callback: function,
)

De gebruiker wijzigt het machtigingsniveau. Vanaf Chrome 47 heeft alleen ChromeOS een gebruikersinterface die deze gebeurtenis verzendt.

Parameters

onShowSettings

Verouderd sinds Chrome 65
chrome.notifications.onShowSettings.addListener(
  callback: function,
)

De knop Aangepaste meldingsinstellingen wordt niet langer ondersteund.

De gebruiker klikte op een link voor de meldingsinstellingen van de app. Vanaf Chrome 47 heeft alleen ChromeOS een gebruikersinterface die deze gebeurtenis verzendt. Vanaf Chrome 65 is die gebruikersinterface ook uit ChromeOS verwijderd.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    () => void