---
title: ServiceWorkerRegistration.getNotifications()
slug: Web/API/ServiceWorkerRegistration/getNotifications
tags:
  - API
  - API Service worker
  - Expérimentale
  - Méthode
  - Notifications
  - Reference
  - Service Workers
  - ServiceWorkerRegistration
  - getNotifications
translation_of: Web/API/ServiceWorkerRegistration/getNotifications
---
<div>{{APIRef("Service Workers API")}}</div>

<p><span class="seoSummary">La méthode <strong><code>getNotifications()</code></strong> de l'interface {{domxref ("ServiceWorkerRegistration")}} renvoie une liste des notifications dans l'ordre dans lequel elles ont été créées à partir de l'origine actuelle via l'enregistrement actuel du service worker. Les origines peuvent avoir de nombreuses inscriptions de service worker actives mais de portée différente. Les notifications créées par un service worker sur la même origine ne seront pas disponibles pour les autres services workers actifs sur la même origine.</span></p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="syntaxbox notranslate"><em>s​erviceWorkerRegistration</em>.getNotifications(<em>options</em>)
.then(function(<em>notificationsList</em>) { ... })</pre>

<h3 id="Paramétres">Paramétres</h3>

<dl>
 <dt>options {{optional_inline}}</dt>
 <dd>Un objet contenant des options pour filtrer les notifications renvoyées. Les options disponibles sont:
 <ul>
  <li><code>tag</code>: Un {{domxref ("DOMString")}} représentant un tag de notification. Si spécifié, seules les notifications contenant cette balise seront renvoyées.</li>
 </ul>
 </dd>
</dl>

<h3 id="Valeur_de_retour">Valeur de retour</h3>

<p>Une {{jsxref ("Promise", "Promesse")}} qui se résout en une liste d'objets {{domxref ("Notification")}}.</p>

<h2 id="Exemple">Exemple</h2>

<pre class="brush: js notranslate">navigator.serviceWorker.register('sw.js')

const options = { tag: 'user_alerts' }

navigator.serviceWorker.ready.then((registration) =&gt; {
  registration.getNotifications(options).then((notifications) =&gt; {
    // do something with your notifications
  })
})
</pre>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
   <th scope="col">Commentaire</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Notifications', '#dom-serviceworkerregistration-getnotifications', 'ServiceWorkerRegistration.getNotifications()')}}</td>
   <td>{{Spec2('Web Notifications')}}</td>
   <td>Définition initiale</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("api.ServiceWorkerRegistration.getNotifications")}}</p>