From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- .../getentries/index.md | 96 ++++++++++------------ .../getentriesbyname/index.md | 80 ++++++++---------- .../getentriesbytype/index.md | 74 +++++++---------- .../web/api/performanceobserverentrylist/index.md | 67 ++++++--------- 4 files changed, 131 insertions(+), 186 deletions(-) (limited to 'files/fr/web/api/performanceobserverentrylist') diff --git a/files/fr/web/api/performanceobserverentrylist/getentries/index.md b/files/fr/web/api/performanceobserverentrylist/getentries/index.md index 6e86d57d99..099c4e1090 100644 --- a/files/fr/web/api/performanceobserverentrylist/getentries/index.md +++ b/files/fr/web/api/performanceobserverentrylist/getentries/index.md @@ -10,44 +10,45 @@ tags: - Performance Web translation_of: Web/API/PerformanceObserverEntryList/getEntries --- -
{{APIRef("Performance Timeline API")}}
+{{APIRef("Performance Timeline API")}} -

La méthode getEntries() de l'interface PerformanceObserverEntryList retourne une liste d'objets explicitement observés d'entrées de performance pour un filtre donné. Les membres de la liste sont déterminés par l'ensemble des types d'entrée spécifiés dans l'appel à la méthode observe(). La liste est disponible dans la fonction de rappel de l'observateur (en tant que premier paramètre de la fonction de rappel).

+La méthode **`getEntries()`** de l'interface [`PerformanceObserverEntryList`](/fr/docs/Web/API/PerformanceObserverEntryList) retourne une liste d'objets explicitement _observés_ d'[entrées de performance](/fr/docs/Web/API/PerformanceEntry) pour un filtre donné. Les membres de la liste sont déterminés par l'ensemble des [types d'entrée](/fr/docs/Web/API/PerformanceEntry/entryType) spécifiés dans l'appel à la méthode [`observe()`](/fr/docs/Web/API/PerformanceObserver/observe). La liste est disponible dans la fonction de rappel de l'observateur (en tant que premier paramètre de la fonction de rappel). -
-

Note : Cette interface est exposée à Window et Worker.

-
+> **Note :** Cette interface est exposée à [`Window`](/fr/docs/Web/API/Window) et [`Worker`](/fr/docs/Web/API/Worker). -

Syntaxe

+## Syntaxe -
let entries = list.getEntries();
-entries = list.getEntries(PerformanceEntryFilterOptions);
+```js +let entries = list.getEntries(); +entries = list.getEntries(PerformanceEntryFilterOptions); +``` -

Utilisation spécifique :

+Utilisation spécifique : -
entries = list.getEntries({name: "entry_name", entryType: "mark"});
+```js +entries = list.getEntries({name: "entry_name", entryType: "mark"}); +``` -

Paramètres

+### Paramètres + +- `PerformanceEntryFilterOptions` {{optional_inline}} + + - : Est un dictionnaire `PerformanceEntryFilterOptions`, comportant les champs suivants : + + - `"name"`, le nom d'une entrée de performance. + - `"entryType"`, le type d'entrée. Les types d'entrée valides sont énumérés dans la propriété [`PerformanceEntry.entryType`](/fr/docs/Web/API/PerformanceEntry/entryType). + - `"initiatorType"`, le type de la ressource initiatrice (par exemple un élément HTML). Les valeurs sont définies par la propriété [`PerformanceResourceTiming.initiatorType`](/fr/docs/Web/API/PerformanceResourceTiming/initiatorType). -
-
PerformanceEntryFilterOptions {{optional_inline}}
-
Est un dictionnaire PerformanceEntryFilterOptions, comportant les champs suivants : -
    -
  • "name", le nom d'une entrée de performance.
    • -
  • "entryType", le type d'entrée. Les types d'entrée valides sont énumérés dans la propriété PerformanceEntry.entryType.
    • -
  • "initiatorType", le type de la ressource initiatrice (par exemple un élément HTML). Les valeurs sont définies par la propriété PerformanceResourceTiming.initiatorType.
    • -
Ce paramètre n'est actuellement pas pris en charge par Chrome ou Opera. -
-
-

Valeur de retour

+### Valeur de retour -

Une liste d'objets PerformanceEntry explicitement observés qui répondent aux critères du filtre. Les éléments seront dans l'ordre chronologique basé sur les startTime des entrées. Si aucun objet répondant au filtre n'est trouvé, une liste vide est renvoyée. Si aucun argument n'est fourni, toutes les entrées sont renvoyées.

+Une liste d'objets [`PerformanceEntry`](/fr/docs/Web/API/PerformanceEntry) explicitement _observés_ qui répondent aux critères du filtre. Les éléments seront dans l'ordre chronologique basé sur les [`startTime`](/fr/docs/Web/API/PerformanceEntry/startTime) des entrées. Si aucun objet répondant au filtre n'est trouvé, une liste vide est renvoyée. Si aucun argument n'est fourni, toutes les entrées sont renvoyées. -

Exemple

+## Exemple -
function print_perf_entry(pe) {
+```js
+function print_perf_entry(pe) {
   console.log("name: " + pe.name +
               "; entryType: " + pe.entryType +
               "; startTime: " + pe.startTime +
@@ -60,19 +61,19 @@ const observe_all = new PerformanceObserver(function(list, obs) {
 
   // Imprime toutes les entrées
   perfEntries = list.getEntries();
-  for (let i = 0; i < perfEntries.length; i++) {
+  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++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 
   // Imprime les entrées de type "mark".
   perfEntries = list.getEntriesByType("mark");
-  for (let i = 0; i < perfEntries.length; i++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 });
@@ -82,34 +83,21 @@ observe_all.observe({entryTypes: ['frame', 'mark', 'measure', 'navigation', 'res
 const observe_frame = new PerformanceObserver(function(list, obs) {
   let perfEntries = list.getEntries();
   // Ne devrait avoir que des entrées "frame"
-  for (let i = 0; i < perfEntries.length; i++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 });
 // inscrire à l'événement "frame" uniquement
 observe_frame.observe({entryTypes: ['frame']});
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', - '#dom-performanceobserverentrylist-getentries', 'getEntries()')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceObserverEntryList.getEntries")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', + '#dom-performanceobserverentrylist-getentries', 'getEntries()')}} | {{Spec2('Performance Timeline Level 2')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceObserverEntryList.getEntries")}} diff --git a/files/fr/web/api/performanceobserverentrylist/getentriesbyname/index.md b/files/fr/web/api/performanceobserverentrylist/getentriesbyname/index.md index b92be9f1a5..c5bc6539fb 100644 --- a/files/fr/web/api/performanceobserverentrylist/getentriesbyname/index.md +++ b/files/fr/web/api/performanceobserverentrylist/getentriesbyname/index.md @@ -10,34 +10,33 @@ tags: - Performance Web translation_of: Web/API/PerformanceObserverEntryList/getEntriesByName --- -
{{APIRef("Performance Timeline API")}}
+{{APIRef("Performance Timeline API")}} -

La méthode getEntriesByName() de l'interface PerformanceObserverEntryList retourne une liste d'objets d'entrée de performance explicitement observés pour un name et entryType donnés. Les membres de la liste sont déterminés par l'ensemble des types d'entrées spécifiés dans l'appel à la méthode observe(). La liste est disponible dans la fonction de rappel de l'observateur (en tant que premier paramètre de la fonction de rappel).

+La méthode **`getEntriesByName()`** de l'interface [`PerformanceObserverEntryList`](/fr/docs/Web/API/PerformanceObserverEntryList) retourne une liste d'objets [d'entrée de performance](/fr/docs/Web/API/PerformanceEntry) explicitement _observés_ pour un _[`name`](/fr/docs/Web/API/PerformanceEntry/name)_ et _[`entryType`](/fr/docs/Web/API/PerformanceEntry/entryType)_ donnés. Les membres de la liste sont déterminés par l'ensemble des [types d'entrées](/fr/docs/Web/API/PerformanceEntry/entryType) spécifiés dans l'appel à la méthode [`observe()`](/fr/docs/Web/API/PerformanceObserver/observe). La liste est disponible dans la fonction de rappel de l'observateur (en tant que premier paramètre de la fonction de rappel). -
-

Note : Cette interface est exposée à Window et Worker.

-
+> **Note :** Cette interface est exposée à [`Window`](/fr/docs/Web/API/Window) et [`Worker`](/fr/docs/Web/API/Worker). -

Syntaxe

+## Syntaxe -
let entries = list.getEntriesByName(name, type);
+```js +let entries = list.getEntriesByName(name, type); +``` -

Paramètres

+### Paramètres -
-
name
-
Une chaîne de caractères DOMString représentant le nom de l'entrée à récupérer.
-
type {{optional_inline}}
-
Une chaîne de caractères DOMString représentant le type d'entrée à récupérer tel que « mark ». Les types d'entrée valides sont énumérés dans PerformanceEntry.entryType.
-
+- _`name`_ + - : Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString) représentant le nom de l'entrée à récupérer. +- _`type`_ {{optional_inline}} + - : Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString) représentant le type d'entrée à récupérer tel que « `mark` ». Les types d'entrée valides sont énumérés dans [`PerformanceEntry.entryType`](/fr/docs/Web/API/PerformanceEntry/entryType). -

Valeur de retour

+### Valeur de retour -

Une liste d'objets d'entrée de performance explicitement observés qui ont le name et le type spécifiés. Si l'argument type n'est pas spécifié, seul name sera utilisé pour déterminer les entrées à retourner. Les éléments seront triés dans l'ordre chronologique selon les startTime des entrées. Si aucun objet ne répond aux critères spécifiés, une liste vide est retournée.

+Une liste d'objets [d'entrée de performance](/fr/docs/Web/API/PerformanceEntry) explicitement _observés_ qui ont le `name` et le `type` spécifiés. Si l'argument `type` n'est pas spécifié, seul `name` sera utilisé pour déterminer les entrées à retourner. Les éléments seront triés dans l'ordre chronologique selon les [`startTime`](/fr/docs/Web/API/PerformanceEntry/startTime) des entrées. Si aucun objet ne répond aux critères spécifiés, une liste vide est retournée. -

Exemple

+## Exemple -
function print_perf_entry(pe) {
+```js
+function print_perf_entry(pe) {
   console.log("name: " + pe.name +
               "; entryType: " + pe.entryType +
               "; startTime: " + pe.startTime +
@@ -50,19 +49,19 @@ const observe_all = new PerformanceObserver(function(list, obs) {
 
   // Imprime toutes les entrées
   perfEntries = list.getEntries();
-  for (let i = 0; i < perfEntries.length; i++) {
+  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++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 
   // Imprime les entrées de type "mark".
   perfEntries = list.getEntriesByType("mark");
-  for (let i = 0; i < perfEntries.length; i++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 });
@@ -72,34 +71,21 @@ observe_all.observe({entryTypes: ['frame', 'mark', 'measure', 'navigation', 'res
 const observe_frame = new PerformanceObserver(function(list, obs) {
   let perfEntries = list.getEntries();
   // Ne devrait avoir que des entrées "frame"
-  for (let i = 0; i < perfEntries.length; i++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 });
 // inscrire à l'événement "frame" uniquement
 observe_frame.observe({entryTypes: ['frame']});
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', - '#dom-performanceobserverentrylist-getentriesbyname', 'getEntriesByName()')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale de la méthode getEntriesByName().
- -

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceObserverEntryList.getEntriesByName")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------- | +| {{SpecName('Performance Timeline Level 2', + '#dom-performanceobserverentrylist-getentriesbyname', 'getEntriesByName()')}} | {{Spec2('Performance Timeline Level 2')}} | Définition initiale de la méthode `getEntriesByName()`. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceObserverEntryList.getEntriesByName")}} diff --git a/files/fr/web/api/performanceobserverentrylist/getentriesbytype/index.md b/files/fr/web/api/performanceobserverentrylist/getentriesbytype/index.md index 8d692a3092..2289e174f0 100644 --- a/files/fr/web/api/performanceobserverentrylist/getentriesbytype/index.md +++ b/files/fr/web/api/performanceobserverentrylist/getentriesbytype/index.md @@ -10,32 +10,31 @@ tags: - Performance Web translation_of: Web/API/PerformanceObserverEntryList/getEntriesByType --- -
{{APIRef("Performance Timeline API")}}
+{{APIRef("Performance Timeline API")}} -

La méthode getEntriesByType() de la PerformanceObserverEntryList retourne une liste d'objets d'entrée de performance explicitement observés pour un type d'entrée de performance. Les membres de la liste sont déterminés par l'ensemble des types d'entrées spécifiés dans l'appel à la méthode observe(). La liste est disponible dans la fonction de rappel de l'observateur (en tant que premier paramètre de la fonction de rappel).

+La méthode **`getEntriesByType()`** de la [`PerformanceObserverEntryList`](/fr/docs/Web/API/PerformanceObserverEntryList) retourne une liste d'objets [d'entrée de performance](/fr/docs/Web/API/PerformanceEntry) explicitement _observés_ pour un [type d'entrée de performance](/fr/docs/Web/API/PerformanceEntry/entryType). Les membres de la liste sont déterminés par l'ensemble des [types d'entrées](/fr/docs/Web/API/PerformanceEntry/entryType) spécifiés dans l'appel à la méthode [`observe()`](/fr/docs/Web/API/PerformanceObserver/observe). La liste est disponible dans la fonction de rappel de l'observateur (en tant que premier paramètre de la fonction de rappel). -
-

Note : Cette interface est exposée à Window et Worker.

-
+> **Note :** Cette interface est exposée à [`Window`](/fr/docs/Web/API/Window) et [`Worker`](/fr/docs/Web/API/Worker). -

Syntaxe

+## Syntaxe -
let entries = list.getEntriesByType(type);
+```js +let entries = list.getEntriesByType(type); +``` -

Paramètres

+### Paramètres -
-
type
-
Le type d'entrée à récupérer, tel que « frame ». Les types d'entrée valides sont énumérés dans PerformanceEntry.entryType.
-
+- _`type`_ + - : Le type d'entrée à récupérer, tel que « `frame` ». Les types d'entrée valides sont énumérés dans [`PerformanceEntry.entryType`](/fr/docs/Web/API/PerformanceEntry/entryType). -

Valeur de retour

+### Valeur de retour -

Une liste d'objets PerformanceEntry explicitement observés qui ont le type spécifié. Les éléments seront dans l'ordre chronologique basé sur les startTime des entrées. Si aucun objet n'a le type spécifié, ou si aucun argument n'est fourni, une liste vide est retournée.

+Une liste d'objets [`PerformanceEntry`](/fr/docs/Web/API/PerformanceEntry) explicitement _observés_ qui ont le `type` spécifié. Les éléments seront dans l'ordre chronologique basé sur les [`startTime`](/fr/docs/Web/API/PerformanceEntry/startTime) des entrées. Si aucun objet n'a le `type` spécifié, ou si aucun argument n'est fourni, une liste vide est retournée. -

Exemple

+## Exemple -
function print_perf_entry(pe) {
+```js
+function print_perf_entry(pe) {
   console.log("name: " + pe.name +
               "; entryType: " + pe.entryType +
               "; startTime: " + pe.startTime +
@@ -48,19 +47,19 @@ const observe_all = new PerformanceObserver(function(list, obs) {
 
   // Imprime toutes les entrées
   perfEntries = list.getEntries();
-  for (let i = 0; i < perfEntries.length; i++) {
+  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++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 
   // Imprime les entrées de type "mark".
   perfEntries = list.getEntriesByType("mark");
-  for (let i = 0; i < perfEntries.length; i++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 });
@@ -70,33 +69,20 @@ observe_all.observe({entryTypes: ['frame', 'mark', 'measure', 'navigation', 'res
 const observe_frame = new PerformanceObserver(function(list, obs) {
   let perfEntries = list.getEntries();
   // Ne devrait avoir que des entrées "frame"
-  for (let i = 0; i < perfEntries.length; i++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
   }
 });
 // inscrire à l'événement "frame" uniquement
 observe_frame.observe({entryTypes: ['frame']});
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', '#dom-performanceobserverentrylist-getentriesbytype', 'getEntriesByType()')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale de la méthode getEntriesByType().
- -

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceObserverEntryList.getEntriesByType")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performanceobserverentrylist-getentriesbytype', 'getEntriesByType()')}} | {{Spec2('Performance Timeline Level 2')}} | Définition initiale de la méthode `getEntriesByType()`. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceObserverEntryList.getEntriesByType")}} diff --git a/files/fr/web/api/performanceobserverentrylist/index.md b/files/fr/web/api/performanceobserverentrylist/index.md index 14cfeaea9e..e4e86a8128 100644 --- a/files/fr/web/api/performanceobserverentrylist/index.md +++ b/files/fr/web/api/performanceobserverentrylist/index.md @@ -8,56 +8,41 @@ tags: - Performance Web translation_of: Web/API/PerformanceObserverEntryList --- -
{{APIRef("Performance Timeline API")}}
+{{APIRef("Performance Timeline API")}} -

L'interface PerformanceObserverEntryList est une liste d'événements de performance qui ont été explicitement observés via la méthode observe().

+L'interface **`PerformanceObserverEntryList`** est une liste d'[événements de performance](/fr/docs/Web/API/PerformanceEntry) qui ont été explicitement _observés_ via la méthode [`observe()`](/fr/docs/Web/API/PerformanceObserver/observe). -
-

Note : Cette interface est exposée à Window et Worker.

-
+> **Note :** Cette interface est exposée à [`Window`](/fr/docs/Web/API/Window) et [`Worker`](/fr/docs/Web/API/Worker). -

Méthodes

+## Méthodes -
-
PerformanceObserverEntryList.getEntries()
-
Retourne une liste d'objets explicitement observés de PerformanceEntry en fonction du filtre donné.
-
PerformanceObserverEntryList.getEntriesByType()
-
Retourne une liste d'objets explicitement observés de PerformanceEntry du type d'entrée donné.
-
PerformanceObserverEntryList.getEntriesByName()
-
Retourne une liste d'objets explicitement observés de PerformanceEntry en fonction du nom et du type d'entrée donnés.
-
+- [`PerformanceObserverEntryList.getEntries()`](/fr/docs/Web/API/PerformanceObserverEntryList/getEntries) + - : Retourne une liste d'objets explicitement _observés_ de [`PerformanceEntry`](/fr/docs/Web/API/PerformanceEntry) en fonction du _filtre_ donné. +- [`PerformanceObserverEntryList.getEntriesByType()`](/fr/docs/Web/API/PerformanceObserverEntryList/getEntriesByType) + - : Retourne une liste d'objets explicitement _observés_ de [`PerformanceEntry`](/fr/docs/Web/API/PerformanceEntry) du _type d'entrée_ donné. +- [`PerformanceObserverEntryList.getEntriesByName()`](/fr/docs/Web/API/PerformanceObserverEntryList/getEntriesByName) + - : Retourne une liste d'objets explicitement _observés_ de [`PerformanceEntry`](/fr/docs/Web/API/PerformanceEntry) en fonction du _nom_ et du _type d'entrée_ donnés. -

Exemple

+## Exemple -
// Crée un observateur pour tous les types d'événements de performance
+```js
+// Crée un observateur pour tous les types d'événements de performance
 // la liste est de type PerformanceObserveEntryList
 const observe_all = new PerformanceObserver(function(list, obs) {
   let perfEntries = list.getEntries();
-  for (let i = 0; i < perfEntries.length; i++) {
+  for (let i = 0; i < perfEntries.length; i++) {
     print_perf_entry(perfEntries[i]);
     // faire quelque chose avec
   }
-})
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', '#idl-def-performanceobserverentrylist', 'PerformanceObserverEntryList')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceObserverEntryList")}}

+}) +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', '#idl-def-performanceobserverentrylist', 'PerformanceObserverEntryList')}} | {{Spec2('Performance Timeline Level 2')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceObserverEntryList")}} -- cgit v1.2.3-54-g00ecf