aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/windowclient/focus/index.md
blob: 4d61feab28c28370958225877969db1a4f3b30d6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
---
title: WindowClient.focus()
slug: Web/API/WindowClient/focus
tags:
  - API
  - Client
  - Experimental
  - Focus
  - Method
  - Reference
  - Service Workers
  - WindowClient
translation_of: Web/API/WindowClient/focus
---
{{SeeCompatTable}}{{APIRef("Service Workers API")}}

La méthode **`focus()`** de l'interface {{domxref("WindowClient")}} focus le client en cours et retourne une {{jsxref("Promise")}} qui est résolue vers le {{domxref("WindowClient")}} existant.

## Syntaxe

    Client.focus().then(function(WindowClient) {
      // utilisez le WindowClient une fois qu'il est focus
    });

### Paramètres

Nil.

### Valeur de retour

Une {{jsxref("Promise")}} qui est résolue vers le {{domxref("WindowClient")}} existant.

## Exemple

```js
self.addEventListener('notificationclick', function(event) {
  console.log('On notification click: ', event.notification.tag);
  event.notification.close();

  // Vérifie si le client en cours est ouvert et
  // le focus le cas échéant
  event.waitUntil(clients.matchAll({
    type: "window"
  }).then(function(clientList) {
    for (var i = 0; i < clientList.length; i++) {
      var client = clientList[i];
      if (client.url == '/' && 'focus' in client)
        return client.focus();
    }
    if (clients.openWindow)
      return clients.openWindow('/');
  }));
});
```

## Spécifications

| Spécification                                                                            | État                                 | Commentaires          |
| ---------------------------------------------------------------------------------------- | ------------------------------------ | --------------------- |
| {{SpecName('Service Workers', '#client-focus-method', 'focus()')}} | {{Spec2('Service Workers')}} | Définition initiale.. |

## Compatibilité des navigateurs

{{Compat("api.WindowClient.focus")}}