From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- .../fr/web/api/performanceentry/duration/index.md | 108 ++++++-------- .../fr/web/api/performanceentry/entrytype/index.md | 158 +++++++-------------- files/fr/web/api/performanceentry/index.md | 150 +++++++------------ files/fr/web/api/performanceentry/name/index.md | 145 ++++++------------- .../fr/web/api/performanceentry/starttime/index.md | 96 +++++-------- files/fr/web/api/performanceentry/tojson/index.md | 75 ++++------ 6 files changed, 259 insertions(+), 473 deletions(-) (limited to 'files/fr/web/api/performanceentry') diff --git a/files/fr/web/api/performanceentry/duration/index.md b/files/fr/web/api/performanceentry/duration/index.md index 8fa0aa4edf..8a306ebe80 100644 --- a/files/fr/web/api/performanceentry/duration/index.md +++ b/files/fr/web/api/performanceentry/duration/index.md @@ -10,41 +10,40 @@ tags: - Performance Web translation_of: Web/API/PerformanceEntry/duration --- -
{{APIRef("Performance Timeline API")}}
+{{APIRef("Performance Timeline API")}} -

La propriété duration renvoie un timestamp qui correspond à la durée de l'entrée de performance.

+La propriété **`duration`** renvoie un [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) qui correspond à la durée de l'[entrée de performance](/fr/docs/Web/API/PerformanceEntry). -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

La valeur retournée par cette propriété dépend du type de l'entrée de performance :

+La valeur retournée par cette propriété dépend du [type](/fr/docs/Web/API/PerformanceEntry/entryType) de l'entrée de performance : - +- « `frame` » - retourne un [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) indiquant la différence entre le `startTime` de deux _frames_ successives. +- « `mark` » - retourne "`0`" (une marque n'a pas de durée). +- « `measure` » - retourne le [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) qui correspond à la durée de la mesure. +- « `navigation` » - retourne le [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) qui est respectivement la différence entre les propriétés [`PerformanceNavigationTiming.loadEventEnd`](/fr/docs/Web/API/PerformanceNavigationTiming/loadEventEnd) et [`PerformanceEntry.startTime`](/fr/docs/Web/API/PerformanceEntry/startTime). +- « `resource` » - renvoie la différence entre les deux [`timestamps`](/fr/docs/Web/API/DOMHighResTimeStamp) [`responseEnd`](/fr/docs/Web/API/PerformanceResourceTiming/responseEnd) (le moment de la fin de la réponse) de la ressource et [`startTime`](/fr/docs/Web/API/PerformanceEntry/startTime) (le point de départ). -

Cette propriété est en {{readonlyInline}}.

+Cette propriété est en {{readonlyInline}}. -

Syntaxe

+## Syntaxe -
entry.duration;
+```js +entry.duration; +``` -

Valeur de retour

+### Valeur de retour -

Un objet DOMHighResTimeStamp représentant la durée de l'entrée de performance. 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.

+Un objet [`DOMHighResTimeStamp`](/fr/docs/Web/API/DOMHighResTimeStamp) représentant la durée de l'[entrée de performance](/fr/docs/Web/API/PerformanceEntry). 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. -
-

Note : si l'entrée de performance a un entryType "resource" (c'est-à-dire que l'entrée est un objet PerformanceResourceTiming), cette propriété renvoie la différence entre les timestamps PerformanceEntry.responseEnd et PerformanceEntry.startTime.

-
+> **Note :** si l'entrée de performance a un [`entryType`](/fr/docs/Web/API/PerformanceEntry/entryType) "`resource`" (c'est-à-dire que l'entrée est un objet [`PerformanceResourceTiming`](/fr/docs/Web/API/PerformanceResourceTiming)), cette propriété renvoie la différence entre les [`timestamps`](/fr/docs/Web/API/DOMHighResTimeStamp) [`PerformanceEntry.responseEnd`](/fr/docs/Web/API/PerformanceResourceTiming/responseEnd) et [`PerformanceEntry.startTime`](/fr/docs/Web/API/PerformanceEntry/startTime). -

Exemple

+## Exemple -

L'exemple suivant montre l'utilisation de la propriété duration.

