chrome.meldingen

Beschrijving

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

Machtigingen

notifications

Typen

NotificationBitmap

NotificationButton

Eigenschappen

  • pictogramUrl

    string optioneel

    Verouderd sinds Chrome 59

    Knopiconen niet zichtbaar voor Mac OS X-gebruikers.

  • titel

    snaar

NotificationItem

Eigenschappen

  • bericht

    snaar

    Aanvullende details over dit item.

  • titel

    snaar

    Titel van een item van een lijstmelding.

NotificationOptions

Eigenschappen

  • appIconMaskUrl

    string 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 meldingsactieknoppen.

  • contextBericht

    string optioneel

    Alternatieve meldingsinhoud met een lichter lettertype.

  • gebeurtenisTijd

    nummer optioneel

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

  • pictogramUrl

    string optioneel

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

    URL's kunnen een data-URL, een blob-URL of een URL relatief aan een resource in het .crx-bestand van deze extensie zijn

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

  • afbeeldingUrl

    string optioneel

    Verouderd sinds Chrome 59

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

    Een URL naar de miniatuur van een afbeelding voor meldingen van het type afbeelding. Voor URL's gelden dezelfde beperkingen als voor iconUrl .

  • isKlikbaar

    boolean optioneel

    Verouderd sinds Chrome 67

    Deze UI-hint wordt vanaf Chrome 67 genegeerd

  • artikelen

    NotificationItem [] optioneel

    Items voor meldingen over meerdere items. Gebruikers van Mac OS X zien alleen het eerste item.

  • bericht

    string optioneel

    Belangrijkste inhoud van de melding.

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

  • prioriteit

    nummer optioneel

    De prioriteit varieert van -2 tot 2. -2 is de laagste prioriteit. 2 is de hoogste. Nul is de standaardwaarde. Op platforms die geen meldingencentrum ondersteunen (Windows, Linux en Mac), resulteren -2 en -1 in een foutmelding, omdat meldingen met die prioriteit helemaal niet worden weergegeven.

  • voortgang

    nummer optioneel

    De huidige voortgang varieert van 0 tot 100.

  • vereisenInteractie

    boolean optioneel

    Chroom 50+

    Geeft aan dat de melding zichtbaar moet blijven op het scherm totdat de gebruiker de melding activeert of verwijdert. Deze optie staat standaard op 'false'.

  • stil

    boolean optioneel

    Chroom 70+

    Geeft aan dat er geen geluid of trillingen mogen worden gemaakt wanneer de melding wordt weergegeven. Deze optie staat standaard op 'false'.

  • titel

    string optioneel

    Titel van de melding (bijv. naam van de afzender bij e-mail).

    **Let op:** 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 om meldingen van de app of extensie weer te geven. Dit is de standaardinstelling tijdens de installatie.

"geweigerd"
Geeft aan dat de gebruiker ervoor heeft gekozen om 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()

chrome.notifications.clear(
  notificationId: string,
): Promise<boolean>

Wist de opgegeven melding.

Parameters

  • meldings-ID

    snaar

    De id van de te wissen melding. Deze wordt geretourneerd door notifications.create -methode.

Retourneren

  • Belofte<boolean>

    Chroom 116+

create()

chrome.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
): Promise<string>

Maakt en toont een melding.

Parameters

  • meldings-ID

    string optioneel

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

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

  • Inhoud van de melding.

Retourneren

  • Belofte<string>

    Chroom 116+

getAll()

chrome.notifications.getAll(): Promise<object>

Haalt alle meldingen van deze app of extensie op.

Retourneren

  • Belofte<object>

    Chroom 116+

getPermissionLevel()

chrome.notifications.getPermissionLevel(): Promise<PermissionLevel>

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

Retourneren

update()

chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
): Promise<boolean>

Werkt een bestaande melding bij.

Parameters

  • meldings-ID

    snaar

    De id van de bij te werken melding. Deze wordt geretourneerd door notifications.create -methode.

  • Inhoud van de melding waarnaar moet worden bijgewerkt.

Retourneren

  • Belofte<boolean>

    Chroom 116+

Evenementen

onButtonClicked

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

De gebruiker heeft op een knop in de melding gedrukt.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • meldings-ID

      snaar

    • knopIndex

      nummer

onClicked

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

De gebruiker heeft op een gebied van de melding geklikt dat geen knop is.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (notificationId: string) => void

    • meldings-ID

      snaar

onClosed

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

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

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • meldings-ID

      snaar

    • doorGebruiker

      Booleaanse

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 voor aangepaste meldingsinstellingen wordt niet langer ondersteund.

De gebruiker klikte op een link naar 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 ziet er als volgt uit: 

    () => void