Clients.openWindow()

La méthode openWindow() de l'interface Clients crée un nouveau niveau de contexte de navigation et charge une URL donnée. Si le script d'origine n'a pas la permission d'ouvrir une popup,   openWindow() lèvera une InvalidAccessError.

Dans Firefox, une méthode est authorisée d'ouvrir une popup seulement lorsqu'elle est appelée à la suite d'un click sur une notification.

Syntaxe

ServiceWorkerClients.openWindow(url).then(function(WindowClient) {
  // Faire quelque chose avec le WindowClient
});

Paramètres

url

Une USVString représentant l'URL que le client veut ouvrir dans une nouvelle fenêtre. Généralement, cette valeur doit être une URL de la même  origine que le script d'origine.

Valeur de retour

Une Promise qui résoud un objet WindowClient si l'URL est de la même origine que le service worker, et null value sinon.

Exemples

// Quand l'utilisateur click sur une notification, focus sur la fenêtre si elle existe,
// ou ouvre en une autre.
onotificationclick = function(event) {
  var found = false;
  clients.matchAll().then(function(clients) {
    for (i = 0; i < clients.length; i++) {
      if (clients[i].url === event.data.url) {
        // La fenêtre existe, focus dessus.
        found = true;
        clients[i].focus();
        break;
      }
    }
    if (!found) {
      // Crée une nouvelle fenêtre
      clients.openWindow(event.data.url).then(function(windowClient) {
        // Faire quelque chose avec le WindowClient
      });
    }
  });
};

Spécifications

Compatibilité des navigateurs

• [1] Avec Chrome 43 et suivant, vous pouvez ouvrir n'importe quelle URL. In Chrome 42 you could only open URLs on the same origin.