From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/performance_timeline/index.html | 84 -------- files/fr/web/api/performance_timeline/index.md | 84 ++++++++ .../using_performance_timeline/index.html | 223 --------------------- .../using_performance_timeline/index.md | 223 +++++++++++++++++++++ 4 files changed, 307 insertions(+), 307 deletions(-) delete mode 100644 files/fr/web/api/performance_timeline/index.html create mode 100644 files/fr/web/api/performance_timeline/index.md delete mode 100644 files/fr/web/api/performance_timeline/using_performance_timeline/index.html create mode 100644 files/fr/web/api/performance_timeline/using_performance_timeline/index.md (limited to 'files/fr/web/api/performance_timeline') diff --git a/files/fr/web/api/performance_timeline/index.html b/files/fr/web/api/performance_timeline/index.html deleted file mode 100644 index db39bbf9bd..0000000000 --- a/files/fr/web/api/performance_timeline/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Performance Timeline API -slug: Web/API/Performance_Timeline -tags: - - API - - Guide - - Aperçu - - Performance - - Performance Web - - Overview - - Web Performance -translation_of: Web/API/Performance_Timeline ---- -
{{DefaultAPISidebar("Performance Timeline API")}}
- -

L'API Performance Timeline définit des extensions de l'interface Performance pour prendre en charge les mesures de latence côté client dans les applications. Ces extensions fournissent des interfaces permettant de récupérer les paramètres de saisie des performances en fonction de critères de filtrage spécifiques.

- -

La norme comprend également des interfaces qui permettent à une application de définir des retours (« callbacks ») d'observateur des performances, qui sont notifiés lorsque des événements de performance spécifiques sont ajoutés à la chronologie des performances du navigateur.

- -

Ce document fournit un aperçu des interfaces de la norme. Pour plus de détails sur les interfaces, voir les pages de référence et Utilisation de Performance Timeline.

- -

{{AvailableInWorkers}}

- -

Extensions de Performance

- -

L'API Performance Timeline étend l'interface Performance avec trois méthodes qui fournissent différents mécanismes pour obtenir un ensemble d'enregistrements des performances (métriques), en fonction des critères de filtrage spécifiés. Ces méthodes sont les suivantes :

- -
-
getEntries()
-
Renvoie toutes les entrées de performances enregistrées ou, éventuellement, les entrées basées sur les name, type de performance et/ou les initiatorType spécifiés. (tel qu'un élément HTML).
-
getEntriesByName()
-
Renvoie les entrées de performances enregistrées en fonction du name spécifié et éventuellement du type de performance.
-
getEntriesByType()
-
Renvoie les entrées de perfornances enregistrées en fonction des types de performances spécifiés.
-
- -

L'interface PerformanceEntry

- -

L'interface PerformanceEntry encapsule une unique entrée de performance, c'est-à-dire un point de donnée ou une métrique située sur la chronologie des performances. Cette interface possède quatre propriétés ; ces propriétés sont étendues (avec des contraintes supplémentaires) par d'autres interfaces (telles que PerformanceMark) :

- -
-
name
-
Le nom de l'entrée de performance lorsque la métrique a été créée.
-
entryType
-
Le type de mesure de performance (par exemple, « mark »).
-
startTime
-
Un horodatage haute résolution représentant l'heure de départ de l'entrée de performance.
-
duration
-
Un horodatage haute résolution représentant la valeur temporelle de la durée de l'événement de performance (certains types d'entrée de performance n'ont pas de concept de durée et cette valeur est fixée à '0' pour ces types).
-
- -

Cette interface comprend une méthode toJSON() qui renvoie la sérialisation de l'objet PerformanceEntry. La sérialisation varie selon le type de performance.

- -

Observateurs des performances

- -

{{SeeCompatTable}}

- -

Les interfaces d'observateurs de performance permettent à une application d'enregistrer un observateur pour des types d'événements de performance spécifiques. Lorsqu'un de ces types d'événements est enregistré, l'application est notifiée de l'événement via la fonction de rappel de l'observateur qui a été spécifiée lors de la création de l'observateur.

- -

Lorsque la fonction de rappel de l'observateur (callback) est invoquée, les paramètres incluent une liste des entrées de l'observateur de performance qui contient uniquement des entrées de performance observées. C'est-à-dire que la liste contient uniquement des entrées pour les types d'événements qui ont été spécifiés lorsque la méthode observe() de l'observateur a été invoquée. L'interface PerformanceObserverEntryList possède les trois mêmes méthodes getEntries*() que l'interface Performance. Cependant, notez qu'il y a une différence clé avec ces méthodes ; les versions PerformanceObserverEntryList sont utilisées pour récupérer les entrées de performance observées dans le rappel de l'observateur.

- -

Outre la méthode observe() de l'interface PerformanceObserver (qui sert à enregistrer les types d'entrées pour observer), l'interface PerformanceObserver possède également une méthode disconnect() qui empêche un observateur de recevoir d'autres événements.

