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 --- files/fr/web/api/performance/measure/index.md | 107 +++++++++++--------------- 1 file changed, 43 insertions(+), 64 deletions(-) (limited to 'files/fr/web/api/performance/measure') diff --git a/files/fr/web/api/performance/measure/index.md b/files/fr/web/api/performance/measure/index.md index 74ab333134..8035478a40 100644 --- a/files/fr/web/api/performance/measure/index.md +++ b/files/fr/web/api/performance/measure/index.md @@ -2,60 +2,57 @@ title: performance.measure() slug: Web/API/Performance/measure tags: -- API -- Method -- Méthode -- Reference -- Performance web -- Web Workers + - API + - Method + - Méthode + - Reference + - Performance web + - Web Workers translation_of: Web/API/Performance/measure --- -
{{APIRef("User Timing API")}}
+{{APIRef("User Timing API")}} -

La méthode measure() crée un {{domxref("DOMHighResTimeStamp", "timestamp")}} nommé dans le tampon d'entrée de performance du navigateur entre deux marqueurs, l'heure de début de navigation ou l'heure actuelle. Lors d'une mesure entre deux marqueurs, on aura un marqueur de début et un marqueur de fin. L'horodatage ainsi nommé est désigné comme une mesure.

+La méthode **`measure()`** crée un {{domxref("DOMHighResTimeStamp", "timestamp")}} nommé dans le _tampon d'entrée de performance_ du navigateur entre deux marqueurs, l'heure de début de navigation ou l'heure actuelle. Lors d'une mesure entre deux marqueurs, on aura un _marqueur de début_ et un _marqueur de fin_. L'horodatage ainsi nommé est désigné comme une _mesure_. -

La mesure correspondante peut être récupérée par l'une des méthodes suivantes de l'interface {{domxref("Performance")}} : {{domxref("Performance.getEntries", "getEntries()")}}, {{domxref("Performance.getEntriesByName", "getEntriesByName()")}} ou {{domxref("Performance.getEntriesByType", "getEntriesByType()")}}.

+La mesure correspondante peut être récupérée par l'une des méthodes suivantes de l'interface {{domxref("Performance")}} : {{domxref("Performance.getEntries", "getEntries()")}}, {{domxref("Performance.getEntriesByName", "getEntriesByName()")}} ou {{domxref("Performance.getEntriesByType", "getEntriesByType()")}}. -

L'{{domxref("PerformanceEntry", "entrée de performance","",1)}} créée par measure() aura les valeurs de propriété suivantes :

+L'{{domxref("PerformanceEntry", "entrée de performance","",1)}} créée par `measure()` aura les valeurs de propriété suivantes : - +- {{domxref("PerformanceEntry.entryType","entryType")}} : `"measure"`. +- {{domxref("PerformanceEntry.name","name")}} : le nom passé en argument lors de la création de la mesure (cf. ci-après). +- {{domxref("PerformanceEntry.startTime","startTime")}} : fixé selon le marqueur de départ (type {{domxref("DOMHighResTimeStamp")}}). +- {{domxref("PerformanceEntry.duration","duration")}} : fixé à un {{domxref("DOMHighResTimeStamp")}} qui correspond à la durée de la mesure (généralement, l'horodatage du marqueur de fin moins l'horodatage du marqueur de début). -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntaxe

+## Syntaxe -
+```js
   performance.measure(name);
   performance.measure(name, startMark);
   performance.measure(name, startMark, endMark);
   performance.measure(name, undefined, endMark);
-
+``` -

Arguments

+### Arguments -
-
name
-
Une {{domxref("DOMString")}} représentant le nom de la mesure.
-
startMark {{optional_inline}}
-
Une {{domxref("DOMString")}} représentant le nom du marqueur de départ de la mesure. Peut également être le nom d'une propriété {{domxref("PerformanceTiming")}}. Si elle est omise, l'heure de début sera celle de la navigation.
-
endMark {{optional_inline}}
-
Une {{domxref("DOMString")}} représentant le nom du marqueur de fin de la mesure. Peut également être le nom d'une propriété {{domxref("PerformanceTiming")}}. Si elle est omise, le temps actuel est utilisé.
-
+- `name` + - : Une {{domxref("DOMString")}} représentant le nom de la mesure. +- `startMark` {{optional_inline}} + - : Une {{domxref("DOMString")}} représentant le nom du marqueur de départ de la mesure. Peut également être le nom d'une propriété {{domxref("PerformanceTiming")}}. Si elle est omise, l'heure de début sera celle de la navigation. +- `endMark` {{optional_inline}} + - : Une {{domxref("DOMString")}} représentant le nom du marqueur de fin de la mesure. Peut également être le nom d'une propriété {{domxref("PerformanceTiming")}}. Si elle est omise, le temps actuel est utilisé. -

Valeur de retour

+### Valeur de retour -

Aucune

+Aucune -

Exemple

+## Exemple -

L'exemple suivant montre comment measure() est utilisé pour créer une nouvelle mesure d'{{domxref("PerformanceEntry", "entrée de performance","",1)}} dans le tampon d'entrée de performance du navigateur.

+L'exemple suivant montre comment `measure()` est utilisé pour créer une nouvelle _mesure_ d'{{domxref("PerformanceEntry", "entrée de performance","",1)}} dans le tampon d'entrée de performance du navigateur. -
const markerNameA = "example-marker-a"
+```js
+const markerNameA = "example-marker-a"
 const markerNameB = "example-marker-b"
 
 // Exécute des temporisations imbriquées et crée un PerformanceMark pour chacune d'entre elles.
@@ -78,33 +75,15 @@ setTimeout(function() {
     performance.clearMeasures();
   }, 1000);
 }, 1000);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('User Timing Level 2', '#dom-performance-measure', 'measure()')}} - {{Spec2('User Timing Level 2')}}Clarification du modèle de traitement de mesure().
{{SpecName('User Timing', '#dom-performance-measure', 'measure()')}}{{Spec2('User Timing')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Performance.measure")}}

+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | -------------------------------------------- | ---------------------------------------------------- | +| {{SpecName('User Timing Level 2', '#dom-performance-measure', 'measure()')}} | {{Spec2('User Timing Level 2')}} | Clarification du modèle de traitement de `mesure()`. | +| {{SpecName('User Timing', '#dom-performance-measure', 'measure()')}} | {{Spec2('User Timing')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Performance.measure")}} -- cgit v1.2.3-54-g00ecf