Clients

Experimental

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

L'interface Clients de l'API de Service Workers repésente un conteneur de liste d'objets Client.

Méthodes

Clients.get()
Récupère un service worker client correspondant à un id et le retourne dans une Promise.
Clients.matchAll()
Récupèere une liste de service worker clients et les retourne dans une Promise. On inclut un paramètre option pour retourner tous les services worker clients dont l'origine est la même que le service worker d'origine. Si option n'est pas inclut, la méthode retourne seulement les service worker clients controllés par le service worker.
Clients.openWindow()
Ouvre un service worker Client dans une nouvelle fenêtre de navigation.
Clients.claim()
Permet à un service worker actif de se définir comme étant le worker actif de la page quand le worker et la page sont dans la même portée.

Exemples

clients.matchAll(options).then(function(clients) {
  for(i = 0 ; i < clients.length ; i++) {
    if(clients[i] === 'index.html') {
      clients.openWindow(clients[i]);
      // ou faire quelque chose qui inclut le client concerné
    }
  }
});

Spécifications

Spécification Statut Commentaire
Service Workers
La définition de 'Clients' dans cette spécification.
Version de travail Initial definition

Compatibilité des navigateurs

BCD tables only load in the browser

À voir aussi :