- -
-

Note : Les observateurs de performance ont été ajoutés au Niveau 2 de la norme et n'ont pas été implémentés à grande échelle.

-
- -

État de la mise en œuvre

- -

Un résumé de l'état de mise en œuvre des interfaces est fourni ci-dessous, avec un lien vers des informations plus détaillées.

- - - -

Pour tester la prise en charge de ces interfaces par votre navigateur, vous pouvez exécuter l'application perf-api-support.

- -

Voir aussi

- - diff --git a/files/fr/web/api/performance_timeline/index.md b/files/fr/web/api/performance_timeline/index.md new file mode 100644 index 0000000000..db39bbf9bd --- /dev/null +++ b/files/fr/web/api/performance_timeline/index.md @@ -0,0 +1,84 @@ +--- +title: Performance Timeline API +slug: Web/API/Performance_Timeline +tags: + - API + - Guide + - Aperçu + - Performance + - Performance Web + - Overview + - Web Performance +translation_of: Web/API/Performance_Timeline +--- +
{{DefaultAPISidebar("Performance Timeline API")}}
+ +

L'API Performance Timeline définit des extensions de l'interface Performance pour prendre en charge les mesures de latence côté client dans les applications. Ces extensions fournissent des interfaces permettant de récupérer les paramètres de saisie des performances en fonction de critères de filtrage spécifiques.

+ +

La norme comprend également des interfaces qui permettent à une application de définir des retours (« callbacks ») d'observateur des performances, qui sont notifiés lorsque des événements de performance spécifiques sont ajoutés à la chronologie des performances du navigateur.

+ +

Ce document fournit un aperçu des interfaces de la norme. Pour plus de détails sur les interfaces, voir les pages de référence et Utilisation de Performance Timeline.

+ +

{{AvailableInWorkers}}

+ +

Extensions de Performance

+ +

L'API Performance Timeline étend l'interface Performance avec trois méthodes qui fournissent différents mécanismes pour obtenir un ensemble d'enregistrements des performances (métriques), en fonction des critères de filtrage spécifiés. Ces méthodes sont les suivantes :

