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/performanceobserver | |
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/performanceobserver')
5 files changed, 359 insertions, 0 deletions
diff --git a/files/fr/web/api/performanceobserver/disconnect/index.html b/files/fr/web/api/performanceobserver/disconnect/index.html new file mode 100644 index 0000000000..d4e509708b --- /dev/null +++ b/files/fr/web/api/performanceobserver/disconnect/index.html @@ -0,0 +1,66 @@ +--- +title: PeformanceObserver.disconnect() +slug: Web/API/PerformanceObserver/disconnect +tags: + - API + - Method + - Méthode + - Performance Observer API + - PerformanceObserver + - Reference + - Performance Web + - disconnect() + - observers +translation_of: Web/API/PerformanceObserver/disconnect +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p>La méthode <strong><code>disconnect()</code></strong> de l'interface <a href="/fr/docs/Web/API/PerformanceObserver"><code>PerformanceObserver</code></a> est utilisée pour empêcher l'observateur de performances de recevoir tout événement <a href="/fr/docs/Web/API/PerformanceEntry">d'entrée de performance</a>.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush: js"><var>performanceObserver</var>.disconnect();</pre> + +<h2 id="Example">Exemple</h2> + +<pre class="brush: js">const observer = new PerformanceObserver(function(list, obj) { + let entries = list.getEntries(); + for (let i=0; i < entries.length; i++) { + // Traiter les événements "mark" et "frame" + } +}); +observer.observe({entryTypes: ["mark", "frame"]}); + +function perf_observer(list, observer) { + // Traiter l'événement "measure". + // ... + // Désactiver les événements de performance supplémentaires + observer.disconnect(); +} +const observer2 = new PerformanceObserver(perf_observer); +observer2.observe({entryTypes: ["measure"]}); +</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-performanceobserver-disconnect', 'disconnect()')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td>Définition initiale de la méthode <code>disconnect()</code>.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceObserver.disconnect")}}</p> diff --git a/files/fr/web/api/performanceobserver/index.html b/files/fr/web/api/performanceobserver/index.html new file mode 100644 index 0000000000..2b52bba127 --- /dev/null +++ b/files/fr/web/api/performanceobserver/index.html @@ -0,0 +1,75 @@ +--- +title: PerformanceObserver +slug: Web/API/PerformanceObserver +tags: + - API + - Interface + - Performance Observer API + - PerformanceObserver + - Reference + - Performance Web + - observers +translation_of: Web/API/PerformanceObserver +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">L'interface <strong><code>PerformanceObserver</code></strong> est utilisée pour <em>observer</em> les événements de mesure des performances et être notifié des nouvelles <a href="/fr/docs/Web/API/PerformanceEntry">entréés de performance</a> lorsqu'elles sont enregistrées dans la <em>chronologie des performances</em> du navigateur.</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Constructor">Constructeur</h2> + +<dl> + <dt><a href="/fr/docs/Web/API/PerformanceObserver/PerformanceObserver"><code>PerformanceObserver()</code></a></dt> + <dd>Crée et retourne un nouvel objet <code>PerformanceObserver</code>.</dd> +</dl> + +<h2 id="Methods">Méthodes</h2> + +<dl> + <dt><a href="/fr/docs/Web/API/PerformanceObserver/observe"><code>PerformanceObserver.observe()</code></a></dt> + <dd>Spécifie l'ensemble des <a href="/fr/docs/Web/API/PerformanceEntry/entryType">types d'entrées</a> à observer. La fonction de rappel de l'observateur de performances sera invoquée lorsqu'une <a href="/fr/docs/Web/API/PerformanceEntry">entrée de performance</a> est enregistrée pour l'un des <code>entryTypes</code> spécifiés.</dd> + <dt><a href="/fr/docs/Web/API/PerformanceObserver/disconnect"><code>PerformanceObserver.disconnect()</code></a></dt> + <dd>Arrête l'observation des <a href="/fr/docs/Web/API/PerformanceEntry">entrées de performances</a>.</dd> + <dt><a href="/fr/docs/Web/API/PerformanceObserver/takeRecords"><code>PerformanceObserver.takeRecords()</code></a> {{Experimental_Inline}}</dt> + <dd>Renvoie la liste actuelle des <a href="/fr/docs/Web/API/PerformanceEntry">entrées de performances</a> stockées dans l'observateur de performance, en la vidant.</dd> +</dl> + +<h2 id="Example">Exemple</h2> + +<pre class="brush:js">function perf_observer(list, observer) { + // Traiter l'événement "measure". +} +const observer2 = new PerformanceObserver(perf_observer); +observer2.observe({entryTypes: ["measure"]});</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-performanceobserver', 'PerformanceObserver')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td>Définition initiale de l'interface <code>PerformanceObserver</code>.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceObserver")}}</p> + +<h2 id="See_also">Voir aussi</h2> + +<ul> + <li><a href="/fr/docs/Web/API/MutationObserver"><code>MutationObserver</code></a></li> + <li><a href="/fr/docs/Web/API/ResizeObserver"><code>ResizeObserver</code></a></li> + <li><a href="/fr/docs/Web/API/IntersectionObserver"><code>IntersectionObserver</code></a></li> +</ul> diff --git a/files/fr/web/api/performanceobserver/observe/index.html b/files/fr/web/api/performanceobserver/observe/index.html new file mode 100644 index 0000000000..60366f066a --- /dev/null +++ b/files/fr/web/api/performanceobserver/observe/index.html @@ -0,0 +1,79 @@ +--- +title: PerformanceObserver.observe() +slug: Web/API/PerformanceObserver/observe +tags: + - API + - Method + - Méthode + - Performance + - PerformanceObserver + - Reference + - Performance Web +translation_of: Web/API/PerformanceObserver/observe +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">La méthode <strong><code>observe()</code></strong> de l'interface <strong><a href="/fr/docs/Web/API/PerformanceObserver"><code>PerformanceObserver</code></a></strong> est utilisée pour spécifier l'ensemble des types d'entrée de performance à observer. Les types d'entrée de performance sont spécifiés sous la forme d'un tableau d'objets <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a>, chacun nommant un type d'entrée ; les noms de type sont documentés sur la page <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>PerformanceEntry.entryType</code></a>.</p> + +<p>Lorsqu'une entrée de performance correspondante est enregistrée, la fonction de rappel de l'observateur de performance — définie lors de la création du <a href="/fr/docs/Web/API/PerformanceObserver"><code>PerformanceObserver</code></a> — est invoquée.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush:js"><var>observer</var>.observe(<var>options</var>);</pre> + +<h3 id="Parameters">Paramètres</h3> + +<dl> + <dt><code>options</code></dt> + <dd>Un dictionnaire <code>PerformanceObserverInit</code> avec les membres possibles suivants : + <ul> + <li><code>entryTypes</code> : Un tableau d'objets <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a>, chacun spécifiant un type d'entrée de performance à observer. Ne peut pas être utilisé avec les options « <code>type</code> » ou « <code>buffered</code> ».</li> + <li><code>type</code> : Une <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> unique spécifiant exactement un type d'entrée de performance à observer. Ne peut pas être utilisé avec l'option <code>entryTypes</code>.</li> + <li><code>buffered</code> : Un indicateur booléen pour indiquer si les entrées en mémoire tampon doivent être mises en file d'attente dans la mémoire tampon de l'observateur. Ne doit être utilisé qu'avec l'option « <code>type</code> ».</li> + </ul> + <p class="notecard note">Voir <a href="/fr/docs/Web/API/PerformanceEntry/entryType"><code>PerformanceEntry.entryType</code></a> pour une liste des noms de types d'entrées de performance valides. Les types non reconnus sont ignorés, bien que le navigateur puisse afficher un message d'avertissement sur la console pour aider les développeurs à déboguer leur code. Si aucun type valide n'est trouvé, <code>observe()</code> n'a aucun effet.</p> + </dd> +</dl> + +<h2 id="Example">Exemple</h2> + +<p>Cet exemple crée et configure deux <code>PerformanceObservers</code> ; l'un surveille les événements <code>"mark"</code> et <code>"frame"</code>, et l'autre surveille les événements <code>"measure"</code>.</p> + +<pre class="brush: js">const observer = new PerformanceObserver(function(list, obj) { + let entries = list.getEntries(); + for (let i = 0; i < entries.length; i++) { + // Traiter les événements "mark" et "famse" + } +}); +observer.observe({entryTypes: ["mark", "frame"]}); + +function perf_observer(list, observer) { + // Traiter l'événement "measure" +} +const observer2 = new PerformanceObserver(perf_observer); +observer2.observe({entryTypes: ["measure"]}); +</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-performanceobserver-observe', + 'observe()')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td>Définition initiale de la méthode <code>observe()</code>.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceObserver.observe")}}</p> diff --git a/files/fr/web/api/performanceobserver/performanceobserver/index.html b/files/fr/web/api/performanceobserver/performanceobserver/index.html new file mode 100644 index 0000000000..f0388d0689 --- /dev/null +++ b/files/fr/web/api/performanceobserver/performanceobserver/index.html @@ -0,0 +1,71 @@ +--- +title: PerformanceObserver() +slug: Web/API/PerformanceObserver/PerformanceObserver +tags: + - API + - Constructor + - Constructeur + - PerformanceObserver + - Reference + - Performance Web +translation_of: Web/API/PerformanceObserver/PerformanceObserver +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p class="summary">Le constructeur <strong><code>PerformanceObserver()</code></strong> crée un nouvel objet <a href="/fr/docs/Web/API/PerformanceObserver"><code>PerformanceObserver</code></a> avec le <code>callback</code> d'observation donné. La fonction de rappel de l'observateur est invoquée lorsque des <a href="/fr/docs/Web/API/PerformanceEntry">événements d'entrée de performance</a> sont répertoriés pour les <a href="/fr/docs/Web/API/PerformanceEntry/entryType">types d'entrées</a> qui ont été enregistrés, via la méthode <a href="/fr/docs/Web/API/PerformanceObserver/observe"><code>observe()</code></a>.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush:js">const <var>observer</var> = new PerformanceObserver(<var>callback</var>);</pre> + +<h3 id="Parameters">Paramètres</h3> + +<dl> + <dt><code>callback</code></dt> + <dd>Une fonction de rappel qui sera invoquée lorsque des événements de performance <em>observés</em> sont enregistrés. Lorsque la fonction de rappel est invoquée, son premier paramètre est une <a href="/fr/docs/Web/API/PerformanceObserverEntryList">liste des entrées de l'observateur de performance</a> et le second paramètre est l'objet <a href="/fr/docs/Web/API/PerformanceObserver"><code>PerformanceObserver</code></a> courant.</dd> +</dl> + +<h3 id="Return_value">Valeur de retour</h3> + +<p>Un nouvel objet <a href="/fr/docs/Web/API/PerformanceObserver"><code>PerformanceObserver</code></a> qui appellera le <code>callback</code> spécifiée lorsque des événements de performance observés se produisent.</p> + +<h2 id="Example">Exemple</h2> + +<pre class="brush: js">const observer = new PerformanceObserver(function(list, obj) { + let entries = list.getEntries(); + for (let i = 0; i < entries.length; i++) { + // Traiter les événements "mark" et "frame" + } +}); +observer.observe({entryTypes: ["mark", "frame"]}); + +function perf_observer(list, observer) { + // Traiter l'événement "measure" +} +const observer2 = new PerformanceObserver(perf_observer); +observer2.observe({entryTypes: ["measure"]}); +</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', + '#idl-def-performanceobservercallback', 'PerformanceObserver()')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td>Définition initiale du constructeur <code>PerformanceObserver()</code>.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceObserver.PerformanceObserver")}}</p> diff --git a/files/fr/web/api/performanceobserver/takerecords/index.html b/files/fr/web/api/performanceobserver/takerecords/index.html new file mode 100644 index 0000000000..3d7dba65c9 --- /dev/null +++ b/files/fr/web/api/performanceobserver/takerecords/index.html @@ -0,0 +1,68 @@ +--- +title: PerformanceObserver.takeRecords() +slug: Web/API/PerformanceObserver/takeRecords +tags: +- API +- Method +- Méthode +- Performance Observer API +- PerformanceObserver +- Reference +- observers +- takeRecords() +translation_of: Web/API/PerformanceObserver/disconnect +--- +<div>{{APIRef("Performance Timeline API")}}</div> + +<p>La méthode <strong><code>takeRecords()</code></strong> de l'interface <a href="/fr/docs/Web/API/PerformanceObserver"><code>PerformanceObserver</code> renvoie la liste actuelle des <a href="/fr/docs/Web/API/PerformanceEntry">entrées de performance</a> stockées dans l'observateur de performance, en la vidant.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="brush: js">let <var>performanceEntryList<var> = <var>performanceObserver</var>.takeRecords();</pre> + +<h3 id="Parameters">Paramètres</h3> + +<p>Aucun.</p> + +<h3 id="Return_value">Valeur de retour</h3> + +<p>Une liste d'objets <a href="/fr/docs/Web/API/PerformanceEntry"><code>PerformanceEntry</code></a>.</p> + +<h2 id="Example">Exemple</h2> + +<pre class="brush: js">const observer = new PerformanceObserver(function(list, obj) { + let entries = list.getEntries(); + for (let i= 0; i < entries.length; i++) { + // Traiter les événements "mark" et "frame" + } +}); +observer.observe({entryTypes: ["mark", "frame"]}); +let records = observer.takeRecords(); +console.log(records[0].name); +console.log(records[0].startTime); +console.log(records[0].duration); +</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-performanceobserver-takerecords', 'takeRecords()')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td>Définition initiale de la méthode <code>takeRecords()</code>.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.PerformanceObserver.takeRecords")}}</p> |