diff options
Diffstat (limited to 'files/fr/web/api/performanceelementtiming/rendertime/index.md')
-rw-r--r-- | files/fr/web/api/performanceelementtiming/rendertime/index.md | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/files/fr/web/api/performanceelementtiming/rendertime/index.md b/files/fr/web/api/performanceelementtiming/rendertime/index.md new file mode 100644 index 0000000000..b541771563 --- /dev/null +++ b/files/fr/web/api/performanceelementtiming/rendertime/index.md @@ -0,0 +1,68 @@ +--- +title: PerformanceElementTiming.renderTime +slug: Web/API/PerformanceElementTiming/renderTime +tags: + - API + - Property + - Propriété + - Reference + - renderTime + - PerformanceElementTiming +translation_of: Web/API/PerformanceElementTiming/renderTime +--- +<div>{{APIRef("Element Timing API")}}</div> + +<p>La propriété en lecture seule <strong><code>renderTime</code></strong> de l'interface <a href="/fr/docs/Web/API/PerformanceElementTiming"><code>PerformanceElementTiming</code></a> renvoie le temps écoulé pour le rendu de l'élément associé.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush:js">var <var>renderTime</var> = PerformanceElementTiming.renderTime;</pre> + +<h3>Valeur</h3> +<p>Un objet <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>DOMHighResTimeStamp</code></a> avec le temps de rendu de l'élément.</p> + +<p>Pour les images, il s'agira de l'<strong>horodatage du rendu de l'image</strong>. Ceci est défini comme le moment du rendu suivant le chargement complet de l'image. Si la vérification de l'autorisation de temporisation échoue (comme défini par l'en-tête <a href="/fr/docs/Web/HTTP/Headers/Timing-Allow-Origin">Timing-allow-origin</a>), ceci retournera 0.</p> + +<p>Pour les nœuds de texte, il s'agira de l'<strong>horodatage du rendu du texte</strong>. Ceci est défini comme le moment où l'élément est affiché à l'écran.</p> + +<h2 id="Examples">Exemples</h2> + +<p>Dans cet exemple, appeler <code>entry.renderTime</code> renvoie le temps de rendu de l'élément image.</p> + +<pre class="brush:html"><img src="image.jpg" alt="une belle image" elementtiming="big-image" id="myImage"></pre> + +<pre class="brush:js">const <var>observer</var> = new PerformanceObserver((list) => { + let <var>entries</var> = list.getEntries().forEach(function (entry) { + if (entry.identifier === "big-image") { + console.log(entry.renderTime); + } + }); +}); +observer.observe({ entryTypes: ["element"] });</pre> + +<div class="note"> + <p><strong>Note :</strong> Cet exemple utilise l'interface <a href="/fr/docs/Web/API/PerformanceObserver"><code>PerformanceObserver</code></a> pour créer une liste d'événements de mesure des performances. Dans notre cas, nous observons l'élément <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>PerformanceEntry.entryType</code></a> afin d'utiliser l'interface <code>PerformanceElementTiming</code>.</p> +</div> + +<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('Element Timing API','#dom-performanceelementtiming-rendertime','PerformanceElementTiming.renderTime')}}</td> + <td>{{Spec2('Element Timing API')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceElementTiming.renderTime")}}</p> |