+ +
+
getEntries()
+
Renvoie toutes les entrées de performances enregistrées ou, éventuellement, les entrées basées sur les name, type de performance et/ou les initiatorType spécifiés. (tel qu'un élément HTML).
+
getEntriesByName()
+
Renvoie les entrées de performances enregistrées en fonction du name spécifié et éventuellement du type de performance.
+
getEntriesByType()
+
Renvoie les entrées de perfornances enregistrées en fonction des types de performances spécifiés.
+
+ +

L'interface PerformanceEntry

+ +

L'interface PerformanceEntry encapsule une unique entrée de performance, c'est-à-dire un point de donnée ou une métrique située sur la chronologie des performances. Cette interface possède quatre propriétés ; ces propriétés sont étendues (avec des contraintes supplémentaires) par d'autres interfaces (telles que PerformanceMark) :

+ +
+
name
+
Le nom de l'entrée de performance lorsque la métrique a été créée.
+
entryType
+
Le type de mesure de performance (par exemple, « mark »).
+
startTime
+
Un horodatage haute résolution représentant l'heure de départ de l'entrée de performance.
+
duration
+
Un horodatage haute résolution représentant la valeur temporelle de la durée de l'événement de performance (certains types d'entrée de performance n'ont pas de concept de durée et cette valeur est fixée à '0' pour ces types).
+
+ +

Cette interface comprend une méthode toJSON() qui renvoie la sérialisation de l'objet PerformanceEntry. La sérialisation varie selon le type de performance.

+ +

Observateurs des performances

+ +

{{SeeCompatTable}}

+ +

Les interfaces d'observateurs de performance permettent à une application d'enregistrer un observateur pour des types d'événements de performance spécifiques. Lorsqu'un de ces types d'événements est enregistré, l'application est notifiée de l'événement via la fonction de rappel de l'observateur qui a été spécifiée lors de la création de l'observateur.

+ +

Lorsque la fonction de rappel de l'observateur (callback) est invoquée, les paramètres incluent une liste des entrées de l'observateur de performance qui contient uniquement des entrées de performance observées. C'est-à-dire que la liste contient uniquement des entrées pour les types d'événements qui ont été spécifiés lorsque la méthode observe() de l'observateur a été invoquée. L'interface PerformanceObserverEntryList possède les trois mêmes méthodes getEntries*() que l'interface Performance. Cependant, notez qu'il y a une différence clé avec ces méthodes ; les versions PerformanceObserverEntryList sont utilisées pour récupérer les entrées de performance observées dans le rappel de l'observateur.

+ +

Outre la méthode observe() de l'interface PerformanceObserver (qui sert à enregistrer les types d'entrées pour observer), l'interface PerformanceObserver possède également une méthode disconnect() qui empêche un observateur de recevoir d'autres événements.

+ +
+

Note : Les observateurs de performance ont été ajoutés au Niveau 2 de la norme et n'ont pas été implémentés à grande échelle.

+
+ +

État de la mise en œuvre

+ +

Un résumé de l'état de mise en œuvre des interfaces est fourni ci-dessous, avec un lien vers des informations plus détaillées.

+ + + +

Pour tester la prise en charge de ces interfaces par votre navigateur, vous pouvez exécuter l'application perf-api-support.

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/performance_timeline/using_performance_timeline/index.html b/files/fr/web/api/performance_timeline/using_performance_timeline/index.html deleted file mode 100644 index c3554f1927..0000000000 --- a/files/fr/web/api/performance_timeline/using_performance_timeline/index.html +++ /dev/null @@ -1,223 +0,0 @@ ---- -title: Utilisation de Performance Timeline -slug: Web/API/Performance_Timeline/Using_Performance_Timeline -tags: - - Guide - - Performance - - Performance Web - - Web Performance -translation_of: Web/API/Performance_Timeline/Using_Performance_Timeline ---- -
{{DefaultAPISidebar("Performance Timeline API")}}
- -

La norme Performance Timeline définit des extensions de l'interface Performance pour prendre en charge les mesures de latence côté client au sein des applications.

- -

La norme comprend également des interfaces qui permettent à une application d'être notifiée lorsque des événements de performance spécifiques se produisent. Ensemble, ces interfaces peuvent être utilisées pour aider à identifier les goulots d'étranglement des performances d'une application.

- -

Extensions de Performance

- -

Performance Timeline étend l'objet Performance avec trois méthodes qui fournissent différents mécanismes pour obtenir un ensemble d'enregistrements des performances (métriques), selon les critères de filtrage spécifiés. L'exemple suivant montre l'utilisation de ces méthodes getEntries(), getEntriesByName() et getEntriesByType().

