diff options
author | tristantheb <tristantheb@users.noreply.github.com> | 2021-04-11 09:03:44 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-04-11 09:03:44 +0200 |
commit | 48a326c0d47c8f49eb50706420a33bfcbe24f2c7 (patch) | |
tree | 6540c8e657b8b62e625837cd61fce4b7e4026ced /files/fr/web/api/performanceentry | |
parent | a9d8a2a4f30880c92bae569bef655c4880cfe544 (diff) | |
download | translated-content-48a326c0d47c8f49eb50706420a33bfcbe24f2c7.tar.gz translated-content-48a326c0d47c8f49eb50706420a33bfcbe24f2c7.tar.bz2 translated-content-48a326c0d47c8f49eb50706420a33bfcbe24f2c7.zip |
L10N: Translation of all Performance APIs/Interfaces/Properties/Methods (#232)
* L10N: Translation of the Performance API pages
* L10N: Translation of the Performance Timeline API pages
* Fix typo, style and KS elements
* UPDATE: Update content of code blocks with the Guideline
* L10N: Translation of the PerformanceElementTiming pages
* L10N: Translation of the PerformanceEntry pages
* L10N: Translation of the PerformanceEventTiming interface
* L10N: Translation of the PerformanceFrameTiming interface
* L10N: Translation of the PerformanceLongTaskTiming interface
* L10N: Translation of the PerformanceMark interface
* L10N: Translation of the PerformanceMeasure interface
* L10N: Translation of the PerformanceNavigation interface
* L10N: Translation of the PerformanceNavigationTiming interface
* L10N: Translation of the PerformanceObserver interface
* L10N: Translation of the PerformanceObserverEntryList interface
* L10N: Translation of the PerformancePaintTiming interface
* L10N: Translation of the PerformanceResourceTiming interface
* L10N: Translation of the PerformanceServerTiming interface
* L10N: Translation of the PerformanceTiming interface
* FIX: Fix KS error on PerformanceTiming interface
* FIX: Change some summary and typo
* FIX: Fix CSS and sentences on PerformanceObserverEntryList interface
* FIX: Update KS + Change {{event()}} by link on PerformanceEventTiming interface
* Review - Landing page
* Review 'using' page - rm domxref
* Perforamance_timeline review: rm domxref, minor rewording, missing translation
* Review timeline guide page, rm domxref, rm vars in pre
* Review - PerformanceElementTiming - rm domxref + trailing spaces
* Review - PerformanceElementTiming.id - rm xref macros + trailing spaces
* Review - PerformanceElementTiming.identifier - rm xref macros + trailing spaces
* Review - PerformanceElementTiming - rm xref macros + trailing spaces
* Review - PET.intersectionrect - rm domxref / minor typos
* Undo spec table mixup
* Review - loadTime - rm domxref
* Review - naturalheight - rm domxref / trailing spaces
* Review - naturalwidth - rm domxref / trailing spaces
* Review - renderTime - rm domxref / trailing spaces / minor rewordings
* Review - tojson - rm domxref / trailing spaces
* Review - url - rm domxref / trailing spaces
* Review - duration - rm domxref / minor rewordings
* Review - entryType - rm domxref / minor rewordings
* Review - performanceentry index - rm domxref / minor rewordings
* Review PerformanceEntry.name - rm xref macros
* Review PerformanceEntry.startTime - rm xref macros
* Review PerformanceEntry.toJSON - rm xref macros
* Review PerformanceEventTiming - rm domxref
* Review PerformanceFrameTiming - rm xref macros
* Review PerformanceLongTaskTiming.attribution - rm xref macros
* Review PerformanceLongTaskTiming - rm xref macros
* Review - PerformanceMark - rm domxref
* Review - PerformanceMeasure - rm domxref
* Review - PerformanceNavigation - rm domxref
* Review - PerformanceNavigation.redirectcount - rm domxref
* Review - PerformanceNavigation.type - rm domxref
* Review - PerformanceNavigationTiming.domComplete - rm domxref
* Review - PerformanceNavigationTiming.domContentLoadedEvent - rm domxref
* Review - PerformanceNavigationTiming.domContentLoadedEventStart - rm domxref
* Review - PerformanceNavigationTiming.domInteractive - rm domxref
* Review - PerformanceNavigationTiming - rm domxref
* Review - PerformanceNavigationTiming.loadEventEnd - rm domxref
* Review - PerformanceNavigationTiming.loadEventStart - rm domxref
* Review - PerformanceNavigationTiming.redirectCount - rm domxref
* Review - PerformanceNavigationTiming.toJSON - rm domxref
* Review - PerformanceNavigationTiming.type - rm domxref
* Review - PerformanceNavigationTiming.unloadEventEnd - rm domxref
* Review - PerformanceNavigationTiming.unloadEventStart - rm domxref
* Remove DOMxRef for PerformanceTiming
* Remove DOMxRef for PerformanceServerTiming
* Remove DOMxRef for PerformanceResourceTiming
* Review - PerformanceObserver.disconnect - rm domxref
* Review - PerformanceObserver - rm domxref
* Review - PerformanceObserver.observe - rm domxref
* Review - PerformanceObserver.PerformanceObserver() - rm domxref
* Review - PerformanceObserver.takeRecords() - rm domxref
* Review - PerformanceObserverEntryList.getEntries() - rm domxref
* Review - PerformanceObserver.getEntriesByName() - rm domxref
* Review - PerformanceObserver.getEntriesByType() - rm domxref
* Review - PerformanceObserverEntryList - rm domxref
* Review - PerformanceResourceTiming.connectEnd - rm domxref
* Review - PerformanceResourceTiming.connectStart
* Review - PerformanceResourceTiming.decodedBodySize
* Review - PerformanceResourceTiming.domainLookupEnd
* Review - PerformanceResourceTiming.domainLookupStart
* Review - PerformanceResourceTiming.encodedBodySize
* Review - PerformanceResourceTiming.fetchStart
* Review - PerformanceResourceTiming
* Review - PerformanceResourceTiming.iniatorType
* Review - PerformanceResourceTiming.nextHopProtocol
* Review - PerformanceResourceTiming.redirectEnd
* Review - PerformanceResourceTiming.redirectStart
* Review - PerformanceResourceTiming.requestStart
* Review - PerformanceResourceTiming.responseEnd
* Review - PerformanceResourceTiming.responseStart
* Review - PerformanceResourceTiming.secureConnectionStart
* Review - PerformanceResourceTiming.toJSON()
* Review - PerformanceResourceTiming.transferSize
* Review - PerformanceResourceTiming.workerStart
* Review - PerformanceServerTiming.description
* Review - PerformanceServerTiming.duration
* Review - PerformanceServerTiming
* Review - PerformanceServerTiming.name
* Review - PerformanceServerTiming.toJSON()
* Review - PerformanceTiming.domComplete - rm Event
* Review - PerformanceTiming.domContentLoadedEventStart - rm Event
* Review - PerformanceTiming.domInteractive - rm Event
* Review - PerformanceTiming.domLoading - rm Event
* Review - PerformanceTiming - minor typos + thead spec
* Review - PerformanceTiming.loadEventEnd - rm Event
* Review - PerformanceTiming.loadEventStart - rm Event
* Review - PerformanceTiming.unloadEventEnd - rm Event
* Review - PerformanceTiming.unloadEventStart - rm Event
* Remove final domxref / rm var in examples
Co-authored-by: julieng <julien.gattelier@gmail.com>
Diffstat (limited to 'files/fr/web/api/performanceentry')
-rw-r--r-- | files/fr/web/api/performanceentry/duration/index.html | 120 | ||||
-rw-r--r-- | files/fr/web/api/performanceentry/entrytype/index.html | 138 | ||||
-rw-r--r-- | files/fr/web/api/performanceentry/index.html | 147 | ||||
-rw-r--r-- | files/fr/web/api/performanceentry/name/index.html | 150 | ||||
-rw-r--r-- | files/fr/web/api/performanceentry/starttime/index.html | 122 | ||||
-rw-r--r-- | files/fr/web/api/performanceentry/tojson/index.html | 107 |
6 files changed, 784 insertions, 0 deletions
diff --git a/files/fr/web/api/performanceentry/duration/index.html b/files/fr/web/api/performanceentry/duration/index.html new file mode 100644 index 0000000000..14b9f3e4e7 --- /dev/null +++ b/files/fr/web/api/performanceentry/duration/index.html @@ -0,0 +1,120 @@ +--- +title: PerformanceEntry.duration +slug: Web/API/PerformanceEntry/duration +tags: + - API + - PerformanceEntry + - Property + - Propriété + - Reference + - Performance Web +translation_of: Web/API/PerformanceEntry/duration +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">La propriété <strong><code>duration</code></strong> renvoie un <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> qui correspond à la durée de l'<a href="/fr/docs/Web/API/PerformanceEntry">entrée de performance</a>.</p> + +<p>{{AvailableInWorkers}}</p> + +<p>La valeur retournée par cette propriété dépend du <a href="/fr/docs/Web/API/PerformanceEntry/entryType">type</a> de l'entrée de performance :</p> + +<ul> + <li>« <code>frame</code> » - retourne un <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> indiquant la différence entre le <code>startTime</code> de deux <i>frames</i> successives.</li> + <li>« <code>mark</code> » - retourne "<code>0</code>" (une marque n'a pas de durée).</li> + <li>« <code>measure</code> » - retourne le <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> qui correspond à la durée de la mesure.</li> + <li>« <code>navigation</code> » - retourne le <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> qui est respectivement la différence entre les propriétés <a href="/fr/docs/Web/API/PerformanceNavigationTiming/loadEventEnd"><code>PerformanceNavigationTiming.loadEventEnd</code></a> et <a href="/fr/docs/Web/API/PerformanceEntry/startTime"><code>PerformanceEntry.startTime</code></a>.</li> + <li>« <code>resource</code> » - renvoie la différence entre les deux <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamps</code></a> <a href="/fr/docs/Web/API/PerformanceResourceTiming/responseEnd"><code>responseEnd</code></a> (le moment de la fin de la réponse) de la ressource et <a href="/fr/docs/Web/API/PerformanceEntry/startTime"><code>startTime</code></a> (le point de départ).</li> +</ul> + +<p>Cette propriété est en {{readonlyInline}}.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush:js"><em>entry</em>.duration;</pre> + +<h3 id="Return_Value">Valeur de retour</h3> + +<p>Un objet <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>DOMHighResTimeStamp</code></a> représentant la durée de l'<a href="/fr/docs/Web/API/PerformanceEntry">entrée de performance</a>. Si le concept de durée ne s'applique pas à une mesure de performance particulière, le navigateur peut choisir de renvoyer une durée de 0.</p> + +<div class="notecard note"> + <p><strong>Note :</strong> si l'entrée de performance a un <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>entryType</code></a> "<code>resource</code>" (c'est-à-dire que l'entrée est un objet <a href="/fr/docs/Web/API/PerformanceResourceTiming"><code>PerformanceResourceTiming</code></a>), cette propriété renvoie la différence entre les <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamps</code></a> <a href="/fr/docs/Web/API/PerformanceResourceTiming/responseEnd"><code>PerformanceEntry.responseEnd</code></a> et <a href="/fr/docs/Web/API/PerformanceEntry/startTime"><code>PerformanceEntry.startTime</code></a>.</p> +</div> + +<h2 id="Example">Exemple</h2> + +<p>L'exemple suivant montre l'utilisation de la propriété <code>duration</code>.</p> + +<pre class="brush:js">function run_PerformanceEntry() { + console.log("Support de PerformanceEntry ..."); + + if (performance.mark === undefined) { + console.log("... performance.mark N'est pas pris en charge"); + return; + } + + // Créer quelques entrées de performance via la méthode mark() + performance.mark("Begin"); + do_work(50000); + performance.mark("End"); + + // Utilise getEntries() pour itérer à travers chaque entrée. + let <var>p</var> = performance.getEntries(); + for (let <var>i</var>=0; i < p.length; i++) { + console.log("Entry[" + i + "]"); + check_PerformanceEntry(p[i]); + } +} +function check_PerformanceEntry(<var>obj</var>) { + let <var>properties</var> = ["name", "entryType", "startTime", "duration"]; + let <var>methods</var> = ["toJSON"]; + + for (let <var>i</var>=0; i < properties.length; i++) { + // check each property + let <var>supported</var> = properties[i] in obj; + if (supported) + console.log("..." + properties[i] + " = " + obj[properties[i]]); + else + console.log("..." + properties[i] + " = N'est pas pris en charge"); + } + for (let <var>i</var>=0; i < methods.length; i++) { + // check each method + let <var>supported</var> = typeof obj[methods[i]] == "function"; + if (supported) { + let <var>js</var> = obj[methods[i]](); + console.log("..." + methods[i] + "() = " + JSON.stringify(js)); + } else { + console.log("..." + methods[i] + " = N'est pas pris en charge"); + } + } +} +</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-performanceentry-duration', + 'duration')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline', '#dom-performanceentry-duration', + 'duration')}}</td> + <td>{{Spec2('Performance Timeline')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceEntry.duration")}}</p> diff --git a/files/fr/web/api/performanceentry/entrytype/index.html b/files/fr/web/api/performanceentry/entrytype/index.html new file mode 100644 index 0000000000..f2223e82cd --- /dev/null +++ b/files/fr/web/api/performanceentry/entrytype/index.html @@ -0,0 +1,138 @@ +--- +title: PerformanceEntry.entryType +slug: Web/API/PerformanceEntry/entryType +tags: + - API + - Performance Timeline API + - PerformanceEntry + - Property + - Propriété + - Reference + - Performance Web +translation_of: Web/API/PerformanceEntry/entryType +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">La propriété <strong><code>entryType</code></strong> renvoie un <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> représentant le type de mesure de performance tel que, par exemple, « <code>mark</code> ». Cette propriété est en lecture seule.</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush:js">var <var>type</var> = <var>entry</var>.entryType;</pre> + +<h3 id="Return_Value">Valeur de retour</h3> + +<p>La valeur de retour dépend du sous-type de l'objet <code>PerformanceEntry</code> et affecte la valeur de la propriété <a href="/fr/docs/Web/API/PerformanceEntry/name"><code>PerformanceEntry.name</code></a> comme le montre le tableau ci-dessous.</p> + +<h3 id="Performance_entry_type_names">Noms des types d'entrée de performance</h3> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Valeur</th> + <th scope="col">Sous-type</th> + <th scope="col">Type de propriété pour le nom</th> + <th scope="col">Description de la valeur du nom.</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>element</code></td> + <td><a href="/fr/docs/Web/API/PerformanceElementTiming"><code>PerformanceElementTiming</code></a></td> + <td><a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a></td> + <td>Rapporte le temps de chargement des éléments.</td> + </tr> + <tr> + <td><code>frame</code>, <code>navigation</code></td> + <td><a href="/fr/docs/Web/API/PerformanceFrameTiming"><code>PerformanceFrameTiming</code></a>, + <a href="/fr/docs/Web/API/PerformanceNavigationTiming"><code>PerformanceNavigationTiming</code></a></td> + <td><a href="/fr/docs/Web/API/URL"><code>URL</code></a></td> + <td>L'adresse du document.</td> + </tr> + <tr> + <td><code>resource</code></td> + <td><a href="/fr/docs/Web/API/PerformanceResourceTiming"><code>PerformanceResourceTiming</code></a></td> + <td><a href="/fr/docs/Web/API/URL"><code>URL</code></a></td> + <td>L'URL résolue de la ressource demandée. Cette valeur ne change pas même si la demande est redirigée.</td> + </tr> + <tr> + <td><code>mark</code></td> + <td><a href="/fr/docs/Web/API/PerformanceMark"><code>PerformanceMark</code></a></td> + <td><a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a></td> + <td>Le nom utilisé lorsque la marque a été créée en appelant <a href="/fr/docs/Web/API/Performance/mark"><code>mark()</code></a>.</td> + </tr> + <tr> + <td><code>measure</code></td> + <td><a href="/fr/docs/Web/API/PerformanceMeasure"><code>PerformanceMeasure</code></a></td> + <td><a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a></td> + <td>Le nom utilisé lorsque la mesure a été créée en appelant <a href="/fr/docs/Web/API/Performance/measure"><code>measure()</code></a>.</td> + </tr> + <tr> + <td><code>paint</code></td> + <td><a href="/fr/docs/Web/API/PerformancePaintTiming"><code>PerformancePaintTiming</code></a></td> + <td><a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a></td> + <td>Soit <code>'first-paint'</code> ou <code>'first-contentful-paint'</code>.</td> + </tr> + <tr> + <td><code>longtask</code></td> + <td><a href="/fr/docs/Web/API/PerformanceLongTaskTiming"><code>PerformanceLongTaskTiming</code></a></td> + <td><a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a></td> + <td>Signale les cas de tâches longues.</td> + </tr> + </tbody> +</table> + +<h2 id="Example">Exemple</h2> + +<p>L'exemple suivant montre l'utilisation de la propriété <code>entryType</code>.</p> + +<pre class="brush: js">function run_PerformanceEntry() { + + // Vérifie le support des fonctionnalités avant de continuer + if (performance.mark === undefined) { + console.log("performance.mark n'est pas pris en charge"); + return; + } + + // Crée une entrée de performance nommée "begin" via la méthode mark() + performance.mark("begin"); + + // Vérifie le type d'entrée de toutes les entrées "begin". + let entriesNamedBegin = performance.getEntriesByName("begin"); + for (let i=0; i < entriesNamedBegin.length; i++) { + let typeOfEntry = entriesNamedBegin[i].entryType; + console.log("L'entrée est de type : " + typeOfEntry); + } +} +</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-performanceentry-entrytype', + 'entryType')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline', '#dom-performanceentry-entrytype', + 'entryType')}}</td> + <td>{{Spec2('Performance Timeline')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceEntry.entryType")}}</p> diff --git a/files/fr/web/api/performanceentry/index.html b/files/fr/web/api/performanceentry/index.html new file mode 100644 index 0000000000..1e7ef376ea --- /dev/null +++ b/files/fr/web/api/performanceentry/index.html @@ -0,0 +1,147 @@ +--- +title: PerformanceEntry +slug: Web/API/PerformanceEntry +tags: + - API + - Interface + - Performance Timeline API + - PerformanceEntry + - Reference + - Performance Web +translation_of: Web/API/PerformanceEntry +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">L'objet <strong><code>PerformanceEntry</code></strong> encapsule une seule mesure de performance qui fait partie de la <em>chronologie de performance</em>. Une <em>entrée de performance</em> peut être créée directement en faisant <em><a href="/fr/docs/Web/API/PerformanceMark">une marque</a></em> ou <em><a href="/fr/docs/Web/API/PerformanceMeasure">une mesure</a></em> (par exemple en appelant la méthode <a href="/fr/docs/Web/API/Performance/mark"><code>mark()</code></a>) à un point explicite d'une application. Les entrées de performance sont également créées de manière indirecte, par exemple en chargeant une ressource (telle qu'une image).</p> + +<p>Les instances <code>PerformanceEntry</code> auront toujours l'un des sous-types suivants :</p> + +<ul> + <li><a href="/fr/docs/Web/API/PerformanceMark"><code>PerformanceMark</code></a></li> + <li><a href="/fr/docs/Web/API/PerformanceMeasure"><code>PerformanceMeasure</code></a></li> + <li><a href="/fr/docs/Web/API/PerformanceFrameTiming"><code>PerformanceFrameTiming</code></a></li> + <li><a href="/fr/docs/Web/API/PerformanceNavigationTiming"><code>PerformanceNavigationTiming</code></a></li> + <li><a href="/fr/docs/Web/API/PerformanceResourceTiming"><code>PerformanceResourceTiming</code></a></li> + <li><a href="/fr/docs/Web/API/PerformancePaintTiming"><code>PerformancePaintTiming</code></a></li> +</ul> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Properties">Propriétés</h2> + +<dl> + <dt><a href="/fr/docs/Web/API/PerformanceEntry/name"><code>PerformanceEntry.name</code></a> {{readonlyInline}}</dt> + <dd>Une valeur qui précise davantage la valeur renvoyée par la propriété <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>PerformanceEntry.entryType</code></a>. La valeur des deux dépend du sous-type. Voir la page de la propriété pour les valeurs valides.</dd> + <dt><a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>PerformanceEntry.entryType</code></a> {{readonlyInline}}</dt> + <dd>Une chaîne de caractère <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> représentant le type de mesure de performance comme, par exemple, "<code>mark</code>". Voir la page des propriétés pour les valeurs valides.</dd> + <dt><a href="/fr/docs/Web/API/PerformanceEntry/startTime"><code>PerformanceEntry.startTime</code></a> {{readonlyInline}}</dt> + <dd>Un objet <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>DOMHighResTimeStamp</code></a> représentant l'heure de départ de la mesure de performance.</dd> + <dt><a href="/fr/docs/Web/API/PerformanceEntry/duration"><code>PerformanceEntry.duration</code></a> {{readonlyInline}}</dt> + <dd>Un objet <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>DOMHighResTimeStamp</code></a> représentant la valeur temporelle de la durée de l'événement de performance.</dd> +</dl> + +<h2 id="Methods">Méthodes</h2> + +<dl> + <dt><a href="/fr/docs/Web/API/PerformanceEntry/toJSON"><code>PerformanceEntry.toJSON()</code></a></dt> + <dd>Renvoie une représentation JSON de l'objet <code>PerformanceEntry</code>.</dd> +</dl> + +<h2 id="Example">Exemple</h2> + +<p>L'exemple suivant vérifie toutes les propriétés <code>PerformanceEntry</code> pour voir si le navigateur les prend en charge et, le cas échéant, écrit leurs valeurs dans la console.</p> + +<pre class="brush:js">function print_PerformanceEntries() { + // Utilise getEntries() pour obtenir une liste de toutes les entrées de performance. + let p = performance.getEntries(); + for (let i = 0; i < p.length; i++) { + console.log("PerformanceEntry[" + i + "]"); + print_PerformanceEntry(p[i]); + } +} +function print_PerformanceEntry(perfEntry) { + let properties = ["name", + "entryType", + "startTime", + "duration"]; + + for (let i = 0; i < properties.length; i++) { + // Vérifie chaque propriété + let supported = properties[i] in perfEntry; + if (supported) { + let value = perfEntry[properties[i]]; + console.log("... " + properties[i] + " = " + value); + } else { + console.log("... " + properties[i] + " n'est PAS pris en charge"); + } + } +} +</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('Resource Timing 3')}}</td> + <td>{{Spec2('Resource Timing 3')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('Resource Timing 2')}}</td> + <td>{{Spec2('Resource Timing 2')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('Resource Timing')}}</td> + <td>{{Spec2('Resource Timing')}}</td> + <td>Ajoute l'interface <a href="/fr/docs/Web/API/PerformanceResourceTiming"><code>PerformanceResourceTiming</code></a> et la valeur <code>resource</code> pour <code>entryType</code>.</td> + </tr> + <tr> + <td>{{SpecName('Navigation Timing Level 2')}}</td> + <td>{{Spec2('Navigation Timing Level 2')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('Navigation Timing')}}</td> + <td>{{Spec2('Navigation Timing')}}</td> + <td>Ajoute l'interface <a href="/fr/docs/Web/API/PerformanceNavigationTiming"><code>PerformanceNavigationTiming</code></a> et la valeur <code>navigation</code> pour <code>entryType</code>.</td> + </tr> + <tr> + <td>{{SpecName('User Timing Level 2')}}</td> + <td>{{Spec2('User Timing Level 2')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('User Timing')}}</td> + <td>{{Spec2('User Timing')}}</td> + <td>Ajoute les interfaces <a href="/fr/docs/Web/API/PerformanceMark"><code>PerformanceMark</code></a> et <a href="/fr/docs/Web/API/PerformanceMeasure"><code>PerformanceMeasure</code></a> ainsi que les valeurs <code>mark</code> et <code>measure</code> pour <code>entryType</code>.</td> + </tr> + <tr> + <td>{{SpecName('Frame Timing')}}</td> + <td>{{Spec2('Frame Timing')}}</td> + <td>Ajoute l'interface <a href="/fr/docs/Web/API/PerformanceFrameTiming"><code>PerformanceFrameTiming</code></a> et la valeur <code>frame</code> pour <code>entryType</code>.</td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline Level 2', '#dom-performanceentry', 'PerformanceEntry')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td>Ajout de la méthode de sérialisation <code>toJSON()</code>.</td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline', '#dom-performanceentry', 'PerformanceEntry')}}</td> + <td>{{Spec2('Performance Timeline')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceEntry")}}</p> diff --git a/files/fr/web/api/performanceentry/name/index.html b/files/fr/web/api/performanceentry/name/index.html new file mode 100644 index 0000000000..1683f51f51 --- /dev/null +++ b/files/fr/web/api/performanceentry/name/index.html @@ -0,0 +1,150 @@ +--- +title: PerformanceEntry.name +slug: Web/API/PerformanceEntry/name +tags: + - API + - Performance Timeline API + - PerformanceEntry + - Property + - Propriété + - Reference + - Performance Web +translation_of: Web/API/PerformanceEntry/name +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">La propriété <strong><code>name</code></strong> de l'interface <a href="/fr/docs/Web/API/PerformanceEntry"><code>PerformanceEntry</code></a> renvoie une valeur qui précise davantage la valeur renvoyée par la propriété <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>PerformanceEntry.entryType</code></a>. Cette propriété est en lecture seule.</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush: js">var <var>name</var> = <var>entry</var>.name; +</pre> + +<h3 id="Return_Value">Valeur de retour</h3> + +<p>La valeur de retour dépend du sous-type de l'objet <code>PerformanceEntry</code> et de la valeur de <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>PerformanceEntry.entryType</code></a>, comme le montre le tableau ci-dessous.</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Type de valeur pour <code>name</code></th> + <th scope="col">Sous-type</th> + <th scope="col">Type (<code>entryType</code>)</th> + <th scope="col">Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/fr/docs/Web/API/URL"><code>URL</code></a></td> + <td><a href="/fr/docs/Web/API/PerformanceFrameTiming"><code>PerformanceFrameTiming</code></a>, + <a href="/fr/docs/Web/API/PerformanceNavigationTiming"><code>PerformanceNavigationTiming</code></a></td> + <td><code>frame</code>, <code>navigation</code></td> + <td>L'adresse du document.</td> + </tr> + <tr> + <td><a href="/fr/docs/Web/API/URL"><code>URL</code></a></td> + <td><a href="/fr/docs/Web/API/PerformanceResourceTiming"><code>PerformanceResourceTiming</code></a></td> + <td><code>resource</code></td> + <td>L'URL résolue de la ressource demandée. Cette valeur ne change pas même si la demande est redirigée.</td> + </tr> + <tr> + <td><a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a></td> + <td><a href="/fr/docs/Web/API/PerformanceMark"><code>PerformanceMark</code></a></td> + <td><code>mark</code></td> + <td>Le nom utilisé lorsque le marqueur a été créé en appelant <a href="/fr/docs/Web/API/Performance/mark"><code>mark()</code></a>.</td> + </tr> + <tr> + <td><a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a></td> + <td><a href="/fr/docs/Web/API/PerformanceMeasure"><code>PerformanceMeasure</code></a></td> + <td><code>measure</code></td> + <td>Le nom utilisé lorsque la mesure a été créée en appelant <a href="/fr/docs/Web/API/Performance/measure"><code>measure()</code></a>.</td> + </tr> + <tr> + <td><a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a></td> + <td><a href="/fr/docs/Web/API/PerformancePaintTiming"><code>PerformancePaintTiming</code></a></td> + <td><code>paint</code></td> + <td>Soit <code>'first-paint'</code> ou <code>'first-contentful-paint'</code>.</td> + </tr> + </tbody> +</table> + +<h2 id="Example">Exemple</h2> + +<p>L'exemple suivant montre l'utilisation de la propriété <code>name</code>.</p> + +<pre class="brush: js">function run_PerformanceEntry() { + console.log("Support de PerformanceEntry ..."); + + if (performance.mark === undefined) { + console.log("... performance.mark n'est pas pris en charge"); + return; + } + + // Crée quelques entrées de performance via la méthode mark() + performance.mark("Begin"); + do_work(50000); + performance.mark("End"); + + // Utilise getEntries() pour itérer à travers chaque entrée. + let p = performance.getEntries(); + for (let i = 0; i < p.length; i++) { + console.log("Entry[" + i + "]"); + check_PerformanceEntry(p[i]); + } +} +function check_PerformanceEntry(obj) { + let properties = ["name", "entryType", "startTime", "duration"]; + let methods = ["toJSON"]; + + for (let i = 0; i < properties.length; i++) { + // Vérifie chaque propriété + let supported = properties[i] in obj; + if (supported) + console.log("..." + properties[i] + " = " + obj[properties[i]]); + else + console.log("..." + properties[i] + " = Not supported"); + } + for (let i = 0; i < methods.length; i++) { + // Vérifie chaque méthode + let supported = typeof obj[methods[i]] == "function"; + if (supported) { + let js = obj[methods[i]](); + console.log("..." + methods[i] + "() = " + JSON.stringify(js)); + } else { + console.log("..." + methods[i] + " = Not supported"); + } + } +} +</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-performanceentry-name', + 'name')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline', '#dom-performanceentry-name', + 'name')}}</td> + <td>{{Spec2('Performance Timeline')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceEntry.name")}}</p> diff --git a/files/fr/web/api/performanceentry/starttime/index.html b/files/fr/web/api/performanceentry/starttime/index.html new file mode 100644 index 0000000000..864d4ac068 --- /dev/null +++ b/files/fr/web/api/performanceentry/starttime/index.html @@ -0,0 +1,122 @@ +--- +title: PerformanceEntry.startTime +slug: Web/API/PerformanceEntry/startTime +tags: + - API + - Performance Timeline API + - PerformanceEntry + - Property + - Propriété + - Reference + - Performance Web +translation_of: Web/API/PerformanceEntry/startTime +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">La propriété <strong><code>startTime</code></strong> renvoie le premier <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> enregistré pour l'<a href="/fr/docs/Web/API/PerformanceEntry">entrée de performance</a>.</p> + +<p>{{AvailableInWorkers}}</p> + +<p>La valeur renvoyée par cette propriété dépend du <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>type</code></a> de l'entrée de performance :</p> + +<ul> + <li>« <code>frame</code> » - retourne le + <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> quand l'affichage a été démarré.</li> + <li>« <code>mark</code> » - retourne le <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> lorsque le marquage a été créé par un appel de <a href="/fr/docs/Web/API/Performance/mark"><code>performance.mark()</code></a>.</li> + <li>« <code>measure</code> » - retourne le <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> lorsque la mesure a été créée par un appel à <a href="/fr/docs/Web/API/Performance/measure"><code>performance.measure()</code></a>.</li> + <li>« <code>navigation</code> » - retourne le <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> avec une valeur de "<code>0</code>".</li> + <li>« <code>resource</code> » - retourne le <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>timestamp</code></a> immédiatement avant que le navigateur ne <a href="/fr/docs/Web/API/PerformanceResourceTiming/fetchStart">commence à récupérer la ressource</a>.</li> +</ul> + +<p>Cette propriété est en lecture seule.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush:js">entry.startTime;</pre> + +<h3 id="Return_Value">Valeur de retour</h3> + +<p>Un objet <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>DOMHighResTimeStamp</code></a> représentant le premier horodatage lorsque l'<a href="/fr/docs/Web/API/PerformanceEntry">entrée de performance</a> a été créée.</p> + +<div class="notecard note"> + <p><strong>Note :</strong> Si l'entrée de performance a un <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>entryType</code></a> "<code>resource</code>" (c'est-à-dire que l'entrée est un objet <a href="/fr/docs/Web/API/PerformanceResourceTiming"><code>PerformanceResourceTiming</code></a>), cette propriété renvoie la valeur de l'horodatage fournie par <a href="/fr/docs/Web/API/PerformanceResourceTiming/fetchStart"><code>PerformanceResourceTiming.fetchStart</code></a>.</p> +</div> + +<h2 id="Example">Exemple</h2> + +<p>L'exemple suivant montre l'utilisation de la propriété <code>startTime</code>.</p> + +<pre class="brush:js">function run_PerformanceEntry() { + console.log("Support de PerformanceEntry ..."); + + if (performance.mark === undefined) { + console.log("... performance.mark n'est pas pris en charge"); + return; + } + + // Crée quelques entrées de performance via la méthode mark() + performance.mark("Begin"); + do_work(50000); + performance.mark("End"); + + // Utilise getEntries() pour itérer à travers chaque entrée + let p = performance.getEntries(); + for (let i = 0; i < p.length; i++) { + log("Entry[" + i + "]"); + check_PerformanceEntry(p[i]); + } +} +function check_PerformanceEntry(obj) { + let properties = ["name", "entryType", "startTime", "duration"]; + let methods = ["toJSON"]; + + for (let i = 0; i < properties.length; i++) { + // On vérifie chaque propriété + let supported = properties[i] in obj; + if (supported) + log("..." + properties[i] + " = " + obj[properties[i]]); + else + log("..." + properties[i] + " = N'est pas pris en charge"); + } + for (let i = 0; i < methods.length; i++) { + // On vérifie chaque méthode + let supported = typeof obj[methods[i]] == "function"; + if (supported) { + let js = obj[methods[i]](); + log("..." + methods[i] + "() = " + JSON.stringify(js)); + } else { + log("..." + methods[i] + " = N'est pas pris en charge"); + } + } +} +</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-performanceentry-starttime', + 'startTime')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline', '#dom-performanceentry-starttime', + 'startTime')}}</td> + <td>{{Spec2('Performance Timeline')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceEntry.startTime")}}</p> diff --git a/files/fr/web/api/performanceentry/tojson/index.html b/files/fr/web/api/performanceentry/tojson/index.html new file mode 100644 index 0000000000..13a8c3bb5e --- /dev/null +++ b/files/fr/web/api/performanceentry/tojson/index.html @@ -0,0 +1,107 @@ +--- +title: PerformanceEntry.toJSON() +slug: Web/API/PerformanceEntry/toJSON +tags: + - API + - Method + - Méthode + - Performance Timeline API + - PerformanceEntry + - Reference + - Performance Web +translation_of: Web/API/PerformanceEntry/toJSON +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">La méthode <strong><code>toJSON()</code></strong> permet de sérialiser l'objet <a href="/fr/docs/Web/API/PerformanceEntry"><code>PerformanceEntry</code></a> courant et renvoie une représentation JSON de l'objet.</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush:js">let jsonObj = perfEntry.toJSON(); +</pre> + +<h3 id="Arguments">Arguments</h3> + +<p>Aucun.</p> + +<h3 id="Return_value">Valeur de retour</h3> + +<dl> + <dt><code>json</code></dt> + <dd>Un objet JSON qui est la sérialisation de l'objet <a href="/fr/docs/Web/API/PerformanceEntry"><code>PerformanceEntry</code></a>.</dd> +</dl> + +<h2 id="Example">Exemple</h2> + +<p>L'exemple suivant montre l'utilisation de la méthode <code>toJSON()</code>.</p> + +<pre class="brush:js">function run_PerformanceEntry() { + console.log("Support de PerformanceEntry ..."); + + if (performance.mark === undefined) { + console.log("... performance.mark n'est pas pris en charge"); + return; + } + + // Crée quelques entrées de performance via la méthode mark() + performance.mark("Begin"); + do_work(50000); + performance.mark("End"); + + // Utilise getEntries() pour itérer à travers chaque entrée. + let p = performance.getEntries(); + for (let i = 0; i < p.length; i++) { + console.log("Entry[" + i + "]"); + check_PerformanceEntry(p[i]); + } +} +function check_PerformanceEntry(obj) { + let properties = ["name", "entryType", "startTime", "duration"]; + let methods = ["toJSON"]; + + for (let i = 0; i < properties.length; i++) { + // On vérifie chaque propriété + let supported = properties[i] in obj; + if (supported) + console.log("..." + properties[i] + " = " + obj[properties[i]]); + else + console.log("..." + properties[i] + " = N'est pas pris en charge"); + } + for (let i = 0; i < methods.length; i++) { + // On vérifie chaque méthode + let supported = typeof obj[methods[i]] == "function"; + if (supported) { + let js = obj[methods[i]](); + console.log("..." + methods[i] + "() = " + JSON.stringify(js)); + } else { + console.log("..." + methods[i] + " = N'est pas pris en charge"); + } + } +} +</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-performanceentry-tojson', + 'toJSON')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td>Définition initiale de la méthode <code>toJSON()</code>.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceEntry.toJSON")}}</p> |