From 48a326c0d47c8f49eb50706420a33bfcbe24f2c7 Mon Sep 17 00:00:00 2001 From: tristantheb Date: Sun, 11 Apr 2021 09:03:44 +0200 Subject: 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 --- .../api/performanceobserver/disconnect/index.html | 66 ++++++++++++++++++ files/fr/web/api/performanceobserver/index.html | 75 ++++++++++++++++++++ .../web/api/performanceobserver/observe/index.html | 79 ++++++++++++++++++++++ .../performanceobserver/index.html | 71 +++++++++++++++++++ .../api/performanceobserver/takerecords/index.html | 68 +++++++++++++++++++ 5 files changed, 359 insertions(+) create mode 100644 files/fr/web/api/performanceobserver/disconnect/index.html create mode 100644 files/fr/web/api/performanceobserver/index.html create mode 100644 files/fr/web/api/performanceobserver/observe/index.html create mode 100644 files/fr/web/api/performanceobserver/performanceobserver/index.html create mode 100644 files/fr/web/api/performanceobserver/takerecords/index.html (limited to 'files/fr/web/api/performanceobserver') 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 +--- +
{{APIRef("Performance Timeline API")}}
+ +

La méthode disconnect() de l'interface PerformanceObserver est utilisée pour empêcher l'observateur de performances de recevoir tout événement d'entrée de performance.

+ +

Syntaxe

+ +
performanceObserver.disconnect();
+ +

Exemple

+ +
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"]});
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', + '#dom-performanceobserver-disconnect', 'disconnect()')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale de la méthode disconnect().
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.PerformanceObserver.disconnect")}}

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 +--- +
{{APIRef("Performance Timeline API")}}
+ +

L'interface PerformanceObserver est utilisée pour observer les événements de mesure des performances et être notifié des nouvelles entréés de performance lorsqu'elles sont enregistrées dans la chronologie des performances du navigateur.

+ +

{{AvailableInWorkers}}

+ +

Constructeur

+ +
+
PerformanceObserver()
+
Crée et retourne un nouvel objet PerformanceObserver.
+
+ +

Méthodes

+ +
+
PerformanceObserver.observe()
+
Spécifie l'ensemble des types d'entrées à observer. La fonction de rappel de l'observateur de performances sera invoquée lorsqu'une entrée de performance est enregistrée pour l'un des entryTypes spécifiés.
+
PerformanceObserver.disconnect()
+
Arrête l'observation des entrées de performances.
+
PerformanceObserver.takeRecords() {{Experimental_Inline}}
+
Renvoie la liste actuelle des entrées de performances stockées dans l'observateur de performance, en la vidant.
+
+ +

Exemple

+ +
function perf_observer(list, observer) {
+  // Traiter l'événement "measure".
+}
+const observer2 = new PerformanceObserver(perf_observer);
+observer2.observe({entryTypes: ["measure"]});
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', '#dom-performanceobserver', 'PerformanceObserver')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale de l'interface PerformanceObserver.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.PerformanceObserver")}}

+ +

Voir aussi

+ + 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 +--- +
{{APIRef("Performance Timeline API")}}
+ +

La méthode observe() de l'interface PerformanceObserver 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 DOMString, chacun nommant un type d'entrée ; les noms de type sont documentés sur la page PerformanceEntry.entryType.

+ +

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 PerformanceObserver — est invoquée.

+ +

Syntaxe

+ +
observer.observe(options);
+ +

Paramètres

+ +
+
options
+
Un dictionnaire PerformanceObserverInit avec les membres possibles suivants : +
    +
  • entryTypes : Un tableau d'objets DOMString, chacun spécifiant un type d'entrée de performance à observer. Ne peut pas être utilisé avec les options « type » ou « buffered ».
    • +
  • type : Une DOMString unique spécifiant exactement un type d'entrée de performance à observer. Ne peut pas être utilisé avec l'option entryTypes.
    • +
  • buffered : 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 « type ».
    • +
+

Voir PerformanceEntry.entryType 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é, observe() n'a aucun effet.

+
+
+ +

Exemple

+ +

Cet exemple crée et configure deux PerformanceObservers ; l'un surveille les événements "mark" et "frame", et l'autre surveille les événements "measure".

+ +
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"]});
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', '#dom-performanceobserver-observe', + 'observe()')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale de la méthode observe().
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.PerformanceObserver.observe")}}

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 +--- +
{{APIRef("Performance Timeline API")}}
+ +

Le constructeur PerformanceObserver() crée un nouvel objet PerformanceObserver avec le callback d'observation donné. La fonction de rappel de l'observateur est invoquée lorsque des événements d'entrée de performance sont répertoriés pour les types d'entrées qui ont été enregistrés, via la méthode observe().

+ +

Syntaxe

+ +
const observer = new PerformanceObserver(callback);
+ +

Paramètres

+ +
+
callback
+
Une fonction de rappel qui sera invoquée lorsque des événements de performance observés sont enregistrés. Lorsque la fonction de rappel est invoquée, son premier paramètre est une liste des entrées de l'observateur de performance et le second paramètre est l'objet PerformanceObserver courant.
+
+ +

Valeur de retour

+ +

Un nouvel objet PerformanceObserver qui appellera le callback spécifiée lorsque des événements de performance observés se produisent.

+ +

Exemple

+ +
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"]});
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', + '#idl-def-performanceobservercallback', 'PerformanceObserver()')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale du constructeur PerformanceObserver().
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.PerformanceObserver.PerformanceObserver")}}

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 +--- +
{{APIRef("Performance Timeline API")}}
+ +

La méthode takeRecords() de l'interface PerformanceObserver renvoie la liste actuelle des entrées de performance stockées dans l'observateur de performance, en la vidant.

+ +

Syntaxe

+ +
let performanceEntryList = performanceObserver.takeRecords();
+ +

Paramètres

+ +

Aucun.

+ +

Valeur de retour

+ +

Une liste d'objets PerformanceEntry.

+ +

Exemple

+ +
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);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', + '#dom-performanceobserver-takerecords', 'takeRecords()')}}{{Spec2('Performance Timeline Level 2')}}Définition initiale de la méthode takeRecords().
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.PerformanceObserver.takeRecords")}}

-- cgit v1.2.3-54-g00ecf