- -
-function log(s) {
-  let o = document.getElementsByTagName("output")[0];
-  o.innerHTML += s + " <br>";
-}
-function do_work(n) {
-  for (let i=0 ; i < n; i++) {
-      let m = Math.random();
-  }
-}
-function print_perf_entry(pe) {
-  log("..name: " + pe.name +
-      "; entryType: " + pe.entryType +
-      "; startTime: " + pe.startTime +
-      "; duration: " + pe.duration);
-}
-function print_PerformanceEntries() {
-  if (performance.mark === undefined) {
-    log("... performance.mark Not supported");
-    return;
-  }
-
-  // Crée quelques entrées de performance via les méthodes mark() et measure()
-  performance.mark("Begin");
-  do_work(50000);
-  performance.mark("End");
-  do_work(50000);
-  performance.measure("Measure1", "Begin", "End");
-
-  // Utilise getEntries() pour itérer toutes les entrées.
-  let p = performance.getEntries();
-  for (let i=0; i < p.length; i++) {
-    log("Toutes les entrées [" + i + "]");
-    print_perf_entry(p[i]);
-  }
-
-  // Utilise getEntries(name, entryType) pour obtenir des entrées spécifiques.
-  p = performance.getEntries({name : "Measure1", entryType:   "measure"});
-  for (let i=0; i < p.length; i++) {
-    log("Begin et Measure [" + i + "]");
-    print_perf_entry(p[i]);
-  }
-
-  // Utilisez getEntriesByType() pour obtenir toutes les entrées "mark".
-  p = performance.getEntriesByType("mark");
-  for (let i=0; i < p.length; i++) {
-    log ("Mark seulement [" + i + "]");
-    print_perf_entry(p[i]);
-  }
-
-  // Utilise getEntriesByName() pour obtenir toutes les entrées "mark" nommées "Begin".
-  p = performance.getEntriesByName("Begin", "mark");
-  for (let i=0; i < p.length; i++) {
-    log ("Begin et Mark [" + i + "]");
-    print_perf_entry(p[i]);
-  }
-}
-
- -

L'interface PerformanceEntry

- -

