diff options
Diffstat (limited to 'files/fr/web/api/performance')
-rw-r--r-- | files/fr/web/api/performance/index.html | 119 | ||||
-rw-r--r-- | files/fr/web/api/performance/navigation/index.html | 52 | ||||
-rw-r--r-- | files/fr/web/api/performance/now/index.html | 77 |
3 files changed, 248 insertions, 0 deletions
diff --git a/files/fr/web/api/performance/index.html b/files/fr/web/api/performance/index.html new file mode 100644 index 0000000000..e139a6ac71 --- /dev/null +++ b/files/fr/web/api/performance/index.html @@ -0,0 +1,119 @@ +--- +title: Performance +slug: Web/API/Performance +tags: + - API + - Performance + - Performance Web +translation_of: Web/API/Performance +--- +<div>{{APIRef("Navigation Timing")}}</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>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> + +<h2 id="Propriétés">Propriétés</h2> + +<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> +</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> + +<p> </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> +</dl> + +<h2 id="Events">Events</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> + +<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> +</dl> + +<h2 id="Spécifications">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> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div> +<div> + + +<p>{{Compat("api.Performance")}}</p> +</div> +</div> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>Interfaces liées : {{domxref("PerformanceTiming")}}, {{domxref("PerformanceNavigation")}}.</li> +</ul> diff --git a/files/fr/web/api/performance/navigation/index.html b/files/fr/web/api/performance/navigation/index.html new file mode 100644 index 0000000000..7435d8c4ae --- /dev/null +++ b/files/fr/web/api/performance/navigation/index.html @@ -0,0 +1,52 @@ +--- +title: Performance.navigation +slug: Web/API/Performance/navigation +tags: + - HTTP + - Performance + - Propriété + - lecture seule +translation_of: Web/API/Performance/navigation +--- +<p>{{APIRef("Navigation Timing")}}</p> + +<h2 id="Summary">Summary</h2> + +<p>La propriété en lecture seule <code><strong>Performance</strong></code><strong><code>.navigation</code></strong> permet d'accéder à un objet de type {{domxref("PerformanceNavigation")}} représentant la navigation qui a lieu dans le contexte courant, par êxemple, le nombre de redirections.</p> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox"><em>navObject</em> = <em>performance</em>.navigation;</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('Navigation Timing', '#sec-window.performance-attribute', 'Performance.navigation')}}</td> + <td>{{Spec2('Navigation Timing')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + +<div> +<div> + + +<p>{{Compat("api.Performance.navigation")}}</p> +</div> +</div> + +<h2 id="See_also">See also</h2> + +<ul> + <li>The {{domxref("Performance")}} interface it belongs to.</li> +</ul> diff --git a/files/fr/web/api/performance/now/index.html b/files/fr/web/api/performance/now/index.html new file mode 100644 index 0000000000..6c325d6d4d --- /dev/null +++ b/files/fr/web/api/performance/now/index.html @@ -0,0 +1,77 @@ +--- +title: Performance.now() +slug: Web/API/Performance/now +tags: + - API + - API Performance Web + - Méthode + - Performance + - Reference +translation_of: Web/API/Performance/now +--- +<p>{{APIRef("High Resolution Timing")}}</p> + +<p>La méthode <code><strong>Performance.now()</strong></code> retourne un {{domxref("DOMHighResTimeStamp")}}, mesuré en millisecondes, avec une précision de 5 millième de milliseconde (5 microsecondes).</p> + +<p> </p> + +<p>La valeur retournée représente le temps écoulé depuis l'origine de temps.</p> + +<p>Gardez présents à l'esprit les points suivants :</p> + +<ul> + <li>Dans les workers dédiés créés à partir d'un contexte {{domxref("Window")}}, la valeur dans le worker sera inférieure à <code>performance.now()</code> dans la fenêtre qui a créé ce worker. C'était auparavant la même chose que le <code>t0</code> du contexte principal, mais cela a été changé.</li> + <li>Dans les workers partagés ou de service, la valeur dans le worker peut être supérieure à celle du contexte principal, car cette fenêtre peut être créée après ces workers.</li> +</ul> + +<p> </p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<div class="geckoVersionNote"> +<p class="syntaxbox">t = performance.now();</p> +</div> + +<h2 id="Exemple">Exemple</h2> + +<pre class="brush: js">var t0 = performance.now(); +faireQuelqueChose(); +var t1 = performance.now(); +console.log("L'appel à faireQuelqueChose a pris " + (t1 - t0) + " millisecondes.") +</pre> + +<p>Contrairement aux autres données de temps disponibles en JavaScript (par exemple <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Date/now" title="/en-US/docs/JavaScript/Reference/Global_Objects/Date/now"><code>Date.now</code></a>), les horodatages retournés par <code>Performance.now()</code> ne sont pas limités à une précision d'une milliseconde. Au contraire, ils représentent les temps comme des nombres flottants avec une précision pouvant aller jusqu'à une microseconde.</p> + +<p>Également contrairement à <code>Date.now()</code>, les valeurs retournées par <code>Performance.now() </code>sont toujours incrémentées à un taux constant, indépendant de l'horloge du système (qui peut être ajustée manuellement ou par l'intermédiaire d'un logiciel comme NTP). Sinon, <code>performance.timing.navigationStart + performance.now()</code> sera approximativement égal à <code>Date.now().</code></p> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaire</th> + </tr> + <tr> + <td>{{SpecName('Highres Time Level 2', '#dom-performance-now', 'performance.now()')}}</td> + <td>{{Spec2('Highres Time Level 2')}}</td> + <td>Définitions plus strictes des interfaces et des types.</td> + </tr> + <tr> + <td>{{SpecName('Highres Time', '#dom-performance-now', 'Performance.now()')}}</td> + <td>{{Spec2('Highres Time')}}</td> + <td>Définition initiale</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.Performance.now")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="http://updates.html5rocks.com/2012/08/When-milliseconds-are-not-enough-performance-now" title="http://updates.html5rocks.com/2012/08/When-milliseconds-are-not-enough-performance-now">When milliseconds are not enough: performance.now() </a>de HTML5 Rocks.</li> +</ul> |