blob: d288321d4c492eae3e4ae48bada33fef0b14c46a (
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
|
---
title: PerformanceObserver
slug: Web/API/PerformanceObserver
tags:
- API
- Interface
- Performance Observer API
- PerformanceObserver
- Reference
- Performance Web
- observers
translation_of: Web/API/PerformanceObserver
---
{{APIRef("Performance Timeline API")}}
L'interface **`PerformanceObserver`** est utilisée pour _observer_ les événements de mesure des performances et être notifié des nouvelles [entréés de performance](/fr/docs/Web/API/PerformanceEntry) lorsqu'elles sont enregistrées dans la _chronologie des performances_ du navigateur.
{{AvailableInWorkers}}
## Constructeur
- [`PerformanceObserver()`](/fr/docs/Web/API/PerformanceObserver/PerformanceObserver)
- : Crée et retourne un nouvel objet `PerformanceObserver`.
## Méthodes
- [`PerformanceObserver.observe()`](/fr/docs/Web/API/PerformanceObserver/observe)
- : Spécifie l'ensemble des [types d'entrées](/fr/docs/Web/API/PerformanceEntry/entryType) à observer. La fonction de rappel de l'observateur de performances sera invoquée lorsqu'une [entrée de performance](/fr/docs/Web/API/PerformanceEntry) est enregistrée pour l'un des `entryTypes` spécifiés.
- [`PerformanceObserver.disconnect()`](/fr/docs/Web/API/PerformanceObserver/disconnect)
- : Arrête l'observation des [entrées de performances](/fr/docs/Web/API/PerformanceEntry).
- [`PerformanceObserver.takeRecords()`](/fr/docs/Web/API/PerformanceObserver/takeRecords) {{Experimental_Inline}}
- : Renvoie la liste actuelle des [entrées de performances](/fr/docs/Web/API/PerformanceEntry) stockées dans l'observateur de performance, en la vidant.
## Exemple
```js
function perf_observer(list, observer) {
// Traiter l'événement "measure".
}
const observer2 = new PerformanceObserver(perf_observer);
observer2.observe({entryTypes: ["measure"]});
```
## Spécifications
| Spécification | Statut | Commentaire |
| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------- |
| {{SpecName('Performance Timeline Level 2', '#dom-performanceobserver', 'PerformanceObserver')}} | {{Spec2('Performance Timeline Level 2')}} | Définition initiale de l'interface `PerformanceObserver`. |
## Compatibilité des navigateurs
{{Compat("api.PerformanceObserver")}}
## Voir aussi
- [`MutationObserver`](/fr/docs/Web/API/MutationObserver)
- [`ResizeObserver`](/fr/docs/Web/API/ResizeObserver)
- [`IntersectionObserver`](/fr/docs/Web/API/IntersectionObserver)
|
