diff options
Diffstat (limited to 'files/fr/web/api/performance/index.html')
| -rw-r--r-- | files/fr/web/api/performance/index.html | 197 |
1 files changed, 117 insertions, 80 deletions
diff --git a/files/fr/web/api/performance/index.html b/files/fr/web/api/performance/index.html index e139a6ac71..46d8e44241 100644 --- a/files/fr/web/api/performance/index.html +++ b/files/fr/web/api/performance/index.html @@ -3,117 +3,154 @@ title: Performance slug: Web/API/Performance tags: - API + - Navigation Timing - Performance - Performance Web + - Reference translation_of: Web/API/Performance --- -<div>{{APIRef("Navigation Timing")}}</div> +<div>{{APIRef("High Resolution Time")}}</div> -<p>L'interface <strong><code>Performance</code></strong> donne accès à des informations liées aux performances pour la page actuelle. Elle fait partie de l'API High Resolution Time, mais est complétée par les APIs <a href="/en-US/docs/Web/API/Performance_Timeline">Performance Timeline</a>, <a href="/en-US/docs/Web/API/Navigation_timing_API">Navigation Timing</a>, <a href="/en-US/docs/Web/API/User_Timing_API">User Timing</a>, et <a href="/en-US/docs/Web/API/Resource_Timing_API">Resource Timing</a>.</p> +<p class="seoSummary">L'interface <strong><code>Performance</code></strong> donne accès à des informations liées aux performances pour la page actuelle. Elle fait partie de l'API « High Resolution Time », mais est complétée par les APIs <a href="/fr/docs/Web/API/Performance_Timeline">Performance Timeline</a>, <a href="/fr/docs/Web/API/Navigation_timing_API">Navigation Timing</a>, <a href="/fr/docs/Web/API/User_Timing_API">User Timing</a>, et <a href="/fr/docs/Web/API/Resource_Timing_API">Resource Timing</a>.</p> -<p>Un objet de ce type peut être obtenu en appelant l'attribut en lecture seule {{domxref("Window.performance")}}.</p> +<p>Un objet de ce type peut être obtenu en appelant l'attribut en lecture seule {{domxref("window.performance")}}.</p> -<div class="note"> -<p><strong><em>Note</em>: </strong>Cette interface et ses attributs sont accessibles aux {{domxref("Web Worker")}} sauf dans les cas cités ci-dessous. Notez également que les marqueurs et les mesures de performance sont définis par contexte. Si vous créez un marqueur dans le processus principal (ou un autre Web Worker), vous ne pourrez pas le voir dans le processus du Web Worker, et réciproquement.</p> +<div class="notecard note"> + <p><strong>Note :</strong> Cette interface et ses attributs sont accessibles aux <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a> via <code><a href="/fr/docs/Web/API/WorkerGlobalScope/performance">WorkerGlobalScope.performance</a></code> sauf dans les cas cités ci-dessous. Notez également que les marqueurs et les mesures de performance sont définis par contexte. Si vous créez un marqueur dans le processus principal (ou un autre Web Worker), vous ne pourrez pas le voir dans le processus du Web Worker, et réciproquement.</p> </div> -<h2 id="Propriétés">Propriétés</h2> +<h2 id="Properties">Propriétés</h2> -<p><em>L'interface<code>Performance</code> n'hérite d'aucune propriété.</em></p> +<p><em>L'interface <code>Performance</code> n'hérite d'aucune propriété.</em></p> <dl> - <dt>{{deprecated_inline}} {{domxref("performance.navigation")}} {{readonlyInline}}</dt> - <dd>{{domxref("PerformanceNavigation")}} est un objet qui fournit des informations contextuelles sur les opérations inclues dans les indicateurs de <code>timing</code>, notamment si la page a été chargée ou actualisée, combien de redirections ont été effectuées, etc… Indisponible dans les Web Workers.</dd> + <dt> + {{domxref("performance.navigation")}} {{readonlyInline}} {{deprecated_inline}} + </dt> + <dd> + {{domxref("PerformanceNavigation")}} est un objet qui fournit des informations contextuelles sur les opérations incluses dans les indicateurs de <code>timing</code>, notamment si la page a été chargée ou actualisée, combien de redirections ont été effectuées, etc… + <div class="notecard note"> + <p>Indisponible dans les Web Workers.</p> + </div> + </dd> + <dt> + {{domxref("performance.timing")}} {{readonlyInline}} {{deprecated_inline}} + </dt> + <dd> + {{domxref("PerformanceTiming")}} est un objet contenant des informations de performance liées à la latence. + <div class="notecard note"> + <p>Indisponible dans les Web Workers.</p> + </div> + </dd> + <dt> + {{domxref("performance.memory")}} {{readonlyInline}} {{Non-standard_inline}}</dt> + <dd> + Une extension <em>non standard</em> ajoutée dans Chrome, cette propriété fournit à un objet des informations de base sur l'utilisation de la mémoire. <em>Vous <strong>ne devriez pas utiliser</strong> cette API non standard.</em> + </dd> + <dt> + {{domxref("Performance.timeOrigin")}} {{readonlyInline}} {{Experimental_inline}} + </dt> + <dd> + Fournit un horodatage haute résolution de l'heure de début de la mesure de performance. + </dd> </dl> -<dl> - <dt>{{deprecated_inline}} {{domxref("performance.timing")}} {{readonlyInline}}</dt> - <dd>{{domxref("PerformanceTiming")}} est un objet contenant des informations de performance liées à la latence. Indisponible dans les Web Workers.</dd> - <dt>{{domxref("performance.memory")}} {{Non-standard_inline}}</dt> - <dd>{{domxref("PerformanceNavigation")}} est un objet non-standard ajouté dans Chrome, contenant des informations basiques d'utilisation de la mémoire.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<p><em><em>L'interface <code>Performance</code> n'hérite d'aucune méthode</em></em>.</p> - -<p> </p> - -<dl> - <dt>{{domxref("performance.clearMarks()")}}</dt> - <dd>Supprime le <em>marqueur</em> indiqué des données de performances du navigateur mises en mémoire tampon.</dd> - <dt>{{domxref("performance.clearMeasures()")}}</dt> - <dd>Supprime la <em>mesure</em> indiquée des données de performances du navigateur mises en mémoire tampon.</dd> - <dt>{{domxref("performance.clearResourceTimings()")}}</dt> - <dd>Supprime toutes les {{domxref("PerformanceEntry","entrées de performance")}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} "<code>resource</code>" des données de performances du navigateur mises en mémoire tampon.</dd> - <dt>{{domxref("performance.getEntries()")}}</dt> - <dd>Retourne une liste d'objets {domxref("PerformanceEntry")}} basée sur le <em>filter</em> indiqué.</dd> - <dt>{{domxref("performance.getEntriesByName()")}}</dt> - <dd>Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le <em>nom</em> d'entrée indiqué.</dd> - <dt>{{domxref("performance.getEntriesByType()")}}</dt> - <dd>Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le <em>type</em> d'entrée indiqué.</dd> - <dt>{{domxref("performance.mark()")}}</dt> - <dd>Crée un {{domxref("DOMHighResTimeStamp","timestamp")}} avec le nom indiqué, dans la mémoire tampon du navigateur dédiée aux performances.</dd> - <dt>{{domxref("performance.measure()")}}</dt> - <dd>Crée un {{domxref("DOMHighResTimeStamp","timestamp")}} nommé, dans la mémoire tampon du navigateur dédiée aux performances, entre deux marqueurs spécifiques (connus comme le <em>marqueur de début</em> et le <em>marqueur de fin</em>, respectivement).</dd> -</dl> +<h2 id="Methods">Méthodes</h2> -<p> </p> +<p><em>L'interface <code>Performance</code> n'hérite d'aucune méthode</em>.</p> <dl> - <dt>{{domxref("Performance.now()")}}</dt> - <dd>Retourne un objet {{domxref("DOMHighResTimeStamp")}} représentant le nombre de millisecondes écoulées depuis un instant donné.</dd> - <dt>{{domxref("performance.setResourceTimingBufferSize()")}}</dt> - <dd>Configure la taille de la mémoire tampon pour le chronométrage des ressources du navigateur, avec le nombre indiqué de {{domxref("PerformanceEntry.entryType","type")}} d'{{domxref("PerformanceEntry","performance entry")}}objets "<code>resource</code>" .</dd> - <dt>{{domxref("Performance.toJSON()")}} {{non-standard_inline}}</dt> - <dd>Retourne un objet JSON représentant l'objet <code>Performance</code>.</dd> - <dt> </dt> + <dt>{{domxref("performance.clearMarks()")}}</dt> + <dd>Supprime le <em>marqueur</em> indiqué des données de performances du navigateur mises en mémoire tampon.</dd> + <dt>{{domxref("performance.clearMeasures()")}}</dt> + <dd>Supprime la <em>mesure</em> indiquée des données de performances du navigateur mises en mémoire tampon.</dd> + <dt>{{domxref("performance.clearResourceTimings()")}}</dt> + <dd>Supprime toutes les {{domxref("PerformanceEntry","entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} "<code>resource</code>" des données de performances du navigateur mises en mémoire tampon.</dd> + <dt>{{domxref("performance.getEntries()")}}</dt> + <dd>Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le <em>filtre</em> indiqué.</dd> + <dt>{{domxref("performance.getEntriesByName()")}}</dt> + <dd>Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le <em>nom</em> indiqué.</dd> + <dt>{{domxref("performance.getEntriesByType()")}}</dt> + <dd>Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le <em>type</em> indiqué.</dd> + <dt>{{domxref("performance.mark()")}}</dt> + <dd>Crée un {{domxref("DOMHighResTimeStamp","timestamp")}} avec le nom indiqué, dans la mémoire tampon du navigateur dédiée aux performances.</dd> + <dt>{{domxref("performance.measure()")}}</dt> + <dd>Crée un {{domxref("DOMHighResTimeStamp","timestamp")}} nommé, dans la mémoire tampon du navigateur dédiée aux performances, entre deux marqueurs spécifiques (connus comme le <em>marqueur de début</em> et le <em>marqueur de fin</em>, respectivement).</dd> + <dt>{{domxref("Performance.now()")}}</dt> + <dd>Retourne un objet {{domxref("DOMHighResTimeStamp")}} représentant le nombre de millisecondes écoulées depuis un instant donné.</dd> + <dt>{{domxref("performance.setResourceTimingBufferSize()")}}</dt> + <dd>Configure la taille de la mémoire tampon pour le chronométrage des ressources du navigateur. La valeur passée en argument indiquera le nombre maximal d'objets {{domxref("PerformanceEntry")}} ayant le {{domxref("PerformanceEntry.entryType","type")}} "<code>resource</code>" qu'il sera possible d'y stocker.</dd> + <dt>{{domxref("Performance.toJSON()")}}</dt> + <dd>Retourne un objet JSON représentant l'objet <code>Performance</code>.</dd> </dl> -<h2 id="Events">Events</h2> +<h2 id="Events">Événements</h2> -<p>Écoutez ces événéments en utilisant <code>addEventListener()</code> ou en assignant un écouteur d'événément à la propriété <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">on<em>EventName</em> de cette interface.</span></font></p> +<p>On pourra écouter ces événements en utilisant <code>addEventListener()</code> ou en assignant un gestionnaire d'événement à la propriété <code>on<em><EventName></em></code> de cette interface.</p> <dl> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/API/Performance/resourcetimingbufferfull_event">resourcetimingbufferfull</a></code></dt> - <dd>Déclenchée quaund les ressources de la mémoire tampon du navigateur pour le chronométrage est pleine.<br> - Également disponible via la propriété <code><a href="https://developer.mozilla.org/en-US/docs/Web/API/Performance/onresourcetimingbufferfull">onresourcetimingbufferfull</a></code>.</dd> + <dt>{{DOMxRef("Performance.resourcetimingbufferfull_event", "resourcetimingbufferfull")}}</dt> + <dd>Déclenché lorsque le <a href="/fr/docs/Web/API/Performance/setResourceTimingBufferSize">tampon de synchronisation des ressources</a> du navigateur est plein. Également disponible via la propriété {{DOMxRef("Performance.onresourcetimingbufferfull", "onresourcetimingbufferfull")}}.</dd> </dl> -<h2 id="Spécifications">Spécifications</h2> +<h2 id="Specifications">Spécifications</h2> <table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('Highres Time', '#sec-extenstions-performance-interface', 'Performance')}}</td> - <td>{{Spec2('Highres Time')}}</td> - <td>Ajout de la méthode <code>now()</code>.</td> - </tr> - <tr> - <td>{{SpecName('Navigation Timing', '#sec-window.performance-attribute', 'Performance')}}</td> - <td>{{Spec2('Navigation Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('Highres Time Level 2', '#sec-performance', 'Performance')}}</td> + <td>{{Spec2('Highres Time Level 2')}}</td> + <td>Définition de la méthode <code>toJson()</code>.</td> + </tr> + <tr> + <td>{{SpecName('Highres Time', '#performance', 'Performance')}}</td> + <td>{{Spec2('Highres Time')}}</td> + <td>Définition de la méthode <code>now()</code>.</td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline Level 2', '#extensions-to-the-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td>Changements sur l'interface <code>getEntries()</code>.</td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline', '#extensions-to-the-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('Performance Timeline')}}</td> + <td>Définition des méthodes <code>getEntries()</code>, <code>getEntriesByType()</code> et <code>getEntriesByName()</code>.</td> + </tr> + <tr> + <td>{{SpecName('Resource Timing', '#extensions-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('Resource Timing')}}</td> + <td>Définition des méthodes <code>clearResourceTimings()</code> et <code>setResourceTimingBufferSize()</code> et de la propriété <code>onresourcetimingbufferfull</code>.</td> + </tr> + <tr> + <td>{{SpecName('User Timing Level 2', '#extensions-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('User Timing Level 2')}}</td> + <td>Clarifications des méthodes <code>mark()</code>, <code>clearMark()</code>, <code>measure()</code> et <code>clearMeasure()</code>.</td> + </tr> + <tr> + <td>{{SpecName('User Timing', '#extensions-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('User Timing')}}</td> + <td>Définition des méthodes <code>mark()</code>, <code>clearMark()</code>, <code>measure()</code> et <code>clearMeasure()</code>.</td> + </tr> + </tbody> </table> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<div> -<div> - +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> <p>{{Compat("api.Performance")}}</p> -</div> -</div> -<h2 id="Voir_aussi">Voir aussi</h2> +<h2 id="See_Also">Voir aussi</h2> <ul> - <li>Interfaces liées : {{domxref("PerformanceTiming")}}, {{domxref("PerformanceNavigation")}}.</li> + <li><a href="/fr/docs/Web/API/Performance_Timeline">Performance Timeline</a></li> + <li><a href="/fr/docs/Web/API/Navigation_timing_API">Navigation Timing API</a></li> + <li><a href="/fr/docs/Web/API/User_Timing_API">User Timing API</a></li> + <li><a href="/fr/docs/Web/API/Resource_Timing_API">Resource Timing API</a></li> </ul> |