+L'exemple suivant montre l'utilisation de la propriété `duration`. -
function run_PerformanceEntry() {
+```js
+function run_PerformanceEntry() {
   console.log("Support de PerformanceEntry ...");
 
   if (performance.mark === undefined) {
@@ -58,63 +57,46 @@ translation_of: Web/API/PerformanceEntry/duration
   performance.mark("End");
 
   // Utilise getEntries() pour itérer à travers chaque entrée.
-  let p = performance.getEntries();
-  for (let i=0; i < p.length; i++) {
+  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"];
+function check_PerformanceEntry(obj) {
+  let properties = ["name", "entryType", "startTime", "duration"];
+  let methods = ["toJSON"];
 
-  for (let i=0; i < properties.length; i++) {
+  for (let i=0; i < properties.length; i++) {
     // check each property
-    let supported = properties[i] in obj;
+    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++) {
+  for (let i=0; i < methods.length; i++) {
     // check each method
-    let supported = typeof obj[methods[i]] == "function";
+    let supported = typeof obj[methods[i]] == "function";
     if (supported) {
-      let js = obj[methods[i]]();
+      let js = obj[methods[i]]();
       console.log("..." + methods[i] + "() = " + JSON.stringify(js));
     } else {
       console.log("..." + methods[i] + " = N'est pas pris en charge");
     }
   }
 }
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-duration', - 'duration')}}{{Spec2('Performance Timeline Level 2')}}
{{SpecName('Performance Timeline', '#dom-performanceentry-duration', - 'duration')}}{{Spec2('Performance Timeline')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceEntry.duration")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performanceentry-duration', + 'duration')}} | {{Spec2('Performance Timeline Level 2')}} | | +| {{SpecName('Performance Timeline', '#dom-performanceentry-duration', + 'duration')}} | {{Spec2('Performance Timeline')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceEntry.duration")}} diff --git a/files/fr/web/api/performanceentry/entrytype/index.md b/files/fr/web/api/performanceentry/entrytype/index.md index 63ed9dc6c7..8b8f812f3d 100644 --- a/files/fr/web/api/performanceentry/entrytype/index.md +++ b/files/fr/web/api/performanceentry/entrytype/index.md @@ -11,83 +11,40 @@ tags: - Performance Web translation_of: Web/API/PerformanceEntry/entryType --- -
{{APIRef("Performance Timeline API")}}
- -

La propriété entryType renvoie un DOMString représentant le type de mesure de performance tel que, par exemple, « mark ». Cette propriété est en lecture seule.

- -

{{AvailableInWorkers}}

- -

Syntaxe

- -
var type = entry.entryType;
- -

Valeur de retour

- -

La valeur de retour dépend du sous-type de l'objet PerformanceEntry et affecte la valeur de la propriété PerformanceEntry.name comme le montre le tableau ci-dessous.

- -

Noms des types d'entrée de performance

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ValeurSous-typeType de propriété pour le nomDescription de la valeur du nom.
elementPerformanceElementTimingDOMStringRapporte le temps de chargement des éléments.
frame, navigationPerformanceFrameTiming, - PerformanceNavigationTimingURLL'adresse du document.
resourcePerformanceResourceTimingURLL'URL résolue de la ressource demandée. Cette valeur ne change pas même si la demande est redirigée.
markPerformanceMarkDOMStringLe nom utilisé lorsque la marque a été créée en appelant mark().
measurePerformanceMeasureDOMStringLe nom utilisé lorsque la mesure a été créée en appelant measure().
paintPerformancePaintTimingDOMStringSoit 'first-paint' ou 'first-contentful-paint'.
longtaskPerformanceLongTaskTimingDOMStringSignale les cas de tâches longues.
- -

Exemple

- -

L'exemple suivant montre l'utilisation de la propriété entryType.

- -
function run_PerformanceEntry() {
+{{APIRef("Performance Timeline API")}}
+
+La propriété **`entryType`** renvoie un [`DOMString`](/fr/docs/Web/API/DOMString) représentant le type de mesure de performance tel que, par exemple, « `mark` ». Cette propriété est en lecture seule.
+
+{{AvailableInWorkers}}
+
+## Syntaxe
+
+```js
+var type = entry.entryType;
+```
+
+### Valeur de retour
+
+La valeur de retour dépend du sous-type de l'objet `PerformanceEntry` et affecte la valeur de la propriété [`PerformanceEntry.name`](/fr/docs/Web/API/PerformanceEntry/name) comme le montre le tableau ci-dessous.
+
+### Noms des types d'entrée de performance
+
+| Valeur                | Sous-type                                                                                                                                          | Type de propriété pour le nom             | Description de la valeur du nom.                                                                              |
+| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `element`             | [`PerformanceElementTiming`](/fr/docs/Web/API/PerformanceElementTiming)                                                                            | [`DOMString`](/fr/docs/Web/API/DOMString) | Rapporte le temps de chargement des éléments.                                                                 |
+| `frame`, `navigation` | [`PerformanceFrameTiming`](/fr/docs/Web/API/PerformanceFrameTiming), [`PerformanceNavigationTiming`](/fr/docs/Web/API/PerformanceNavigationTiming) | [`URL`](/fr/docs/Web/API/URL)             | L'adresse du document.                                                                                        |
+| `resource`            | [`PerformanceResourceTiming`](/fr/docs/Web/API/PerformanceResourceTiming)                                                                          | [`URL`](/fr/docs/Web/API/URL)             | L'URL résolue de la ressource demandée. Cette valeur ne change pas même si la demande est redirigée.          |
+| `mark`                | [`PerformanceMark`](/fr/docs/Web/API/PerformanceMark)                                                                                              | [`DOMString`](/fr/docs/Web/API/DOMString) | Le nom utilisé lorsque la marque a été créée en appelant [`mark()`](/fr/docs/Web/API/Performance/mark).       |
+| `measure`             | [`PerformanceMeasure`](/fr/docs/Web/API/PerformanceMeasure)                                                                                        | [`DOMString`](/fr/docs/Web/API/DOMString) | Le nom utilisé lorsque la mesure a été créée en appelant [`measure()`](/fr/docs/Web/API/Performance/measure). |
+| `paint`               | [`PerformancePaintTiming`](/fr/docs/Web/API/PerformancePaintTiming)                                                                                | [`DOMString`](/fr/docs/Web/API/DOMString) | Soit `'first-paint'` ou `'first-contentful-paint'`.                                                           |
+| `longtask`            | [`PerformanceLongTaskTiming`](/fr/docs/Web/API/PerformanceLongTaskTiming)                                                                          | [`DOMString`](/fr/docs/Web/API/DOMString) | Signale les cas de tâches longues.                                                                            |
+
+## Exemple
+
+L'exemple suivant montre l'utilisation de la propriété `entryType`.
+
+```js
+function run_PerformanceEntry() {
 
   // Vérifie le support des fonctionnalités avant de continuer
   if (performance.mark === undefined) {
@@ -100,39 +57,22 @@ translation_of: Web/API/PerformanceEntry/entryType
 
   // 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++) {
+  for (let i=0; i < entriesNamedBegin.length; i++) {
     let typeOfEntry = entriesNamedBegin[i].entryType;
     console.log("L'entrée est de type : " + typeOfEntry);
   }
 }
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-entrytype', - 'entryType')}}{{Spec2('Performance Timeline Level 2')}}
{{SpecName('Performance Timeline', '#dom-performanceentry-entrytype', - 'entryType')}}{{Spec2('Performance Timeline')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceEntry.entryType")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performanceentry-entrytype', + 'entryType')}} | {{Spec2('Performance Timeline Level 2')}} | | +| {{SpecName('Performance Timeline', '#dom-performanceentry-entrytype', + 'entryType')}} | {{Spec2('Performance Timeline')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceEntry.entryType")}} diff --git a/files/fr/web/api/performanceentry/index.md b/files/fr/web/api/performanceentry/index.md index 32e388a73b..9a9a38ca32 100644 --- a/files/fr/web/api/performanceentry/index.md +++ b/files/fr/web/api/performanceentry/index.md @@ -10,51 +10,46 @@ tags: - Performance Web translation_of: Web/API/PerformanceEntry --- -
{{APIRef("Performance Timeline API")}}
+{{APIRef("Performance Timeline API")}} -

L'objet PerformanceEntry encapsule une seule mesure de performance qui fait partie de la chronologie de performance. Une entrée de performance peut être créée directement en faisant une marque ou une mesure (par exemple en appelant la méthode mark()) à 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).

+L'objet **`PerformanceEntry`** encapsule une seule mesure de performance qui fait partie de la _chronologie de performance_. Une _entrée de performance_ peut être créée directement en faisant _[une marque](/fr/docs/Web/API/PerformanceMark)_ ou _[une mesure](/fr/docs/Web/API/PerformanceMeasure)_ (par exemple en appelant la méthode [`mark()`](/fr/docs/Web/API/Performance/mark)) à 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). -

Les instances PerformanceEntry auront toujours l'un des sous-types suivants :

+Les instances `PerformanceEntry` auront toujours l'un des sous-types suivants : - +- [`PerformanceMark`](/fr/docs/Web/API/PerformanceMark) +- [`PerformanceMeasure`](/fr/docs/Web/API/PerformanceMeasure) +- [`PerformanceFrameTiming`](/fr/docs/Web/API/PerformanceFrameTiming) +- [`PerformanceNavigationTiming`](/fr/docs/Web/API/PerformanceNavigationTiming) +- [`PerformanceResourceTiming`](/fr/docs/Web/API/PerformanceResourceTiming) +- [`PerformancePaintTiming`](/fr/docs/Web/API/PerformancePaintTiming) -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Propriétés

+## Propriétés -
-
PerformanceEntry.name {{readonlyInline}}
-
Une valeur qui précise davantage la valeur renvoyée par la propriété PerformanceEntry.entryType. La valeur des deux dépend du sous-type. Voir la page de la propriété pour les valeurs valides.
-
PerformanceEntry.entryType {{readonlyInline}}
-
Une chaîne de caractère DOMString représentant le type de mesure de performance comme, par exemple, "mark". Voir la page des propriétés pour les valeurs valides.
-
PerformanceEntry.startTime {{readonlyInline}}
-
Un objet DOMHighResTimeStamp représentant l'heure de départ de la mesure de performance.
-
PerformanceEntry.duration {{readonlyInline}}
-
Un objet DOMHighResTimeStamp représentant la valeur temporelle de la durée de l'événement de performance.
-
+- [`PerformanceEntry.name`](/fr/docs/Web/API/PerformanceEntry/name) {{readonlyInline}} + - : Une valeur qui précise davantage la valeur renvoyée par la propriété [`PerformanceEntry.entryType`](/fr/docs/Web/API/PerformanceEntry/entryType). La valeur des deux dépend du sous-type. Voir la page de la propriété pour les valeurs valides. +- [`PerformanceEntry.entryType`](/fr/docs/Web/API/PerformanceEntry/entryType) {{readonlyInline}} + - : Une chaîne de caractère [`DOMString`](/fr/docs/Web/API/DOMString) représentant le type de mesure de performance comme, par exemple, "`mark`". Voir la page des propriétés pour les valeurs valides. +- [`PerformanceEntry.startTime`](/fr/docs/Web/API/PerformanceEntry/startTime) {{readonlyInline}} + - : Un objet [`DOMHighResTimeStamp`](/fr/docs/Web/API/DOMHighResTimeStamp) représentant l'heure de départ de la mesure de performance. +- [`PerformanceEntry.duration`](/fr/docs/Web/API/PerformanceEntry/duration) {{readonlyInline}} + - : Un objet [`DOMHighResTimeStamp`](/fr/docs/Web/API/DOMHighResTimeStamp) représentant la valeur temporelle de la durée de l'événement de performance. -

Méthodes

+## Méthodes -
-
PerformanceEntry.toJSON()
-
Renvoie une représentation JSON de l'objet PerformanceEntry.
-
+- [`PerformanceEntry.toJSON()`](/fr/docs/Web/API/PerformanceEntry/toJSON) + - : Renvoie une représentation JSON de l'objet `PerformanceEntry`. -

Exemple

+## Exemple -

L'exemple suivant vérifie toutes les propriétés PerformanceEntry pour voir si le navigateur les prend en charge et, le cas échéant, écrit leurs valeurs dans la console.

+L'exemple suivant vérifie toutes les propriétés `PerformanceEntry` pour voir si le navigateur les prend en charge et, le cas échéant, écrit leurs valeurs dans la console. -
function print_PerformanceEntries() {
+```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++) {
+  for (let i = 0; i < p.length; i++) {
     console.log("PerformanceEntry[" + i + "]");
     print_PerformanceEntry(p[i]);
   }
@@ -65,7 +60,7 @@ function print_PerformanceEntry(perfEntry) {
                     "startTime",
                     "duration"];
 
-  for (let i = 0; i < properties.length; i++) {
+  for (let i = 0; i < properties.length; i++) {
     // Vérifie chaque propriété
     let supported = properties[i] in perfEntry;
     if (supported) {
@@ -76,72 +71,23 @@ function print_PerformanceEntry(perfEntry) {
     }
   }
 }
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Resource Timing 3')}}{{Spec2('Resource Timing 3')}}
{{SpecName('Resource Timing 2')}}{{Spec2('Resource Timing 2')}}
{{SpecName('Resource Timing')}}{{Spec2('Resource Timing')}}Ajoute l'interface PerformanceResourceTiming et la valeur resource pour entryType.
{{SpecName('Navigation Timing Level 2')}}{{Spec2('Navigation Timing Level 2')}}
{{SpecName('Navigation Timing')}}{{Spec2('Navigation Timing')}}Ajoute l'interface PerformanceNavigationTiming et la valeur navigation pour entryType.
{{SpecName('User Timing Level 2')}}{{Spec2('User Timing Level 2')}}
{{SpecName('User Timing')}}{{Spec2('User Timing')}}Ajoute les interfaces PerformanceMark et PerformanceMeasure ainsi que les valeurs mark et measure pour entryType.
{{SpecName('Frame Timing')}}{{Spec2('Frame Timing')}}Ajoute l'interface PerformanceFrameTiming et la valeur frame pour entryType.
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry', 'PerformanceEntry')}}{{Spec2('Performance Timeline Level 2')}}Ajout de la méthode de sérialisation toJSON().
{{SpecName('Performance Timeline', '#dom-performanceentry', 'PerformanceEntry')}}{{Spec2('Performance Timeline')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

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

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| {{SpecName('Resource Timing 3')}} | {{Spec2('Resource Timing 3')}} | | +| {{SpecName('Resource Timing 2')}} | {{Spec2('Resource Timing 2')}} | | +| {{SpecName('Resource Timing')}} | {{Spec2('Resource Timing')}} | Ajoute l'interface [`PerformanceResourceTiming`](/fr/docs/Web/API/PerformanceResourceTiming) et la valeur `resource` pour `entryType`. | +| {{SpecName('Navigation Timing Level 2')}} | {{Spec2('Navigation Timing Level 2')}} | | +| {{SpecName('Navigation Timing')}} | {{Spec2('Navigation Timing')}} | Ajoute l'interface [`PerformanceNavigationTiming`](/fr/docs/Web/API/PerformanceNavigationTiming) et la valeur `navigation` pour `entryType`. | +| {{SpecName('User Timing Level 2')}} | {{Spec2('User Timing Level 2')}} | | +| {{SpecName('User Timing')}} | {{Spec2('User Timing')}} | Ajoute les interfaces [`PerformanceMark`](/fr/docs/Web/API/PerformanceMark) et [`PerformanceMeasure`](/fr/docs/Web/API/PerformanceMeasure) ainsi que les valeurs `mark` et `measure` pour `entryType`. | +| {{SpecName('Frame Timing')}} | {{Spec2('Frame Timing')}} | Ajoute l'interface [`PerformanceFrameTiming`](/fr/docs/Web/API/PerformanceFrameTiming) et la valeur `frame` pour `entryType`. | +| {{SpecName('Performance Timeline Level 2', '#dom-performanceentry', 'PerformanceEntry')}} | {{Spec2('Performance Timeline Level 2')}} | Ajout de la méthode de sérialisation `toJSON()`. | +| {{SpecName('Performance Timeline', '#dom-performanceentry', 'PerformanceEntry')}} | {{Spec2('Performance Timeline')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceEntry")}} diff --git a/files/fr/web/api/performanceentry/name/index.md b/files/fr/web/api/performanceentry/name/index.md index 6e8c05fe4e..9bc2ee9e97 100644 --- a/files/fr/web/api/performanceentry/name/index.md +++ b/files/fr/web/api/performanceentry/name/index.md @@ -11,70 +11,36 @@ tags: - Performance Web translation_of: Web/API/PerformanceEntry/name --- -
{{APIRef("Performance Timeline API")}}
- -

La propriété name de l'interface PerformanceEntry renvoie une valeur qui précise davantage la valeur renvoyée par la propriété PerformanceEntry.entryType. Cette propriété est en lecture seule.

- -

{{AvailableInWorkers}}

- -

Syntaxe

- -
var name = entry.name;
-
- -

Valeur de retour

- -

La valeur de retour dépend du sous-type de l'objet PerformanceEntry et de la valeur de PerformanceEntry.entryType, comme le montre le tableau ci-dessous.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Type de valeur pour nameSous-typeType (entryType)Description
URLPerformanceFrameTiming, - PerformanceNavigationTimingframe, navigationL'adresse du document.
URLPerformanceResourceTimingresourceL'URL résolue de la ressource demandée. Cette valeur ne change pas même si la demande est redirigée.
DOMStringPerformanceMarkmarkLe nom utilisé lorsque le marqueur a été créé en appelant mark().
DOMStringPerformanceMeasuremeasureLe nom utilisé lorsque la mesure a été créée en appelant measure().
DOMStringPerformancePaintTimingpaintSoit 'first-paint' ou 'first-contentful-paint'.
- -

Exemple

- -

L'exemple suivant montre l'utilisation de la propriété name.

- -
function run_PerformanceEntry() {
+{{APIRef("Performance Timeline API")}}
+
+La propriété **`name`** de l'interface [`PerformanceEntry`](/fr/docs/Web/API/PerformanceEntry) renvoie une valeur qui précise davantage la valeur renvoyée par la propriété [`PerformanceEntry.entryType`](/fr/docs/Web/API/PerformanceEntry/entryType). Cette propriété est en lecture seule.
+
+{{AvailableInWorkers}}
+
+## Syntaxe
+
+```js
+var name = entry.name;
+```
+
+### Valeur de retour
+
+La valeur de retour dépend du sous-type de l'objet `PerformanceEntry` et de la valeur de [`PerformanceEntry.entryType`](/fr/docs/Web/API/PerformanceEntry/entryType), comme le montre le tableau ci-dessous.
+
+| Type de valeur pour `name`                | Sous-type                                                                                                                                          | Type (`entryType`)    | Description                                                                                                   |
+| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------- |
+| [`URL`](/fr/docs/Web/API/URL)             | [`PerformanceFrameTiming`](/fr/docs/Web/API/PerformanceFrameTiming), [`PerformanceNavigationTiming`](/fr/docs/Web/API/PerformanceNavigationTiming) | `frame`, `navigation` | L'adresse du document.                                                                                        |
+| [`URL`](/fr/docs/Web/API/URL)             | [`PerformanceResourceTiming`](/fr/docs/Web/API/PerformanceResourceTiming)                                                                          | `resource`            | L'URL résolue de la ressource demandée. Cette valeur ne change pas même si la demande est redirigée.          |
+| [`DOMString`](/fr/docs/Web/API/DOMString) | [`PerformanceMark`](/fr/docs/Web/API/PerformanceMark)                                                                                              | `mark`                | Le nom utilisé lorsque le marqueur a été créé en appelant [`mark()`](/fr/docs/Web/API/Performance/mark).      |
+| [`DOMString`](/fr/docs/Web/API/DOMString) | [`PerformanceMeasure`](/fr/docs/Web/API/PerformanceMeasure)                                                                                        | `measure`             | Le nom utilisé lorsque la mesure a été créée en appelant [`measure()`](/fr/docs/Web/API/Performance/measure). |
+| [`DOMString`](/fr/docs/Web/API/DOMString) | [`PerformancePaintTiming`](/fr/docs/Web/API/PerformancePaintTiming)                                                                                | `paint`               | Soit `'first-paint'` ou `'first-contentful-paint'`.                                                           |
+
+## Exemple
+
+L'exemple suivant montre l'utilisation de la propriété `name`.
+
+```js
+function run_PerformanceEntry() {
   console.log("Support de PerformanceEntry ...");
 
   if (performance.mark === undefined) {
@@ -89,7 +55,7 @@ translation_of: Web/API/PerformanceEntry/name
 
   // Utilise getEntries() pour itérer à travers chaque entrée.
   let p = performance.getEntries();
-  for (let i = 0; i < p.length; i++) {
+  for (let i = 0; i < p.length; i++) {
     console.log("Entry[" + i + "]");
     check_PerformanceEntry(p[i]);
   }
@@ -98,7 +64,7 @@ function check_PerformanceEntry(obj) {
   let properties = ["name", "entryType", "startTime", "duration"];
   let methods = ["toJSON"];
 
-  for (let i = 0; i < properties.length; i++) {
+  for (let i = 0; i < properties.length; i++) {
     // Vérifie chaque propriété
     let supported = properties[i] in obj;
     if (supported)
@@ -106,7 +72,7 @@ function check_PerformanceEntry(obj) {
     else
       console.log("..." + properties[i] + " = Not supported");
   }
-  for (let i = 0; i < methods.length; i++) {
+  for (let i = 0; i < methods.length; i++) {
     // Vérifie chaque méthode
     let supported = typeof obj[methods[i]] == "function";
     if (supported) {
@@ -117,34 +83,17 @@ function check_PerformanceEntry(obj) {
     }
   }
 }
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-name', - 'name')}}{{Spec2('Performance Timeline Level 2')}}
{{SpecName('Performance Timeline', '#dom-performanceentry-name', - 'name')}}{{Spec2('Performance Timeline')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceEntry.name")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performanceentry-name', + 'name')}} | {{Spec2('Performance Timeline Level 2')}} | | +| {{SpecName('Performance Timeline', '#dom-performanceentry-name', + 'name')}} | {{Spec2('Performance Timeline')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceEntry.name")}} diff --git a/files/fr/web/api/performanceentry/starttime/index.md b/files/fr/web/api/performanceentry/starttime/index.md index e8f625d52f..e6adbf8a54 100644 --- a/files/fr/web/api/performanceentry/starttime/index.md +++ b/files/fr/web/api/performanceentry/starttime/index.md @@ -11,42 +11,41 @@ tags: - Performance Web translation_of: Web/API/PerformanceEntry/startTime --- -
{{APIRef("Performance Timeline API")}}
+{{APIRef("Performance Timeline API")}} -

La propriété startTime renvoie le premier timestamp enregistré pour l'entrée de performance.

+La propriété **`startTime`** renvoie le premier [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) enregistré pour l'[entrée de performance](/fr/docs/Web/API/PerformanceEntry). -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

La valeur renvoyée par cette propriété dépend du type de l'entrée de performance :

+La valeur renvoyée par cette propriété dépend du [`type`](/fr/docs/Web/API/PerformanceEntry/entryType) de l'entrée de performance : - +- « `frame` » - retourne le + [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) quand l'affichage a été démarré. +- « `mark` » - retourne le [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) lorsque le marquage a été créé par un appel de [`performance.mark()`](/fr/docs/Web/API/Performance/mark). +- « `measure` » - retourne le [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) lorsque la mesure a été créée par un appel à [`performance.measure()`](/fr/docs/Web/API/Performance/measure). +- « `navigation` » - retourne le [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) avec une valeur de "`0`". +- « `resource` » - retourne le [`timestamp`](/fr/docs/Web/API/DOMHighResTimeStamp) immédiatement avant que le navigateur ne [commence à récupérer la ressource](/fr/docs/Web/API/PerformanceResourceTiming/fetchStart). -

Cette propriété est en lecture seule.

+Cette propriété est en lecture seule. -

Syntaxe

+## Syntaxe -
entry.startTime;
+```js +entry.startTime; +``` -

Valeur de retour

+### Valeur de retour -

Un objet DOMHighResTimeStamp représentant le premier horodatage lorsque l'entrée de performance a été créée.

+Un objet [`DOMHighResTimeStamp`](/fr/docs/Web/API/DOMHighResTimeStamp) représentant le premier horodatage lorsque l'[entrée de performance](/fr/docs/Web/API/PerformanceEntry) a été créée. -
-

Note : Si l'entrée de performance a un entryType "resource" (c'est-à-dire que l'entrée est un objet PerformanceResourceTiming), cette propriété renvoie la valeur de l'horodatage fournie par PerformanceResourceTiming.fetchStart.

-
+> **Note :** Si l'entrée de performance a un [`entryType`](/fr/docs/Web/API/PerformanceEntry/entryType) "`resource`" (c'est-à-dire que l'entrée est un objet [`PerformanceResourceTiming`](/fr/docs/Web/API/PerformanceResourceTiming)), cette propriété renvoie la valeur de l'horodatage fournie par [`PerformanceResourceTiming.fetchStart`](/fr/docs/Web/API/PerformanceResourceTiming/fetchStart). -

Exemple

+## Exemple -

L'exemple suivant montre l'utilisation de la propriété startTime.

+L'exemple suivant montre l'utilisation de la propriété `startTime`. -
function run_PerformanceEntry() {
+```js
+function run_PerformanceEntry() {
   console.log("Support de PerformanceEntry ...");
 
   if (performance.mark === undefined) {
@@ -61,7 +60,7 @@ translation_of: Web/API/PerformanceEntry/startTime
 
   // Utilise getEntries() pour itérer à travers chaque entrée
   let p = performance.getEntries();
-  for (let i = 0; i < p.length; i++) {
+  for (let i = 0; i < p.length; i++) {
     log("Entry[" + i + "]");
     check_PerformanceEntry(p[i]);
   }
@@ -70,7 +69,7 @@ function check_PerformanceEntry(obj) {
   let properties = ["name", "entryType", "startTime", "duration"];
   let methods = ["toJSON"];
 
-  for (let i = 0; i < properties.length; i++) {
+  for (let i = 0; i < properties.length; i++) {
     // On vérifie chaque propriété
     let supported = properties[i] in obj;
     if (supported)
@@ -78,7 +77,7 @@ function check_PerformanceEntry(obj) {
     else
       log("..." + properties[i] + " = N'est pas pris en charge");
   }
-  for (let i = 0; i < methods.length; i++) {
+  for (let i = 0; i < methods.length; i++) {
     // On vérifie chaque méthode
     let supported = typeof obj[methods[i]] == "function";
     if (supported) {
@@ -89,34 +88,17 @@ function check_PerformanceEntry(obj) {
     }
   }
 }
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-starttime', - 'startTime')}}{{Spec2('Performance Timeline Level 2')}}
{{SpecName('Performance Timeline', '#dom-performanceentry-starttime', - 'startTime')}}{{Spec2('Performance Timeline')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceEntry.startTime")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performanceentry-starttime', + 'startTime')}} | {{Spec2('Performance Timeline Level 2')}} | | +| {{SpecName('Performance Timeline', '#dom-performanceentry-starttime', + 'startTime')}} | {{Spec2('Performance Timeline')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceEntry.startTime")}} diff --git a/files/fr/web/api/performanceentry/tojson/index.md b/files/fr/web/api/performanceentry/tojson/index.md index 9450e8f3f0..6d02774855 100644 --- a/files/fr/web/api/performanceentry/tojson/index.md +++ b/files/fr/web/api/performanceentry/tojson/index.md @@ -11,33 +11,33 @@ tags: - Performance Web translation_of: Web/API/PerformanceEntry/toJSON --- -
{{APIRef("Performance Timeline API")}}
+{{APIRef("Performance Timeline API")}} -

La méthode toJSON() permet de sérialiser l'objet PerformanceEntry courant et renvoie une représentation JSON de l'objet.

+La méthode **`toJSON()`** permet de sérialiser l'objet [`PerformanceEntry`](/fr/docs/Web/API/PerformanceEntry) courant et renvoie une représentation JSON de l'objet. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntaxe

+## Syntaxe -
let jsonObj = perfEntry.toJSON();
-
+```js +let jsonObj = perfEntry.toJSON(); +``` -

Arguments

+### Arguments -

Aucun.

+Aucun. -

Valeur de retour

+### Valeur de retour -
-
json
-
Un objet JSON qui est la sérialisation de l'objet PerformanceEntry.
-
+- `json` + - : Un objet JSON qui est la sérialisation de l'objet [`PerformanceEntry`](/fr/docs/Web/API/PerformanceEntry). -

Exemple

+## Exemple -

L'exemple suivant montre l'utilisation de la méthode toJSON().

+L'exemple suivant montre l'utilisation de la méthode `toJSON()`. -
function run_PerformanceEntry() {
+```js
+function run_PerformanceEntry() {
   console.log("Support de PerformanceEntry ...");
 
   if (performance.mark === undefined) {
@@ -52,7 +52,7 @@ translation_of: Web/API/PerformanceEntry/toJSON
 
   // Utilise getEntries() pour itérer à travers chaque entrée.
   let p = performance.getEntries();
-  for (let i = 0; i < p.length; i++) {
+  for (let i = 0; i < p.length; i++) {
     console.log("Entry[" + i + "]");
     check_PerformanceEntry(p[i]);
   }
@@ -61,7 +61,7 @@ function check_PerformanceEntry(obj) {
   let properties = ["name", "entryType", "startTime", "duration"];
   let methods = ["toJSON"];
 
-  for (let i = 0; i < properties.length; i++) {
+  for (let i = 0; i < properties.length; i++) {
     // On vérifie chaque propriété
     let supported = properties[i] in obj;
     if (supported)
@@ -69,7 +69,7 @@ function check_PerformanceEntry(obj) {
     else
       console.log("..." + properties[i] + " = N'est pas pris en charge");
   }
-  for (let i = 0; i < methods.length; i++) {
+  for (let i = 0; i < methods.length; i++) {
     // On vérifie chaque méthode
     let supported = typeof obj[methods[i]] == "function";
     if (supported) {
@@ -80,28 +80,15 @@ function check_PerformanceEntry(obj) {
     }
   }
 }
-
- -

Spécifications

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

Compatibilité des navigateurs

- -

{{Compat("api.PerformanceEntry.toJSON")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performanceentry-tojson', + 'toJSON')}} | {{Spec2('Performance Timeline Level 2')}} | Définition initiale de la méthode `toJSON()`. | + +## Compatibilité des navigateurs + +{{Compat("api.PerformanceEntry.toJSON")}} -- cgit v1.2.3-54-g00ecf