L'interface PerformanceEntry encapsule une seule entrée de performance, c'est-à-dire une seule métrique de performance. Cette interface possède quatre propriétés et un sérialiseur JSON : (toJSON(). L'exemple suivant montre l'utilisation de ces propriétés.

- -
-function print_PerformanceEntry(ev) {
-  let properties = ["name", "entryType", "startTime", "duration"];
-
-  // Crée quelques entrées de performance
-  performance.mark("Start");
-  do_work(50000);
-  performance.mark("Stop");
-  performance.measure("measure-1");
-
-  let p = performance.getEntries();
-  for (let i=0; i < p.length; i++) {
-    log("PerfEntry[" + i + "]");
-    for (let =0; j < properties.length; j++) {
-      // check each property in window.performance
-      let supported = properties[j] in p[i];
-      if (supported) {
-        let pe = p[i];
-        log("... " + properties[j] + " = " + pe[properties[j]]);
-      } else {
-        log("... " + properties[j] + " = N'est pas pris en charge");
-      }
-    }
-  }
-}
-
- -

Cette interface comprend également une méthode toJSON() qui renvoie la sérialisation de l'objet PerformanceEntry. Les exemples suivants montrent l'utilisation de cette méthode.

- -
-function PerfEntry_toJSON() {
-
-  // Crée quelques entrées de performance
-  performance.mark("mark-1");
-  performance.mark("mark-2");
-  performance.measure("meas-1", "mark-1", "mark-2");
-
-  let peList = performance.getEntries();
-  let pe = peList[0];
-
-  if (pe.toJSON === undefined) {
-    log("PerformanceEntry.toJSON() n'est PAS pris en charge");
-    return;
-  }
-
-  // Imprime l'objet PerformanceEntry
-  let json = pe.toJSON();
-  let s = JSON.stringify(json);
-  log("PerformanceEntry.toJSON = " + s);
-}
-
- -

Observateurs de performance

- -

{{SeeCompatTable}}

- -

Les interfaces Performance Observer permettent à une application d'enregistrer un observateur pour des types d'événements de performance spécifiques, et lorsqu'un de ces types d'événements est enregistré, l'application est notifiée de l'événement via la fonction de rappel de l'observateur qui a été spécifiée au moment, où l'observateur a été créé. Lorsque l'observateur (rappel ou « callback ») est invoqué, les paramètres du rappel incluent une liste d'entrées de l'observateur de performance qui contient uniquement des entrées de performance observées. C'est-à-dire que la liste ne contient que des entrées pour les types d'événements qui ont été spécifiés lorsque la méthode observe() de l'observateur a été invoquée.

- -

L'exemple suivant montre comment enregistrer deux observateurs : le premier s'enregistre pour plusieurs types d'événements et le second ne s'enregistre que pour un seul type d'événement.

- -
-function PerformanceObservers() {
-  // Crée un observateur pour tous les types d'événements de performance
-  let observe_all = new PerformanceObserver(function(list, obs) {
-    let perfEntries;
-
-    // Imprime toutes les entrées
-    perfEntries = list.getEntries();
-    for (let i=0; i < perfEntries.length; i++) {
-      print_perf_entry(perfEntries[i]);
-    }
-
-    // Imprime les entrées nommées "Begin" avec le type "mark".
-    perfEntries = list.getEntriesByName("Begin", "mark");
-    for (let i=0; i < perfEntries.length; i++) {
-      print_perf_entry(perfEntries[i]);
-    }
-
-    // Imprime les entrées avec le type "mark".
-    perfEntries = list.getEntriesByType("mark");
-    for (let i=0; i < perfEntries.length; i++) {
-      print_perf_entry(perfEntries[i]);
-    }
-  });
-  // inscrit tous les types d'événements liés aux performances
-  observe_all.observe({entryTypes: ['frame', 'mark', 'measure', 'navigation', 'resource', 'server']});
-
-  // Crée un observateur pour le seul type d'événement "mark".
-  let observe_mark = new PerformanceObserver(function(list, obs) {
-    let perfEntries = list.getEntries();
-    // Ne devrait avoir que des entrées de type "mark".
-    for (let i=0; i < perfEntries.length; i++) {
-      print_perf_entry(perfEntries[i]);
-    }
-  });
-  // inscrit uniquement l'événement "mark".
-  observe_mark.observe({entryTypes: ['mark']});
-}
-function print_perf_entry(pe) {
-  log("name: " + pe.name +
-      "; entryType: " + pe.entryType +
-      "; startTime: " + pe.startTime +
-      "; duration: " + pe.duration);
-}
-
- -

L'interface liste des entrées de l'observateur de performance possède les trois mêmes méthodes getEntries*() que l'interface Performance et ces méthodes sont utilisées pour récupérer les entrées de performance observées dans le rappel de l'observateur. Ces méthodes ont été utilisées dans l'exemple cité ci-dessus.

- -

Spécifications

- -

Les interfaces décrites dans ce document sont définies dans la norme Performance Timeline qui comporte deux niveaux :

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline', '#extensions-to-the-performance-interface', 'Performance extensions')}}{{Spec2('Performance Timeline')}}Définition des méthodes getEntries(), getEntriesByType() et getEntriesByName().
{{SpecName('Performance Timeline Level 2', '#extensions-to-the-performance-interface', 'Performance extensions')}}{{Spec2('Performance Timeline Level 2')}}Modifications de l'interface getEntries().
- -

Voir aussi

- - diff --git a/files/fr/web/api/performance_timeline/using_performance_timeline/index.md b/files/fr/web/api/performance_timeline/using_performance_timeline/index.md new file mode 100644 index 0000000000..c3554f1927 --- /dev/null +++ b/files/fr/web/api/performance_timeline/using_performance_timeline/index.md @@ -0,0 +1,223 @@ +--- +title: Utilisation de Performance Timeline +slug: Web/API/Performance_Timeline/Using_Performance_Timeline +tags: + - Guide + - Performance + - Performance Web + - Web Performance +translation_of: Web/API/Performance_Timeline/Using_Performance_Timeline +--- +
{{DefaultAPISidebar("Performance Timeline API")}}
+ +

La norme Performance Timeline définit des extensions de l'interface Performance pour prendre en charge les mesures de latence côté client au sein des applications.

+ +

La norme comprend également des interfaces qui permettent à une application d'être notifiée lorsque des événements de performance spécifiques se produisent. Ensemble, ces interfaces peuvent être utilisées pour aider à identifier les goulots d'étranglement des performances d'une application.

+ +

Extensions de Performance

+ +

Performance Timeline étend l'objet Performance avec trois méthodes qui fournissent différents mécanismes pour obtenir un ensemble d'enregistrements des performances (métriques), selon les critères de filtrage spécifiés. L'exemple suivant montre l'utilisation de ces méthodes getEntries(), getEntriesByName() et getEntriesByType().

+ +
+function log(s) {
+  let o = document.getElementsByTagName("output")[0];
+  o.innerHTML += s + " <br>";
+}
+function do_work(n) {
+  for (let i=0 ; i < n; i++) {
+      let m = Math.random();
+  }
+}
+function print_perf_entry(pe) {
+  log("..name: " + pe.name +
+      "; entryType: " + pe.entryType +
+      "; startTime: " + pe.startTime +
+      "; duration: " + pe.duration);
+}
+function print_PerformanceEntries() {
+  if (performance.mark === undefined) {
+    log("... performance.mark Not supported");
+    return;
+  }
+
+  // Crée quelques entrées de performance via les méthodes mark() et measure()
+  performance.mark("Begin");
+  do_work(50000);
+  performance.mark("End");
+  do_work(50000);
+  performance.measure("Measure1", "Begin", "End");
+
+  // Utilise getEntries() pour itérer toutes les entrées.
+  let p = performance.getEntries();
+  for (let i=0; i < p.length; i++) {
+    log("Toutes les entrées [" + i + "]");
+    print_perf_entry(p[i]);
+  }
+
+  // Utilise getEntries(name, entryType) pour obtenir des entrées spécifiques.
+  p = performance.getEntries({name : "Measure1", entryType:   "measure"});
+  for (let i=0; i < p.length; i++) {
+    log("Begin et Measure [" + i + "]");
+    print_perf_entry(p[i]);
+  }
+
+  // Utilisez getEntriesByType() pour obtenir toutes les entrées "mark".
+  p = performance.getEntriesByType("mark");
+  for (let i=0; i < p.length; i++) {
+    log ("Mark seulement [" + i + "]");
+    print_perf_entry(p[i]);
+  }
+
+  // Utilise getEntriesByName() pour obtenir toutes les entrées "mark" nommées "Begin".
+  p = performance.getEntriesByName("Begin", "mark");
+  for (let i=0; i < p.length; i++) {
+    log ("Begin et Mark [" + i + "]");
+    print_perf_entry(p[i]);
+  }
+}
+
+ +

L'interface PerformanceEntry

+ +

L'interface PerformanceEntry encapsule une seule entrée de performance, c'est-à-dire une seule métrique de performance. Cette interface possède quatre propriétés et un sérialiseur JSON : (toJSON(). L'exemple suivant montre l'utilisation de ces propriétés.

+ +
+function print_PerformanceEntry(ev) {
+  let properties = ["name", "entryType", "startTime", "duration"];
+
+  // Crée quelques entrées de performance
+  performance.mark("Start");
+  do_work(50000);
+  performance.mark("Stop");
+  performance.measure("measure-1");
+
+  let p = performance.getEntries();
+  for (let i=0; i < p.length; i++) {
+    log("PerfEntry[" + i + "]");
+    for (let =0; j < properties.length; j++) {
+      // check each property in window.performance
+      let supported = properties[j] in p[i];
+      if (supported) {
+        let pe = p[i];
+        log("... " + properties[j] + " = " + pe[properties[j]]);
+      } else {
+        log("... " + properties[j] + " = N'est pas pris en charge");
+      }
+    }
+  }
+}
+
+ +

Cette interface comprend également une méthode toJSON() qui renvoie la sérialisation de l'objet PerformanceEntry. Les exemples suivants montrent l'utilisation de cette méthode.

+ +
+function PerfEntry_toJSON() {
+
+  // Crée quelques entrées de performance
+  performance.mark("mark-1");
+  performance.mark("mark-2");
+  performance.measure("meas-1", "mark-1", "mark-2");
+
+  let peList = performance.getEntries();
+  let pe = peList[0];
+
+  if (pe.toJSON === undefined) {
+    log("PerformanceEntry.toJSON() n'est PAS pris en charge");
+    return;
+  }
+
+  // Imprime l'objet PerformanceEntry
+  let json = pe.toJSON();
+  let s = JSON.stringify(json);
+  log("PerformanceEntry.toJSON = " + s);
+}
+
+ +

Observateurs de performance

+ +

{{SeeCompatTable}}

+ +

Les interfaces Performance Observer permettent à une application d'enregistrer un observateur pour des types d'événements de performance spécifiques, et lorsqu'un de ces types d'événements est enregistré, l'application est notifiée de l'événement via la fonction de rappel de l'observateur qui a été spécifiée au moment, où l'observateur a été créé. Lorsque l'observateur (rappel ou « callback ») est invoqué, les paramètres du rappel incluent une liste d'entrées de l'observateur de performance qui contient uniquement des entrées de performance observées. C'est-à-dire que la liste ne contient que des entrées pour les types d'événements qui ont été spécifiés lorsque la méthode observe() de l'observateur a été invoquée.

+ +

L'exemple suivant montre comment enregistrer deux observateurs : le premier s'enregistre pour plusieurs types d'événements et le second ne s'enregistre que pour un seul type d'événement.

+ +
+function PerformanceObservers() {
+  // Crée un observateur pour tous les types d'événements de performance
+  let observe_all = new PerformanceObserver(function(list, obs) {
+    let perfEntries;
+
+    // Imprime toutes les entrées
+    perfEntries = list.getEntries();
+    for (let i=0; i < perfEntries.length; i++) {
+      print_perf_entry(perfEntries[i]);
+    }
+
+    // Imprime les entrées nommées "Begin" avec le type "mark".
+    perfEntries = list.getEntriesByName("Begin", "mark");
+    for (let i=0; i < perfEntries.length; i++) {
+      print_perf_entry(perfEntries[i]);
+    }
+
+    // Imprime les entrées avec le type "mark".
+    perfEntries = list.getEntriesByType("mark");
+    for (let i=0; i < perfEntries.length; i++) {
+      print_perf_entry(perfEntries[i]);
+    }
+  });
+  // inscrit tous les types d'événements liés aux performances
+  observe_all.observe({entryTypes: ['frame', 'mark', 'measure', 'navigation', 'resource', 'server']});
+
+  // Crée un observateur pour le seul type d'événement "mark".
+  let observe_mark = new PerformanceObserver(function(list, obs) {
+    let perfEntries = list.getEntries();
+    // Ne devrait avoir que des entrées de type "mark".
+    for (let i=0; i < perfEntries.length; i++) {
+      print_perf_entry(perfEntries[i]);
+    }
+  });
+  // inscrit uniquement l'événement "mark".
+  observe_mark.observe({entryTypes: ['mark']});
+}
+function print_perf_entry(pe) {
+  log("name: " + pe.name +
+      "; entryType: " + pe.entryType +
+      "; startTime: " + pe.startTime +
+      "; duration: " + pe.duration);
+}
+
+ +

L'interface liste des entrées de l'observateur de performance possède les trois mêmes méthodes getEntries*() que l'interface Performance et ces méthodes sont utilisées pour récupérer les entrées de performance observées dans le rappel de l'observateur. Ces méthodes ont été utilisées dans l'exemple cité ci-dessus.

+ +

Spécifications

+ +

Les interfaces décrites dans ce document sont définies dans la norme Performance Timeline qui comporte deux niveaux :

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Performance Timeline', '#extensions-to-the-performance-interface', 'Performance extensions')}}{{Spec2('Performance Timeline')}}Définition des méthodes getEntries(), getEntriesByType() et getEntriesByName().
{{SpecName('Performance Timeline Level 2', '#extensions-to-the-performance-interface', 'Performance extensions')}}{{Spec2('Performance Timeline Level 2')}}Modifications de l'interface getEntries().
+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf