diff options
Diffstat (limited to 'files/fr/web/api/performanceobserverentrylist/getentries/index.md')
| -rw-r--r-- | files/fr/web/api/performanceobserverentrylist/getentries/index.md | 96 |
1 files changed, 42 insertions, 54 deletions
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 --- -<div>{{APIRef("Performance Timeline API")}}</div> +{{APIRef("Performance Timeline API")}} -<p>La méthode <strong><code>getEntries()</code></strong> de l'interface <a href="/fr/docs/Web/API/PerformanceObserverEntryList"><code>PerformanceObserverEntryList</code></a> retourne une liste d'objets explicitement <em>observés</em> d'<a href="/fr/docs/Web/API/PerformanceEntry">entrées de performance</a> pour un filtre donné. Les membres de la liste sont déterminés par l'ensemble des <a href="/fr/docs/Web/API/PerformanceEntry/entryType">types d'entrée</a> spécifiés dans l'appel à la méthode <a href="/fr/docs/Web/API/PerformanceObserver/observe"><code>observe()</code></a>. La liste est disponible dans la fonction de rappel de l'observateur (en tant que premier paramètre de la fonction de rappel).</p> +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). -<div class="note"> - <p><strong>Note :</strong> Cette interface est exposée à <a href="/fr/docs/Web/API/Window"><code>Window</code></a> et <a href="/fr/docs/Web/API/Worker"><code>Worker</code></a>.</p> -</div> +> **Note :** Cette interface est exposée à [`Window`](/fr/docs/Web/API/Window) et [`Worker`](/fr/docs/Web/API/Worker). -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">let <var>entries</var> = list.getEntries(); -<var>entries</var> = list.getEntries(<var>PerformanceEntryFilterOptions</var>);</pre> +```js +let entries = list.getEntries(); +entries = list.getEntries(PerformanceEntryFilterOptions); +``` -<p>Utilisation spécifique :</p> +Utilisation spécifique : -<pre class="brush: js"><var>entries</var> = list.getEntries({name: "entry_name", entryType: "mark"});</pre> +```js +entries = list.getEntries({name: "entry_name", entryType: "mark"}); +``` -<h3 id="Parameters">Paramètres</h3> +### 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). -<dl> - <dt><code><em>PerformanceEntryFilterOptions</em></code> {{optional_inline}}</dt> - <dd>Est un dictionnaire <code>PerformanceEntryFilterOptions</code>, comportant les champs suivants : - <ul> - <li><code>"name"</code>, le nom d'une entrée de performance.</li> - <li><code>"entryType"</code>, le type d'entrée. Les types d'entrée valides sont énumérés dans la propriété <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>PerformanceEntry.entryType</code></a>.</li> - <li><code>"initiatorType"</code>, le type de la ressource initiatrice (par exemple un élément HTML). Les valeurs sont définies par la propriété <a href="/fr/docs/Web/API/PerformanceResourceTiming/initiatorType"><code>PerformanceResourceTiming.initiatorType</code></a>.</li> - </ul> Ce paramètre n'est actuellement pas pris en charge par Chrome ou Opera. - </dd> -</dl> -<h3 id="Return_Value">Valeur de retour</h3> +### Valeur de retour -<p>Une liste d'objets <a href="/fr/docs/Web/API/PerformanceEntry"><code>PerformanceEntry</code></a> explicitement <em>observés</em> qui répondent aux critères du filtre. Les éléments seront dans l'ordre chronologique basé sur les <a href="/fr/docs/Web/API/PerformanceEntry/startTime"><code>startTime</code></a> 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.</p> +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. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">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']}); -</pre> - -<h2 id="Specifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Performance Timeline Level 2', - '#dom-performanceobserverentrylist-getentries', 'getEntries()')}}</td> - <td>{{Spec2('Performance Timeline Level 2')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.PerformanceObserverEntryList.getEntries")}}</p> +``` + +## 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")}} |