diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/performance | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/performance')
18 files changed, 595 insertions, 920 deletions
diff --git a/files/fr/web/api/performance/clearmarks/index.md b/files/fr/web/api/performance/clearmarks/index.md index 81571fb42e..e425a10a63 100644 --- a/files/fr/web/api/performance/clearmarks/index.md +++ b/files/fr/web/api/performance/clearmarks/index.md @@ -9,35 +9,34 @@ tags: - Performance web translation_of: Web/API/Performance/clearMarks --- -<div>{{APIRef("User Timing API")}}</div> +{{APIRef("User Timing API")}} -<p>La méthode <strong><code>clearMarks()</code></strong> supprime les <em>marqueurs nommés</em> du tampon d'entrée des performances du navigateur. Si la méthode est appelée sans arguments, toutes les {{domxref("PerformanceEntry", "entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType", "entryType")}} de « <code>mark</code> » seront supprimées du tampon d'entrée de performance.</p> +La méthode **`clearMarks()`** supprime les _marqueurs nommés_ du tampon d'entrée des performances du navigateur. Si la méthode est appelée sans arguments, toutes les {{domxref("PerformanceEntry", "entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType", "entryType")}} de « `mark` » seront supprimées du tampon d'entrée de performance. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - <em>performance</em>.clearMarks(); - <em>performance</em>.clearMarks(name); -</pre> +```js + performance.clearMarks(); + performance.clearMarks(name); +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt>name {{optional_inline}}</dt> - <dd>Un {{domxref("DOMString")}} représentant le nom de l'horodatage. Si cet argument est omis, toutes les {{domxref("PerformanceEntry","entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} de « <code>mark</code> » seront supprimés.</dd> -</dl> +- name {{optional_inline}} + - : Un {{domxref("DOMString")}} représentant le nom de l'horodatage. Si cet argument est omis, toutes les {{domxref("PerformanceEntry","entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} de « `mark` » seront supprimés. -<h3 id="Return_value">Valeur de retour</h3> +### Valeur de retour -<p>Aucune.</p> +Aucune. -<h2 id="Example">Exemple</h2> +## Exemple -<p>L'exemple suivant montre les deux utilisations de la méthode <code>clearMarks()</code>.</p> +L'exemple suivant montre les deux utilisations de la méthode `clearMarks()`. -<pre class="brush: js">// Créé une petite aide pour montrer combien d'entrées PerformanceMark il y a. +```js +// Créé une petite aide pour montrer combien d'entrées PerformanceMark il y a. function logMarkCount() { console.log( "J'ai trouvé autant d'entrées : " + performance.getEntriesByType("mark").length @@ -61,33 +60,16 @@ logMarkCount() // "J'ai trouvé autant d'entrées : 4" // Supprime toutes les entrées de PerformanceMark. performance.clearMarks(); logMarkCount() // "J'ai trouvé autant d'entrées : 0" -</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('User Timing Level 2', '#dom-performance-clearmarks', - 'clearMarks()')}}</td> - <td>{{Spec2('User Timing Level 2')}}</td> - <td>Clarification de <code>clearMarks()</code>.</td> - </tr> - <tr> - <td>{{SpecName('User Timing', '#dom-performance-clearmarks', 'clearMarks()')}}</td> - <td>{{Spec2('User Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Performance.clearMarks")}}</p> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | -------------------------------- | +| {{SpecName('User Timing Level 2', '#dom-performance-clearmarks', + 'clearMarks()')}} | {{Spec2('User Timing Level 2')}} | Clarification de `clearMarks()`. | +| {{SpecName('User Timing', '#dom-performance-clearmarks', 'clearMarks()')}} | {{Spec2('User Timing')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Performance.clearMarks")}} diff --git a/files/fr/web/api/performance/clearmeasures/index.md b/files/fr/web/api/performance/clearmeasures/index.md index 0748baa2b2..b85bd98cfd 100644 --- a/files/fr/web/api/performance/clearmeasures/index.md +++ b/files/fr/web/api/performance/clearmeasures/index.md @@ -9,35 +9,34 @@ tags: - Performance web translation_of: Web/API/Performance/clearMeasures --- -<div>{{APIRef("User Timing API")}}</div> +{{APIRef("User Timing API")}} -<p>La méthode <strong><code>clearMeasures()</code></strong> supprime les <em>mesures nommées</em> du tampon d'entrée des performances du navigateur. Si la méthode est appelée sans arguments, toutes les {{domxref("PerformanceEntry", "entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} de « <code>measure</code> » seront supprimées du tampon d'entrée de performance.</p> +La méthode **`clearMeasures()`** supprime les _mesures nommées_ du tampon d'entrée des performances du navigateur. Si la méthode est appelée sans arguments, toutes les {{domxref("PerformanceEntry", "entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} de « `measure` » seront supprimées du tampon d'entrée de performance. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - <em>performance</em>.clearMeasures(); - <em>performance</em>.clearMeasures(name); -</pre> +```js + performance.clearMeasures(); + performance.clearMeasures(name); +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt>name {{optional_inline}}</dt> - <dd>Un {{domxref("DOMString")}} représentant le nom de l'horodatage. Si cet argument est omis, toutes les {{domxref("PerformanceEntry","entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entrType")}} de « <code>measure</code> » seront supprimés.</dd> -</dl> +- name {{optional_inline}} + - : Un {{domxref("DOMString")}} représentant le nom de l'horodatage. Si cet argument est omis, toutes les {{domxref("PerformanceEntry","entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entrType")}} de « `measure` » seront supprimés. -<h3 id="Return_value">Valeur de retour</h3> +### Valeur de retour -<p>Aucune.</p> +Aucune. -<h2 id="Example">Exemple</h2> +## Exemple -<p>L'exemple suivant montre les deux utilisations de la méthode <code>clearMeasures()</code>.</p> +L'exemple suivant montre les deux utilisations de la méthode `clearMeasures()`. -<pre class="brush: js">// Crée une petite aide pour montrer combien d'entrées PerformanceMeasure il y a. +```js +// Crée une petite aide pour montrer combien d'entrées PerformanceMeasure il y a. function logMeasureCount() { console.log( "J'ai trouvé ces nombreuses entrées : " + performance.getEntriesByType("measure").length @@ -62,34 +61,16 @@ logMeasureCount() // "J'ai trouvé ces nombreuses entrées : 3" // Supprime toutes les entrées de PerformanceMeasure. performance.clearMeasures(); logMeasureCount() // "J'ai trouvé ces nombreuses entrées : 0" -</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('User Timing Level 2', '#dom-performance-clearmeasures', - 'clearMeasures()')}}</td> - <td>{{Spec2('User Timing Level 2')}}</td> - <td>Carification de <code>clearMeasures()</code>.</td> - </tr> - <tr> - <td>{{SpecName('User Timing', '#dom-performance-clearmeasures', 'clearMeasures()')}} - </td> - <td>{{Spec2('User Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Performance.clearMeasures")}}</p> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ---------------------------------- | +| {{SpecName('User Timing Level 2', '#dom-performance-clearmeasures', + 'clearMeasures()')}} | {{Spec2('User Timing Level 2')}} | Carification de `clearMeasures()`. | +| {{SpecName('User Timing', '#dom-performance-clearmeasures', 'clearMeasures()')}} | {{Spec2('User Timing')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Performance.clearMeasures")}} diff --git a/files/fr/web/api/performance/clearresourcetimings/index.md b/files/fr/web/api/performance/clearresourcetimings/index.md index b7a87a662a..6ba70dbddf 100644 --- a/files/fr/web/api/performance/clearresourcetimings/index.md +++ b/files/fr/web/api/performance/clearresourcetimings/index.md @@ -2,35 +2,37 @@ title: performance.clearResourceTimings() slug: Web/API/Performance/clearResourceTimings tags: -- API -- Method -- Méthode -- Reference -- Performance web + - API + - Method + - Méthode + - Reference + - Performance web translation_of: Web/API/Performance/clearResourceTimings --- -<div>{{APIRef("Resource Timing API")}}</div> +{{APIRef("Resource Timing API")}} -<p>La méthode <strong><code>clearResourceTimings()</code></strong> supprime toutes les {{domxref("PerformanceEntry", "entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} de « <code>resource</code> » du tampon d'entrée de performance et fixe la taille du tampon de données de performance à zéro. Pour définir la taille du tampon de données de performance du navigateur, utilisez la méthode {{domxref("Performance.setResourceTimingBufferSize()")}}.</p> +La méthode **`clearResourceTimings()`** supprime toutes les {{domxref("PerformanceEntry", "entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} de « `resource` » du tampon d'entrée de performance et fixe la taille du tampon de données de performance à zéro. Pour définir la taille du tampon de données de performance du navigateur, utilisez la méthode {{domxref("Performance.setResourceTimingBufferSize()")}}. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"><em>performance</em>.clearResourceTimings(); -</pre> +```js +performance.clearResourceTimings(); +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<p>Aucun.</p> +Aucun. -<h3 id="Return_Value">Valeur de retour</h3> +### Valeur de retour -<p>Aucune.</p> +Aucune. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">function load_resource() { +```js +function load_resource() { var image = new Image(); image.src = "https://developer.mozilla.org/static/img/opengraph-logo.png"; } @@ -57,28 +59,15 @@ function clear_performance_timings() { else console.log("... Le tampon de données de performance n'a PAS été effacé !"); } -</pre> +``` -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<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', '#dom-performance-clearresourcetimings', - 'clearResourceTimings()')}}</td> - <td>{{Spec2('Resource Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- | +| {{SpecName('Resource Timing', '#dom-performance-clearresourcetimings', + 'clearResourceTimings()')}} | {{Spec2('Resource Timing')}} | Définition initiale. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.clearResourceTimings")}}</p> +{{Compat("api.Performance.clearResourceTimings")}} diff --git a/files/fr/web/api/performance/getentries/index.md b/files/fr/web/api/performance/getentries/index.md index 1cf2fd1832..06d1c8bc97 100644 --- a/files/fr/web/api/performance/getentries/index.md +++ b/files/fr/web/api/performance/getentries/index.md @@ -2,35 +2,34 @@ title: performance.getEntries() slug: Web/API/Performance/getEntries tags: -- API -- Method -- Méthode -- Reference -- Performance web + - API + - Method + - Méthode + - Reference + - Performance web translation_of: Web/API/Performance/getEntries --- -<div>{{APIRef("Performance Timeline API")}}</div> +{{APIRef("Performance Timeline API")}} -<p>La méthode <strong><code>getEntries()</code></strong> renvoie une liste de tous les objets {{domxref("PerformanceEntry")}} pour la page. Les membres de la liste (<em>entrées</em>) peuvent être créés en faisant des <em>marqueurs</em> ou des <em>mesures</em> de performance (par exemple en appelant la méthode {{domxref("Performance.mark", "mark()")}}) à des moments explicites. Si vous souhaitez filtrer les entrées de performance en fonction de leur type ou de leur nom, consultez la documentation des méthodes {{domxref("Performance.getEntriesByType", "getEntriesByType()")}} et {{domxref("Performance.getEntriesByName", "getEntriesByName()")}}.</p> +La méthode **`getEntries()`** renvoie une liste de tous les objets {{domxref("PerformanceEntry")}} pour la page. Les membres de la liste (_entrées_) peuvent être créés en faisant des _marqueurs_ ou des _mesures_ de performance (par exemple en appelant la méthode {{domxref("Performance.mark", "mark()")}}) à des moments explicites. Si vous souhaitez filtrer les entrées de performance en fonction de leur type ou de leur nom, consultez la documentation des méthodes {{domxref("Performance.getEntriesByType", "getEntriesByType()")}} et {{domxref("Performance.getEntriesByName", "getEntriesByName()")}}. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - <var>entries</var> = window.performance.getEntries(); -</pre> +```js + entries = window.performance.getEntries(); +``` -<h3 id="Return_Value">Valeur de retour</h3> +### Valeur de retour -<dl> - <dt><code>entries</code></dt> - <dd>Un tableau ({{jsxref("Array")}}) d'objets {{domxref("PerformanceEntry")}}. Les éléments seront classés par ordre chronologique en fonction des entrées {{domxref("PerformanceEntry.startTime","startTime")}}.</dd> -</dl> +- `entries` + - : Un tableau ({{jsxref("Array")}}) d'objets {{domxref("PerformanceEntry")}}. Les éléments seront classés par ordre chronologique en fonction des entrées {{domxref("PerformanceEntry.startTime","startTime")}}. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">function use_PerformanceEntry_methods() { +```js +function use_PerformanceEntry_methods() { console.log("PerformanceEntry tests ..."); if (performance.mark === undefined) { @@ -50,14 +49,14 @@ translation_of: Web/API/Performance/getEntries // Utilise getEntries() pour itérer à travers chaque entrée. let p = performance.getEntries(); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { console.log("Entry[" + i + "]"); check_PerformanceEntry(p[i]); } // Utilise getEntriesByType() pour obtenir toutes les entrées "mark". p = performance.getEntriesByType("mark"); - for (let i=0; i < p.length; i++) { + for (let i=0; i < p.length; i++) { console.log ("Mark only entry[" + i + "]: name = " + p[i].name + "; startTime = " + p[i].startTime + "; duration = " + p[i].duration); @@ -65,40 +64,23 @@ translation_of: Web/API/Performance/getEntries // Utilise getEntriesByName() pour obtenir toutes les entrées "mark" nommées "Begin". p = performance.getEntriesByName("Begin", "mark"); - for (let i=0; i < p.length; i++) { + for (let i=0; i < p.length; i++) { console.log ("Mark and Begin entry[" + i + "]: name = " + p[i].name + "; startTime = " + p[i].startTime + "; duration = " + p[i].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-performance-getentries', - 'getEntries()')}}</td> - <td>{{Spec2('Performance Timeline Level 2')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('Performance Timeline', '#dom-performance-getentries', - 'getEntries()')}}</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.Performance.getEntries")}}</p> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performance-getentries', + 'getEntries()')}} | {{Spec2('Performance Timeline Level 2')}} | | +| {{SpecName('Performance Timeline', '#dom-performance-getentries', + 'getEntries()')}} | {{Spec2('Performance Timeline')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Performance.getEntries")}} diff --git a/files/fr/web/api/performance/getentriesbyname/index.md b/files/fr/web/api/performance/getentriesbyname/index.md index ac125fe6be..52c885f1aa 100644 --- a/files/fr/web/api/performance/getentriesbyname/index.md +++ b/files/fr/web/api/performance/getentriesbyname/index.md @@ -9,37 +9,34 @@ tags: - Performance web translation_of: Web/API/Performance/getEntriesByName --- -<div>{{APIRef("Performance Timeline API")}}</div> +{{APIRef("Performance Timeline API")}} -<p>La méthode <strong><code>getEntriesByName()</code></strong> renvoie une liste de tous les objets {{domxref("PerformanceEntry")}} ayant un nom (et éventuellement un type) donné(s). Les entrées de performance auront pu être créées au préalable avec des <em>marqueurs</em> ou des <em>mesures</em> de performance (par exemple en appelant la méthode {{domxref("Performance.mark", "mark()")}}) à des moments explicites.</p> +La méthode **`getEntriesByName()`** renvoie une liste de tous les objets {{domxref("PerformanceEntry")}} ayant un nom (et éventuellement un type) donné(s). Les entrées de performance auront pu être créées au préalable avec des _marqueurs_ ou des _mesures_ de performance (par exemple en appelant la méthode {{domxref("Performance.mark", "mark()")}}) à des moments explicites. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - <var>entries</var> = window.performance.getEntriesByName(name, type); -</pre> +```js + entries = window.performance.getEntriesByName(name, type); +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt><code>name</code></dt> - <dd>Le nom de l'entrée à récupérer.</dd> - <dt><code>type</code> {{optional_inline}}</dt> - <dd>Le type d'entrée à récupérer tel que « <code>mark</code> ». Les types d'entrées valides sont listés dans {{domxref("PerformanceEntry.entryType")}}.</dd> -</dl> +- `name` + - : Le nom de l'entrée à récupérer. +- `type` {{optional_inline}} + - : Le type d'entrée à récupérer tel que « `mark` ». Les types d'entrées valides sont listés dans {{domxref("PerformanceEntry.entryType")}}. -<h3 id="Return_Value">Valeur de retour</h3> +### Valeur de retour -<dl> - <dt><code>entries</code></dt> - <dd>Une liste de tous les objets {{domxref("PerformanceEntry")}} ayant le nom et le type spécifiés. Si l'argument <code>type</code> n'est pas spécifié, seul le nom (<code>name</code>) sera utilisé pour déterminer les entrées à renvoyer. Les éléments seront dans l'ordre chronologique basé sur les {{domxref("PerformanceEntry.startTime", "startTime")}} des entrées. Si aucun objet ne répond aux critères spécifiés, une liste vide est retournée.</dd> -</dl> +- `entries` + - : Une liste de tous les objets {{domxref("PerformanceEntry")}} ayant le nom et le type spécifiés. Si l'argument `type` n'est pas spécifié, seul le nom (`name`) sera utilisé pour déterminer les entrées à renvoyer. Les éléments seront dans l'ordre chronologique basé sur les {{domxref("PerformanceEntry.startTime", "startTime")}} des entrées. Si aucun objet ne répond aux critères spécifiés, une liste vide est retournée. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">function use_PerformanceEntry_methods() { +```js +function use_PerformanceEntry_methods() { log("PerformanceEntry tests ..."); if (performance.mark === undefined) { @@ -59,21 +56,21 @@ translation_of: Web/API/Performance/getEntriesByName // Utilise getEntries() pour itérer à travers chaque entrée var p = performance.getEntries(); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { log("Entry[" + i + "]"); check_PerformanceEntry(p[i]); } // Utilise getEntries(name, entryType) pour obtenir des entrées spécifiques p = performance.getEntries({name : "Begin", entryType: "mark"}); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { log("Begin[" + i + "]"); check_PerformanceEntry(p[i]); } // Utilise getEntriesByType() pour obtenir toutes les entrées "mark" p = performance.getEntriesByType("mark"); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { log ("Mark only entry[" + i + "]: name = " + p[i].name + "; startTime = " + p[i].startTime + "; duration = " + p[i].duration); @@ -81,40 +78,23 @@ translation_of: Web/API/Performance/getEntriesByName // Utilisez getEntriesByName() pour obtenir toutes les entrées "mark" nommées "Begin" p = performance.getEntriesByName("Begin", "mark"); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { log ("Mark and Begin entry[" + i + "]: name = " + p[i].name + "; startTime = " + p[i].startTime + "; duration = " + p[i].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-performance-getentriesbyname', - 'getEntriesByName()')}}</td> - <td>{{Spec2('Performance Timeline Level 2')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('Performance Timeline', '#dom-performance-getentriesbyname', - 'getEntriesByName()')}}</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.Performance.getEntriesByName")}}</p> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performance-getentriesbyname', + 'getEntriesByName()')}} | {{Spec2('Performance Timeline Level 2')}} | | +| {{SpecName('Performance Timeline', '#dom-performance-getentriesbyname', + 'getEntriesByName()')}} | {{Spec2('Performance Timeline')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Performance.getEntriesByName")}} diff --git a/files/fr/web/api/performance/getentriesbytype/index.md b/files/fr/web/api/performance/getentriesbytype/index.md index 3644cd0f60..13283ac65d 100644 --- a/files/fr/web/api/performance/getentriesbytype/index.md +++ b/files/fr/web/api/performance/getentriesbytype/index.md @@ -2,42 +2,39 @@ title: performance.getEntriesByType() slug: Web/API/Performance/getEntriesByType tags: -- API -- Method -- Méthode -- Reference -- Performance web + - API + - Method + - Méthode + - Reference + - Performance web translation_of: Web/API/Performance/getEntriesByType --- -<div>{{APIRef("Performance Timeline API")}}</div> +{{APIRef("Performance Timeline API")}} -<p>La méthode <strong><code>getEntriesByName()</code></strong> renvoie une liste de tous les objets {{domxref("PerformanceEntry")}} pour le type donné. Les entrées de performance auront pu être créées au préalable avec des <em>marqueurs</em> ou des <em>mesures</em> de performance (par exemple en appelant la méthode {{domxref("Performance.mark", "mark()")}}) à des moments explicites.</p> +La méthode **`getEntriesByName()`** renvoie une liste de tous les objets {{domxref("PerformanceEntry")}} pour le type donné. Les entrées de performance auront pu être créées au préalable avec des _marqueurs_ ou des _mesures_ de performance (par exemple en appelant la méthode {{domxref("Performance.mark", "mark()")}}) à des moments explicites. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - let <var>entries</var> = window.performance.getEntriesByType(type); -</pre> +```js + let entries = window.performance.getEntriesByType(type); +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt><code>type</code></dt> - <dd>Le type d'entrée à récupérer tel que « <code>mark</code> ». Les types d'entrées valides sont listés dans {{domxref("PerformanceEntry.entryType")}}.</dd> -</dl> +- `type` + - : Le type d'entrée à récupérer tel que « `mark` ». Les types d'entrées valides sont listés dans {{domxref("PerformanceEntry.entryType")}}. -<h3 id="Return_Value">Valeur de retour</h3> +### Valeur de retour -<dl> - <dt><code>entries</code></dt> - <dd>Une liste de tous les objets {{domxref("PerformanceEntry")}} ayant le <em>type</em> spécifié. Les éléments seront triés dans l'ordre chronologique basé sur les propriétés {{domxref("PerformanceEntry.startTime", "startTime")}} des entrées. Si aucun objet ne possède le type spécifié, ou si aucun argument n'est fourni, une liste vide est renvoyée.</dd> -</dl> +- `entries` + - : Une liste de tous les objets {{domxref("PerformanceEntry")}} ayant le _type_ spécifié. Les éléments seront triés dans l'ordre chronologique basé sur les propriétés {{domxref("PerformanceEntry.startTime", "startTime")}} des entrées. Si aucun objet ne possède le type spécifié, ou si aucun argument n'est fourni, une liste vide est renvoyée. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">function usePerformanceEntryMethods() { +```js +function usePerformanceEntryMethods() { log("PerformanceEntry tests ..."); if (performance.mark === undefined) { @@ -57,21 +54,21 @@ translation_of: Web/API/Performance/getEntriesByType // Utilise getEntries() pour itérer à travers chaque entrée. var p = performance.getEntries(); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { log("Entry[" + i + "]"); checkPerformanceEntry(p[i]); } // Utilise getEntries(name, entryType) pour obtenir des entrées spécifiques. p = performance.getEntries({name : "Begin", entryType: "mark"}); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { log("Begin[" + i + "]"); checkPerformanceEntry(p[i]); } // Utilise getEntriesByType() pour obtenir toutes les entrées "mark". p = performance.getEntriesByType("mark"); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { log("Mark only entry[" + i + "]: name = " + p[i].name + "; startTime = " + p[i].startTime + "; duration = " + p[i].duration); @@ -79,40 +76,23 @@ translation_of: Web/API/Performance/getEntriesByType // Utilise getEntriesByName() pour obtenir toutes les entrées "mark" nommées "Begin". p = performance.getEntriesByName("Begin", "mark"); - for (var i=0; i < p.length; i++) { + for (var i=0; i < p.length; i++) { log("Mark and Begin entry[" + i + "]: name = " + p[i].name + "; startTime = " + p[i].startTime + "; duration = " + p[i].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-performance-getentriesbytype', - 'getEntriesByType()')}}</td> - <td>{{Spec2('Performance Timeline Level 2')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('Performance Timeline', '#dom-performance-getentriesbytype', - 'getEntriesByType()')}}</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.Performance.getEntriesByType")}}</p> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | -------------------- | +| {{SpecName('Performance Timeline Level 2', '#dom-performance-getentriesbytype', + 'getEntriesByType()')}} | {{Spec2('Performance Timeline Level 2')}} | | +| {{SpecName('Performance Timeline', '#dom-performance-getentriesbytype', + 'getEntriesByType()')}} | {{Spec2('Performance Timeline')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Performance.getEntriesByType")}} diff --git a/files/fr/web/api/performance/index.md b/files/fr/web/api/performance/index.md index 3de85d05ed..76be371a85 100644 --- a/files/fr/web/api/performance/index.md +++ b/files/fr/web/api/performance/index.md @@ -9,148 +9,88 @@ tags: - Reference translation_of: Web/API/Performance --- -<div>{{APIRef("High Resolution Time")}}</div> - -<p>L'interface <strong><code>Performance</code></strong> donne accès à des informations liées aux performances pour la page actuelle. Elle fait partie de l'API « High Resolution Time », mais est complétée par les APIs <a href="/fr/docs/Web/API/Performance_Timeline">Performance Timeline</a>, <a href="/fr/docs/Web/API/Navigation_timing_API">Navigation Timing</a>, <a href="/fr/docs/Web/API/User_Timing_API">User Timing</a>, et <a href="/fr/docs/Web/API/Resource_Timing_API">Resource Timing</a>.</p> - -<p>Un objet de ce type peut être obtenu en appelant l'attribut en lecture seule {{domxref("window.performance")}}.</p> - -<div class="note"> - <p><strong>Note :</strong> Cette interface et ses attributs sont accessibles aux <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a> via <code><a href="/fr/docs/Web/API/WorkerGlobalScope/performance">WorkerGlobalScope.performance</a></code> sauf dans les cas cités ci-dessous. Notez également que les marqueurs et les mesures de performance sont définis par contexte. Si vous créez un marqueur dans le processus principal (ou un autre Web Worker), vous ne pourrez pas le voir dans le processus du Web Worker, et réciproquement.</p> -</div> - -<h2 id="Properties">Propriétés</h2> - -<p><em>L'interface <code>Performance</code> n'hérite d'aucune propriété.</em></p> - -<dl> - <dt> - {{domxref("performance.navigation")}} {{readonlyInline}} {{deprecated_inline}} - </dt> - <dd> - {{domxref("PerformanceNavigation")}} est un objet qui fournit des informations contextuelles sur les opérations incluses dans les indicateurs de <code>timing</code>, notamment si la page a été chargée ou actualisée, combien de redirections ont été effectuées, etc… - <div class="note"> - <p><strong>Note :</strong> Indisponible dans les Web Workers.</p> - </div> - </dd> - <dt> - {{domxref("performance.timing")}} {{readonlyInline}} {{deprecated_inline}} - </dt> - <dd> - {{domxref("PerformanceTiming")}} est un objet contenant des informations de performance liées à la latence. - <div class="note"> - <p><strong>Note :</strong> Indisponible dans les Web Workers.</p> - </div> - </dd> - <dt> - {{domxref("performance.memory")}} {{readonlyInline}} {{Non-standard_inline}}</dt> - <dd> - Une extension <em>non standard</em> ajoutée dans Chrome, cette propriété fournit à un objet des informations de base sur l'utilisation de la mémoire. <em>Vous <strong>ne devriez pas utiliser</strong> cette API non standard.</em> - </dd> - <dt> - {{domxref("Performance.timeOrigin")}} {{readonlyInline}} {{Experimental_inline}} - </dt> - <dd> - Fournit un horodatage haute résolution de l'heure de début de la mesure de performance. - </dd> -</dl> - -<h2 id="Methods">Méthodes</h2> - -<p><em>L'interface <code>Performance</code> n'hérite d'aucune méthode</em>.</p> - -<dl> - <dt>{{domxref("performance.clearMarks()")}}</dt> - <dd>Supprime le <em>marqueur</em> indiqué des données de performances du navigateur mises en mémoire tampon.</dd> - <dt>{{domxref("performance.clearMeasures()")}}</dt> - <dd>Supprime la <em>mesure</em> indiquée des données de performances du navigateur mises en mémoire tampon.</dd> - <dt>{{domxref("performance.clearResourceTimings()")}}</dt> - <dd>Supprime toutes les {{domxref("PerformanceEntry","entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} "<code>resource</code>" des données de performances du navigateur mises en mémoire tampon.</dd> - <dt>{{domxref("performance.getEntries()")}}</dt> - <dd>Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le <em>filtre</em> indiqué.</dd> - <dt>{{domxref("performance.getEntriesByName()")}}</dt> - <dd>Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le <em>nom</em> indiqué.</dd> - <dt>{{domxref("performance.getEntriesByType()")}}</dt> - <dd>Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le <em>type</em> indiqué.</dd> - <dt>{{domxref("performance.mark()")}}</dt> - <dd>Crée un {{domxref("DOMHighResTimeStamp","timestamp")}} avec le nom indiqué, dans la mémoire tampon du navigateur dédiée aux performances.</dd> - <dt>{{domxref("performance.measure()")}}</dt> - <dd>Crée un {{domxref("DOMHighResTimeStamp","timestamp")}} nommé, dans la mémoire tampon du navigateur dédiée aux performances, entre deux marqueurs spécifiques (connus comme le <em>marqueur de début</em> et le <em>marqueur de fin</em>, respectivement).</dd> - <dt>{{domxref("Performance.now()")}}</dt> - <dd>Retourne un objet {{domxref("DOMHighResTimeStamp")}} représentant le nombre de millisecondes écoulées depuis un instant donné.</dd> - <dt>{{domxref("performance.setResourceTimingBufferSize()")}}</dt> - <dd>Configure la taille de la mémoire tampon pour le chronométrage des ressources du navigateur. La valeur passée en argument indiquera le nombre maximal d'objets {{domxref("PerformanceEntry")}} ayant le {{domxref("PerformanceEntry.entryType","type")}} "<code>resource</code>" qu'il sera possible d'y stocker.</dd> - <dt>{{domxref("Performance.toJSON()")}}</dt> - <dd>Retourne un objet JSON représentant l'objet <code>Performance</code>.</dd> -</dl> - -<h2 id="Events">Événements</h2> - -<p>On pourra écouter ces événements en utilisant <code>addEventListener()</code> ou en assignant un gestionnaire d'événement à la propriété <code>on<em><EventName></em></code> de cette interface.</p> - -<dl> - <dt>{{DOMxRef("Performance.resourcetimingbufferfull_event", "resourcetimingbufferfull")}}</dt> - <dd>Déclenché lorsque le <a href="/fr/docs/Web/API/Performance/setResourceTimingBufferSize">tampon de synchronisation des ressources</a> du navigateur est plein. Également disponible via la propriété {{DOMxRef("Performance.onresourcetimingbufferfull", "onresourcetimingbufferfull")}}.</dd> -</dl> - -<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">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Highres Time Level 2', '#sec-performance', 'Performance')}}</td> - <td>{{Spec2('Highres Time Level 2')}}</td> - <td>Définition de la méthode <code>toJson()</code>.</td> - </tr> - <tr> - <td>{{SpecName('Highres Time', '#performance', 'Performance')}}</td> - <td>{{Spec2('Highres Time')}}</td> - <td>Définition de la méthode <code>now()</code>.</td> - </tr> - <tr> - <td>{{SpecName('Performance Timeline Level 2', '#extensions-to-the-performance-interface', 'Performance extensions')}}</td> - <td>{{Spec2('Performance Timeline Level 2')}}</td> - <td>Changements sur l'interface <code>getEntries()</code>.</td> - </tr> - <tr> - <td>{{SpecName('Performance Timeline', '#extensions-to-the-performance-interface', 'Performance extensions')}}</td> - <td>{{Spec2('Performance Timeline')}}</td> - <td>Définition des méthodes <code>getEntries()</code>, <code>getEntriesByType()</code> et <code>getEntriesByName()</code>.</td> - </tr> - <tr> - <td>{{SpecName('Resource Timing', '#extensions-performance-interface', 'Performance extensions')}}</td> - <td>{{Spec2('Resource Timing')}}</td> - <td>Définition des méthodes <code>clearResourceTimings()</code> et <code>setResourceTimingBufferSize()</code> et de la propriété <code>onresourcetimingbufferfull</code>.</td> - </tr> - <tr> - <td>{{SpecName('User Timing Level 2', '#extensions-performance-interface', 'Performance extensions')}}</td> - <td>{{Spec2('User Timing Level 2')}}</td> - <td>Clarifications des méthodes <code>mark()</code>, <code>clearMark()</code>, <code>measure()</code> et <code>clearMeasure()</code>.</td> - </tr> - <tr> - <td>{{SpecName('User Timing', '#extensions-performance-interface', 'Performance extensions')}}</td> - <td>{{Spec2('User Timing')}}</td> - <td>Définition des méthodes <code>mark()</code>, <code>clearMark()</code>, <code>measure()</code> et <code>clearMeasure()</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Performance")}}</p> - -<h2 id="See_Also">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/Performance_Timeline">Performance Timeline</a></li> - <li><a href="/fr/docs/Web/API/Navigation_timing_API">Navigation Timing API</a></li> - <li><a href="/fr/docs/Web/API/User_Timing_API">User Timing API</a></li> - <li><a href="/fr/docs/Web/API/Resource_Timing_API">Resource Timing API</a></li> -</ul> +{{APIRef("High Resolution Time")}} + +L'interface **`Performance`** donne accès à des informations liées aux performances pour la page actuelle. Elle fait partie de l'API « High Resolution Time », mais est complétée par les APIs [Performance Timeline](/fr/docs/Web/API/Performance_Timeline), [Navigation Timing](/fr/docs/Web/API/Navigation_timing_API), [User Timing](/fr/docs/Web/API/User_Timing_API), et [Resource Timing](/fr/docs/Web/API/Resource_Timing_API). + +Un objet de ce type peut être obtenu en appelant l'attribut en lecture seule {{domxref("window.performance")}}. + +> **Note :** Cette interface et ses attributs sont accessibles aux [Web Workers](/fr/docs/Web/API/Web_Workers_API) via [`WorkerGlobalScope.performance`](/fr/docs/Web/API/WorkerGlobalScope/performance) sauf dans les cas cités ci-dessous. Notez également que les marqueurs et les mesures de performance sont définis par contexte. Si vous créez un marqueur dans le processus principal (ou un autre Web Worker), vous ne pourrez pas le voir dans le processus du Web Worker, et réciproquement. + +## Propriétés + +_L'interface `Performance` n'hérite d'aucune propriété._ + +- {{domxref("performance.navigation")}} {{readonlyInline}} {{deprecated_inline}} + + - : {{domxref("PerformanceNavigation")}} est un objet qui fournit des informations contextuelles sur les opérations incluses dans les indicateurs de `timing`, notamment si la page a été chargée ou actualisée, combien de redirections ont été effectuées, etc… + + > **Note :** Indisponible dans les Web Workers. + +- {{domxref("performance.timing")}} {{readonlyInline}} {{deprecated_inline}} + + - : {{domxref("PerformanceTiming")}} est un objet contenant des informations de performance liées à la latence. + + > **Note :** Indisponible dans les Web Workers. + +- {{domxref("performance.memory")}} {{readonlyInline}} {{Non-standard_inline}} + - : Une extension _non standard_ ajoutée dans Chrome, cette propriété fournit à un objet des informations de base sur l'utilisation de la mémoire. _Vous **ne devriez pas utiliser** cette API non standard._ +- {{domxref("Performance.timeOrigin")}} {{readonlyInline}} {{Experimental_inline}} + - : Fournit un horodatage haute résolution de l'heure de début de la mesure de performance. + +## Méthodes + +_L'interface `Performance` n'hérite d'aucune méthode_. + +- {{domxref("performance.clearMarks()")}} + - : Supprime le _marqueur_ indiqué des données de performances du navigateur mises en mémoire tampon. +- {{domxref("performance.clearMeasures()")}} + - : Supprime la _mesure_ indiquée des données de performances du navigateur mises en mémoire tampon. +- {{domxref("performance.clearResourceTimings()")}} + - : Supprime toutes les {{domxref("PerformanceEntry","entrées de performance","",1)}} avec un {{domxref("PerformanceEntry.entryType","entryType")}} "`resource`" des données de performances du navigateur mises en mémoire tampon. +- {{domxref("performance.getEntries()")}} + - : Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le _filtre_ indiqué. +- {{domxref("performance.getEntriesByName()")}} + - : Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le _nom_ indiqué. +- {{domxref("performance.getEntriesByType()")}} + - : Retourne une liste d'objets {{domxref("PerformanceEntry")}} basée sur le _type_ indiqué. +- {{domxref("performance.mark()")}} + - : Crée un {{domxref("DOMHighResTimeStamp","timestamp")}} avec le nom indiqué, dans la mémoire tampon du navigateur dédiée aux performances. +- {{domxref("performance.measure()")}} + - : Crée un {{domxref("DOMHighResTimeStamp","timestamp")}} nommé, dans la mémoire tampon du navigateur dédiée aux performances, entre deux marqueurs spécifiques (connus comme le _marqueur de début_ et le _marqueur de fin_, respectivement). +- {{domxref("Performance.now()")}} + - : Retourne un objet {{domxref("DOMHighResTimeStamp")}} représentant le nombre de millisecondes écoulées depuis un instant donné. +- {{domxref("performance.setResourceTimingBufferSize()")}} + - : Configure la taille de la mémoire tampon pour le chronométrage des ressources du navigateur. La valeur passée en argument indiquera le nombre maximal d'objets {{domxref("PerformanceEntry")}} ayant le {{domxref("PerformanceEntry.entryType","type")}} "`resource`" qu'il sera possible d'y stocker. +- {{domxref("Performance.toJSON()")}} + - : Retourne un objet JSON représentant l'objet `Performance`. + +## Événements + +On pourra écouter ces événements en utilisant `addEventListener()` ou en assignant un gestionnaire d'événement à la propriété `on<EventName>` de cette interface. + +- {{DOMxRef("Performance.resourcetimingbufferfull_event", "resourcetimingbufferfull")}} + - : Déclenché lorsque le [tampon de synchronisation des ressources](/fr/docs/Web/API/Performance/setResourceTimingBufferSize) du navigateur est plein. Également disponible via la propriété {{DOMxRef("Performance.onresourcetimingbufferfull", "onresourcetimingbufferfull")}}. + +## Spécifications + +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | +| {{SpecName('Highres Time Level 2', '#sec-performance', 'Performance')}} | {{Spec2('Highres Time Level 2')}} | Définition de la méthode `toJson()`. | +| {{SpecName('Highres Time', '#performance', 'Performance')}} | {{Spec2('Highres Time')}} | Définition de la méthode `now()`. | +| {{SpecName('Performance Timeline Level 2', '#extensions-to-the-performance-interface', 'Performance extensions')}} | {{Spec2('Performance Timeline Level 2')}} | Changements sur l'interface `getEntries()`. | +| {{SpecName('Performance Timeline', '#extensions-to-the-performance-interface', 'Performance extensions')}} | {{Spec2('Performance Timeline')}} | Définition des méthodes `getEntries()`, `getEntriesByType()` et `getEntriesByName()`. | +| {{SpecName('Resource Timing', '#extensions-performance-interface', 'Performance extensions')}} | {{Spec2('Resource Timing')}} | Définition des méthodes `clearResourceTimings()` et `setResourceTimingBufferSize()` et de la propriété `onresourcetimingbufferfull`. | +| {{SpecName('User Timing Level 2', '#extensions-performance-interface', 'Performance extensions')}} | {{Spec2('User Timing Level 2')}} | Clarifications des méthodes `mark()`, `clearMark()`, `measure()` et `clearMeasure()`. | +| {{SpecName('User Timing', '#extensions-performance-interface', 'Performance extensions')}} | {{Spec2('User Timing')}} | Définition des méthodes `mark()`, `clearMark()`, `measure()` et `clearMeasure()`. | + +## Compatibilité des navigateurs + +{{Compat("api.Performance")}} + +## Voir aussi + +- [Performance Timeline](/fr/docs/Web/API/Performance_Timeline) +- [Navigation Timing API](/fr/docs/Web/API/Navigation_timing_API) +- [User Timing API](/fr/docs/Web/API/User_Timing_API) +- [Resource Timing API](/fr/docs/Web/API/Resource_Timing_API) diff --git a/files/fr/web/api/performance/mark/index.md b/files/fr/web/api/performance/mark/index.md index c33a169606..f589c9759f 100644 --- a/files/fr/web/api/performance/mark/index.md +++ b/files/fr/web/api/performance/mark/index.md @@ -2,45 +2,46 @@ title: performance.mark() slug: Web/API/Performance/mark tags: -- API -- Method -- Méthode -- Reference -- Performance web + - API + - Method + - Méthode + - Reference + - Performance web translation_of: Web/API/Performance/mark --- -<div>{{APIRef("User Timing API")}}</div> +{{APIRef("User Timing API")}} -<p>La méthode <strong><code>mark()</code></strong> crée un {{domxref("DOMHighResTimeStamp", "timestamp")}} dans le <em>tampon d'entrée de performance</em> du navigateur avec le nom donné en argument.</p> +La méthode **`mark()`** crée un {{domxref("DOMHighResTimeStamp", "timestamp")}} dans le _tampon d'entrée de performance_ du navigateur avec le nom donné en argument. -<p>L'horodatage ainsi défini par l'application peut être récupéré par l'une des méthodes <code>getEntries*()</code> de l'interface {{domxref("Performance")}} ({{domxref("Performance.getEntries", "getEntries()")}}, {{domxref("Performance.getEntriesByName", "getEntriesByName()")}} ou {{domxref("Performance.getEntriesByType", "getEntriesByType()")}}).</p> +L'horodatage ainsi défini par l'application peut être récupéré par l'une des méthodes `getEntries*()` de l'interface {{domxref("Performance")}} ({{domxref("Performance.getEntries", "getEntries()")}}, {{domxref("Performance.getEntriesByName", "getEntriesByName()")}} ou {{domxref("Performance.getEntriesByType", "getEntriesByType()")}}). -<p>La méthode <code>mark()</code> stocke ses données en interne sous la forme d'objets {{domxref("PerformanceEntry")}}.</p> +La méthode `mark()` stocke ses données en interne sous la forme d'objets {{domxref("PerformanceEntry")}}. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js performance.mark(name); -</pre> +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt><code>name</code></dt> - <dd>Une chaîne de caractères ({{domxref("DOMString")}}) représentant le nom du marqueur. Si le nom donné à cette méthode existe déjà dans l'interface {{domxref("PerformanceTiming")}}, une exception {{jsxref("SyntaxError")}} est levée.</dd> -</dl> +- `name` + - : Une chaîne de caractères ({{domxref("DOMString")}}) représentant le nom du marqueur. Si le nom donné à cette méthode existe déjà dans l'interface {{domxref("PerformanceTiming")}}, une exception {{jsxref("SyntaxError")}} est levée. -<h3 id="Return_value">Valeur de retour</h3> +### Valeur de retour -<p>Aucune.</p>> +Aucune. -<h2 id="Example">Exemple</h2> +\> -<p>L'exemple suivant montre comment utiliser <code>mark()</code> pour créer et récupérer des entrées {{domxref("PerformanceMark")}}.</p> +## Exemple -<pre class="brush:js">// Crée un ensemble de marqueurs. +L'exemple suivant montre comment utiliser `mark()` pour créer et récupérer des entrées {{domxref("PerformanceMark")}}. + +```js +// Crée un ensemble de marqueurs. performance.mark("squirrel"); performance.mark("squirrel"); performance.mark("monkey"); @@ -60,32 +61,15 @@ console.log(monkeyEntries.length); // Efface tous les marqueurs. performance.clearMarks(); -</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('User Timing Level 2', '#dom-performance-mark', 'mark()')}}</td> - <td>{{Spec2('User Timing Level 2')}}</td> - <td>Clarification du modèle de traitement <code>mark()</code>.</td> - </tr> - <tr> - <td>{{SpecName('User Timing', '#dom-performance-mark', 'mark()')}}</td> - <td>{{Spec2('User Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Performance.mark")}}</p> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------------------- | ----------------------------------------------- | +| {{SpecName('User Timing Level 2', '#dom-performance-mark', 'mark()')}} | {{Spec2('User Timing Level 2')}} | Clarification du modèle de traitement `mark()`. | +| {{SpecName('User Timing', '#dom-performance-mark', 'mark()')}} | {{Spec2('User Timing')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Performance.mark")}} 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 --- -<div>{{APIRef("User Timing API")}}</div> +{{APIRef("User Timing API")}} -<p>La méthode <strong><code>measure()</code></strong> crée un {{domxref("DOMHighResTimeStamp", "timestamp")}} nommé dans le <em>tampon d'entrée de performance</em> 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 <em>marqueur de début</em> et un <em>marqueur de fin</em>. L'horodatage ainsi nommé est désigné comme une <em>mesure</em>.</p> +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_. -<p>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()")}}.</p> +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()")}}. -<p>L'{{domxref("PerformanceEntry", "entrée de performance","",1)}} créée par <code>measure()</code> aura les valeurs de propriété suivantes :</p> +L'{{domxref("PerformanceEntry", "entrée de performance","",1)}} créée par `measure()` aura les valeurs de propriété suivantes : -<ul> - <li>{{domxref("PerformanceEntry.entryType","entryType")}} : <code>"measure"</code>.</li> - <li>{{domxref("PerformanceEntry.name","name")}} : le nom passé en argument lors de la création de la mesure (cf. ci-après).</li> - <li>{{domxref("PerformanceEntry.startTime","startTime")}} : fixé selon le marqueur de départ (type {{domxref("DOMHighResTimeStamp")}}).</li> - <li>{{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).</li> -</ul> +- {{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). -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js performance.measure(name); performance.measure(name, startMark); performance.measure(name, startMark, endMark); performance.measure(name, undefined, endMark); -</pre> +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt><code>name</code></dt> - <dd>Une {{domxref("DOMString")}} représentant le nom de la mesure.</dd> - <dt><code>startMark</code> {{optional_inline}}</dt> - <dd>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.</dd> - <dt><code>endMark</code> {{optional_inline}}</dt> - <dd>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é.</dd> -</dl> +- `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é. -<h3 id="Return_value">Valeur de retour</h3> +### Valeur de retour -<p>Aucune</p> +Aucune -<h2 id="Example">Exemple</h2> +## Exemple -<p>L'exemple suivant montre comment <code>measure()</code> est utilisé pour créer une nouvelle <em>mesure</em> d'{{domxref("PerformanceEntry", "entrée de performance","",1)}} dans le tampon d'entrée de performance du navigateur.</p> +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. -<pre class="brush: js">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); -</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('User Timing Level 2', '#dom-performance-measure', 'measure()')}} - </td> - <td>{{Spec2('User Timing Level 2')}}</td> - <td>Clarification du modèle de traitement de <code>mesure()</code>.</td> - </tr> - <tr> - <td>{{SpecName('User Timing', '#dom-performance-measure', 'measure()')}}</td> - <td>{{Spec2('User Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Performance.measure")}}</p> +``` + +## 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")}} diff --git a/files/fr/web/api/performance/memory/index.md b/files/fr/web/api/performance/memory/index.md index a98b747b49..2a922d4fb3 100644 --- a/files/fr/web/api/performance/memory/index.md +++ b/files/fr/web/api/performance/memory/index.md @@ -7,37 +7,33 @@ tags: - Performance web translation_of: Web/API/Performance/memory --- -<p>{{APIRef}}</p> +{{APIRef}} {{Non-standardGeneric('header')}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - <em>timingInfo</em> = <em>performance</em>.memory -</pre> +```js + timingInfo = performance.memory +``` -<h2 id="Attributes">Attributs</h2> +## Attributs -<dl> - <dt><code>jsHeapSizeLimit</code></dt> - <dd>La taille maximale du tas, en octets, qui est disponible pour le contexte.</dd> - <dt><code>totalJSHeapSize</code></dt> - <dd>La taille totale du répertoire alloué, en octets.</dd> - <dt>usedJSHeapSize</dt> - <dd>Le segment actuellement actif du répertoire JS, en octets.</dd> -</dl> +- `jsHeapSizeLimit` + - : La taille maximale du tas, en octets, qui est disponible pour le contexte. +- `totalJSHeapSize` + - : La taille totale du répertoire alloué, en octets. +- usedJSHeapSize + - : Le segment actuellement actif du répertoire JS, en octets. -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<p>Aucune</p> +Aucune -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.memory")}}</p> +{{Compat("api.Performance.memory")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>L'interface {{domxref("Performance")}} à laquelle il appartient.</li> -</ul> +- L'interface {{domxref("Performance")}} à laquelle il appartient. diff --git a/files/fr/web/api/performance/navigation/index.md b/files/fr/web/api/performance/navigation/index.md index b3487091fd..a136ce9393 100644 --- a/files/fr/web/api/performance/navigation/index.md +++ b/files/fr/web/api/performance/navigation/index.md @@ -15,47 +15,30 @@ tags: - legacy translation_of: Web/API/Performance/navigation --- -<p>{{Deprecated_Header}}{{APIRef("Navigation Timing")}}</p> +{{Deprecated_Header}}{{APIRef("Navigation Timing")}} -<div class="warning"> - <p><strong>Attention :</strong> Cette propriété est dépréciée dans la spécification <a href="https://w3c.github.io/navigation-timing/#obsolete">Navigation Timing Level 2 specification</a>.</p> -</div> +> **Attention :** Cette propriété est dépréciée dans la spécification [Navigation Timing Level 2 specification](https://w3c.github.io/navigation-timing/#obsolete). -<p>L'ancienne propriété en lecture seule <strong><code>Performance.navigation</code></strong> renvoie un objet {{domxref("PerformanceNavigation")}} représentant le type de navigation qui se produit dans le contexte de navigation donné, comme le nombre de redirections nécessaires pour aller chercher la ressource.</p> +L'ancienne propriété en lecture seule **`Performance.navigation`** renvoie un objet {{domxref("PerformanceNavigation")}} représentant le type de navigation qui se produit dans le contexte de navigation donné, comme le nombre de redirections nécessaires pour aller chercher la ressource. {{warning("Cette propriété n'est pas disponible dans les Web Workers.")}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - <em>navObject</em> = <em>performance</em>.navigation; -</pre> +```js + navObject = performance.navigation; +``` -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<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('Navigation Timing', '#sec-window.performance-attribute', 'Performance.navigation')}}</td> - <td>{{Spec2('Navigation Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | -------------------- | +| {{SpecName('Navigation Timing', '#sec-window.performance-attribute', 'Performance.navigation')}} | {{Spec2('Navigation Timing')}} | Définition initiale. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.navigation")}}</p> +{{Compat("api.Performance.navigation")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>L'interface {{domxref("Performance")}} à laquelle il appartient.</li> -</ul> +- L'interface {{domxref("Performance")}} à laquelle il appartient. diff --git a/files/fr/web/api/performance/now/index.md b/files/fr/web/api/performance/now/index.md index 0505c4a6cd..86f039c2ca 100644 --- a/files/fr/web/api/performance/now/index.md +++ b/files/fr/web/api/performance/now/index.md @@ -10,49 +10,48 @@ tags: - Reference translation_of: Web/API/Performance/now --- -<p>{{APIRef("High Resolution Timing")}}</p> +{{APIRef("High Resolution Timing")}} -<p>La méthode <code><strong>Performance.now()</strong></code> retourne une valeur de type {{domxref("DOMHighResTimeStamp")}}, mesurée en millisecondes et avec une précision de 5 millièmes de milliseconde (5 microsecondes).</p> +La méthode **`Performance.now()`** retourne une valeur de type {{domxref("DOMHighResTimeStamp")}}, mesurée en millisecondes et avec une précision de 5 millièmes de milliseconde (5 microsecondes). -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<p>La valeur retournée représente le temps écoulé depuis le <a href="/fr/docs/Web/API/DOMHighResTimeStamp#the_time_origin">temps d'origine</a>.</p> +La valeur retournée représente le temps écoulé depuis le [temps d'origine](/fr/docs/Web/API/DOMHighResTimeStamp#the_time_origin). -<p>Attention à garder à l'esprit les points suivants :</p> +Attention à garder à l'esprit les points suivants : -<ul> - <li>Dans les workers dédiés créés à partir d'un contexte {{domxref("Window")}}, la valeur dans le worker sera inférieure à celle obtenue par <code>performance.now()</code> exécuté dans la fenêtre ayant créé le worker. La fenêtre et le worker partageaient avant le même temps de référence <code>t0</code> à partir du contexte principal, mais cela a été changé.</li> - <li>Dans les workers partagés ou service sorkers, la valeur dans le worker peut être supérieure à celle du contexte principal, car la fenêtre pourra avoir été créée après ces workers.</li> -</ul> +- Dans les workers dédiés créés à partir d'un contexte {{domxref("Window")}}, la valeur dans le worker sera inférieure à celle obtenue par `performance.now()` exécuté dans la fenêtre ayant créé le worker. La fenêtre et le worker partageaient avant le même temps de référence `t0` à partir du contexte principal, mais cela a été changé. +- Dans les workers partagés ou service sorkers, la valeur dans le worker peut être supérieure à celle du contexte principal, car la fenêtre pourra avoir été créée après ces workers. -<p>Il est important de garder à l'esprit que pour atténuer les menaces de sécurité potentielles telles que <a href="https://spectreattack.com/">Spectre</a>, les navigateurs arrondissent généralement la valeur retournée d'une certaine quantité afin d'être moins prévisible. Cela introduit intrinsèquement un degré d'imprécision en limitant la résolution ou la précision de la minuterie. Par exemple, Firefox arrondit le temps renvoyé à des incréments de 1 milliseconde.</p> +Il est important de garder à l'esprit que pour atténuer les menaces de sécurité potentielles telles que [Spectre](https://spectreattack.com/), les navigateurs arrondissent généralement la valeur retournée d'une certaine quantité afin d'être moins prévisible. Cela introduit intrinsèquement un degré d'imprécision en limitant la résolution ou la précision de la minuterie. Par exemple, Firefox arrondit le temps renvoyé à des incréments de 1 milliseconde. -<p>La précision de la valeur retournée est susceptible de changer si/quand les problèmes de sécurité sont atténués par d'autres moyens.</p> +La précision de la valeur retournée est susceptible de changer si/quand les problèmes de sécurité sont atténués par d'autres moyens. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js t = performance.now(); -</pre> +``` -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js"> +```js var t0 = performance.now(); doSomething(); var t1 = performance.now(); console.log("L'appel de doSomething a demandé " + (t1 - t0) + " millisecondes.") -</pre> +``` -<p>Contrairement aux autres données de temps disponibles en JavaScript (par exemple <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date/now"><code>Date.now</code></a>), les horodatages retournés par <code>Performance.now()</code> ne sont pas limités à une précision d'une milliseconde. Au contraire, ils représentent les temps comme des nombres flottants avec une précision pouvant aller jusqu'à une microseconde.</p> +Contrairement aux autres données de temps disponibles en JavaScript (par exemple [`Date.now`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date/now)), les horodatages retournés par `Performance.now()` ne sont pas limités à une précision d'une milliseconde. Au contraire, ils représentent les temps comme des nombres flottants avec une précision pouvant aller jusqu'à une microseconde. -<p>Également contrairement à <code>Date.now()</code>, les valeurs retournées par <code>Performance.now() </code>sont toujours incrémentées à un taux constant, indépendant de l'horloge du système (qui peut être ajustée manuellement ou par l'intermédiaire d'un logiciel comme NTP). Sinon, <code>performance.timing.navigationStart + performance.now()</code> serait approximativement égal à <code>Date.now().</code></p> +Également contrairement à `Date.now()`, les valeurs retournées par `Performance.now() `sont toujours incrémentées à un taux constant, indépendant de l'horloge du système (qui peut être ajustée manuellement ou par l'intermédiaire d'un logiciel comme NTP). Sinon, `performance.timing.navigationStart + performance.now()` serait approximativement égal à `Date.now().` -<h2 id="Reduced_time_precision">Précision réduite du temps</h2> +## Précision réduite du temps -<p>Pour offrir une protection contre les attaques de temporisation et les empreintes digitales, la précision de <code>performance.now()</code> peut être arrondie en fonction des paramètres du navigateur. Dans Firefox, la préférence <code>privacy.reduceTimerPrecision</code> est activée par défaut et prend la valeur 1ms par défaut.</p> +Pour offrir une protection contre les attaques de temporisation et les empreintes digitales, la précision de `performance.now()` peut être arrondie en fonction des paramètres du navigateur. Dans Firefox, la préférence `privacy.reduceTimerPrecision` est activée par défaut et prend la valeur 1ms par défaut. -<pre class="brush: js">// précision temporelle réduite (1ms) dans Firefox 60 +```js +// précision temporelle réduite (1ms) dans Firefox 60 performance.now(); // 8781416 // 8781815 @@ -65,47 +64,30 @@ performance.now(); // 8866200 // 8866700 // ... -</pre> - -<p>Dans Firefox, vous pouvez également activer <code>privacy.resistFingerprinting</code> - cela change la précision à 100ms ou à la valeur de <code>privacy.resistFingerprinting.reduceTimerPrecision.microseconds</code> en fonction de la plus grande des deux.</p> - -<p>À partir de Firefox 79, les minuteurs haute résolution peuvent être utilisés si vous isolez votre document en utilisant les en-têtes {{HTTPHeader("Cross-Origin-Opener-Policy")}} et {{HTTPHeader("Cross-Origin-Embedder-Policy")}} :</p> - -<pre class="brush: plain">Cross-Origin-Opener-Policy: same-origin -Cross-Origin-Embedder-Policy: require-corp</pre> - -<p>Ces en-têtes garantissent qu'un document de premier niveau ne partage pas un groupe de contexte de navigation avec des documents d'origine croisée. Le processus COOP isole votre document et les attaquants potentiels ne peuvent pas accéder à votre objet global s'ils l'ouvrent dans une fenêtre contextuelle, ce qui permet d'éviter un ensemble d'attaques d'origine croisée appelées <a href="https://github.com/xsleaks/xsleaks">XS-Leaks</a>.</p> - -<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('Highres Time Level 2', '#dom-performance-now', 'performance.now()')}}</td> - <td>{{Spec2('Highres Time Level 2')}}</td> - <td>Définitions plus strictes des interfaces et des types.</td> - </tr> - <tr> - <td>{{SpecName('Highres Time', '#dom-performance-now', 'Performance.now()')}}</td> - <td>{{Spec2('Highres Time')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Performance.now")}}</p> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li><a href="http://updates.html5rocks.com/2012/08/When-milliseconds-are-not-enough-performance-now">Quand les millisecondes ne suffisent pas : performance.now() <small>(en)</small></a> de HTML5 Rocks.</li> -</ul> +``` + +Dans Firefox, vous pouvez également activer `privacy.resistFingerprinting` - cela change la précision à 100ms ou à la valeur de `privacy.resistFingerprinting.reduceTimerPrecision.microseconds` en fonction de la plus grande des deux. + +À partir de Firefox 79, les minuteurs haute résolution peuvent être utilisés si vous isolez votre document en utilisant les en-têtes {{HTTPHeader("Cross-Origin-Opener-Policy")}} et {{HTTPHeader("Cross-Origin-Embedder-Policy")}} : + +```plain +Cross-Origin-Opener-Policy: same-origin +Cross-Origin-Embedder-Policy: require-corp +``` + +Ces en-têtes garantissent qu'un document de premier niveau ne partage pas un groupe de contexte de navigation avec des documents d'origine croisée. Le processus COOP isole votre document et les attaquants potentiels ne peuvent pas accéder à votre objet global s'ils l'ouvrent dans une fenêtre contextuelle, ce qui permet d'éviter un ensemble d'attaques d'origine croisée appelées [XS-Leaks](https://github.com/xsleaks/xsleaks). + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | ------------------------------------------------------ | +| {{SpecName('Highres Time Level 2', '#dom-performance-now', 'performance.now()')}} | {{Spec2('Highres Time Level 2')}} | Définitions plus strictes des interfaces et des types. | +| {{SpecName('Highres Time', '#dom-performance-now', 'Performance.now()')}} | {{Spec2('Highres Time')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Performance.now")}} + +## Voir aussi + +- [Quand les millisecondes ne suffisent pas : performance.now() (en)](http://updates.html5rocks.com/2012/08/When-milliseconds-are-not-enough-performance-now) de HTML5 Rocks. diff --git a/files/fr/web/api/performance/onresourcetimingbufferfull/index.md b/files/fr/web/api/performance/onresourcetimingbufferfull/index.md index c45a75f39a..d904faab49 100644 --- a/files/fr/web/api/performance/onresourcetimingbufferfull/index.md +++ b/files/fr/web/api/performance/onresourcetimingbufferfull/index.md @@ -2,37 +2,36 @@ title: performance.onresourcetimingbufferfull slug: Web/API/Performance/onresourcetimingbufferfull tags: -- API -- Method -- Méthode -- Reference -- Performance web + - API + - Method + - Méthode + - Reference + - Performance web translation_of: Web/API/Performance/onresourcetimingbufferfull --- -<div>{{APIRef("Resource Timing API")}}</div> +{{APIRef("Resource Timing API")}} -<p>La propriété <strong><code>onresourcetimingbufferfull</code></strong> est un gestionnaire d'événements qui sera appelé lorsque l'événement <a href="/fr/docs/Web/API/Performance/resourcetimingbufferfull_event"><code>resourcetimingbufferfull</code></a> est déclenché. Ce déclenchement a lieu lorsque le tampon de performance de synchronisation des ressources du navigateur est plein.</p> +La propriété **`onresourcetimingbufferfull`** est un gestionnaire d'événements qui sera appelé lorsque l'événement [`resourcetimingbufferfull`](/fr/docs/Web/API/Performance/resourcetimingbufferfull_event) est déclenché. Ce déclenchement a lieu lorsque le tampon de performance de synchronisation des ressources du navigateur est plein. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js callback = performance.onresourcetimingbufferfull = buffer_full_cb; -</pre> +``` -<h3 id="Return_Value">Valeur de retour</h3> +### Valeur de retour -<dl> - <dt><code>callback</code></dt> - <dd>Un {{event("Event_handlers", "event handler")}} qui est invoqué lorsque l'événement <a href="/fr/docs/Web/API/Performance/resourcetimingbufferfull_event"><code>resourcetimingbufferfull</code></a> est déclenché.</dd> -</dl> +- `callback` + - : Un {{event("Event_handlers", "event handler")}} qui est invoqué lorsque l'événement [`resourcetimingbufferfull`](/fr/docs/Web/API/Performance/resourcetimingbufferfull_event) est déclenché. -<h2 id="Example">Exemple</h2> +## Exemple -<p>L'exemple suivant définit une fonction de rappel sur la propriété <code>onresourcetimingbufferfull</code>.</p> +L'exemple suivant définit une fonction de rappel sur la propriété `onresourcetimingbufferfull`. -<pre class="brush: js">function buffer_full(event) { +```js +function buffer_full(event) { console.log("WARNING: Resource Timing Buffer is FULL!"); performance.setResourceTimingBufferSize(200); } @@ -40,39 +39,21 @@ function init() { // Définit un rappel si le tampon de ressources est rempli. performance.onresourcetimingbufferfull = buffer_full; } -</pre> +``` -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<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', '#dom-performance-onresourcetimingbufferfull', - 'onresourcetimingbufferfull')}}</td> - <td>{{Spec2('Resource Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | -------------------- | +| {{SpecName('Resource Timing', '#dom-performance-onresourcetimingbufferfull', + 'onresourcetimingbufferfull')}} | {{Spec2('Resource Timing')}} | Définition initiale. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.onresourcetimingbufferfull")}}</p> +{{Compat("api.Performance.onresourcetimingbufferfull")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>Événément <a href="/fr/docs/Web/API/Performance/resourcetimingbufferfull_event"><code>resourcetimingbufferfull</code></a></li> - <li>{{domxref("Performance.clearResourceTimings","Performance.clearResourceTimings()")}} - </li> - <li> - {{domxref("Performance.setResourceTimingBufferSize","Performance.setResourceTimingBufferSize()")}} - </li> -</ul> +- Événément [`resourcetimingbufferfull`](/fr/docs/Web/API/Performance/resourcetimingbufferfull_event) +- {{domxref("Performance.clearResourceTimings","Performance.clearResourceTimings()")}} +- {{domxref("Performance.setResourceTimingBufferSize","Performance.setResourceTimingBufferSize()")}} diff --git a/files/fr/web/api/performance/resourcetimingbufferfull_event/index.md b/files/fr/web/api/performance/resourcetimingbufferfull_event/index.md index d23ab10aaf..e8d0020053 100644 --- a/files/fr/web/api/performance/resourcetimingbufferfull_event/index.md +++ b/files/fr/web/api/performance/resourcetimingbufferfull_event/index.md @@ -11,36 +11,41 @@ tags: - onresourcetimingbufferfull translation_of: Web/API/Performance/resourcetimingbufferfull_event --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>L'événement <code>resourcetimingbufferfull</code> se déclenche lorsque la mémoire <a href="/fr/docs/Web/API/Performance/setResourceTimingBufferSize">tampon de synchronisation des ressources</a> du navigateur est pleine.</p> +L'événement `resourcetimingbufferfull` se déclenche lorsque la mémoire [tampon de synchronisation des ressources](/fr/docs/Web/API/Performance/setResourceTimingBufferSize) du navigateur est pleine. <table class="properties"> - <tbody> - <tr> - <th scope="row">Propagation</th> - <td>Oui</td> - </tr> - <tr> - <th scope="row">Annulable</th> - <td>Oui</td> - </tr> - <tr> - <th scope="row">Interface</th> - <td>{{domxref("Event")}}</td> - </tr> - <tr> - <th scope="row">Propriété pour le gestionnaire d'événements correspondant</th> - <td>{{domxref("Performance.onresourcetimingbufferfull", "onresourcetimingbufferfull")}}</td> - </tr> - </tbody> + <tbody> + <tr> + <th scope="row">Propagation</th> + <td>Oui</td> + </tr> + <tr> + <th scope="row">Annulable</th> + <td>Oui</td> + </tr> + <tr> + <th scope="row">Interface</th> + <td>{{domxref("Event")}}</td> + </tr> + <tr> + <th scope="row"> + Propriété pour le gestionnaire d'événements correspondant + </th> + <td> + {{domxref("Performance.onresourcetimingbufferfull", "onresourcetimingbufferfull")}} + </td> + </tr> + </tbody> </table> -<h2 id="Examples">Exemples</h2> +## Exemples -<p>L'exemple suivant définit une fonction de rappel sur la propriété <code>onresourcetimingbufferfull</code>.</p> +L'exemple suivant définit une fonction de rappel sur la propriété `onresourcetimingbufferfull`. -<pre class="brush: js">function buffer_full(event) { +```js +function buffer_full(event) { console.log("AVERTISSEMENT : La mémoire tampon des ressources est COMPLÈTE !"); performance.setResourceTimingBufferSize(200); } @@ -48,39 +53,26 @@ function init() { // Définit un rappel si le tampon de ressources est rempli. performance.onresourcetimingbufferfull = buffer_full; } -<body onload="init()"></pre> +<body onload="init()"> +``` -<p>Notez que vous pouvez également configurer le gestionnaire à l'aide de la fonction addEventListener() :</p> +Notez que vous pouvez également configurer le gestionnaire à l'aide de la fonction addEventListener() : -<pre class="brush: js">performance.addEventListener('resourcetimingbufferfull', buffer_full); -</pre> +```js +performance.addEventListener('resourcetimingbufferfull', buffer_full); +``` -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<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', '#dom-performance-onresourcetimingbufferfull', 'onresourcetimingbufferfull')}}</td> - <td>{{Spec2('Resource Timing')}}</td> - <td>Définition initialen.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | --------------------- | +| {{SpecName('Resource Timing', '#dom-performance-onresourcetimingbufferfull', 'onresourcetimingbufferfull')}} | {{Spec2('Resource Timing')}} | Définition initialen. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.resourcetimingbufferfull_event")}}</p> +{{Compat("api.Performance.resourcetimingbufferfull_event")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Performance.clearResourceTimings","Performance.clearResourceTimings()")}}</li> - <li>{{domxref("Performance.setResourceTimingBufferSize","Performance.setResourceTimingBufferSize()")}}</li> -</ul> +- {{domxref("Performance.clearResourceTimings","Performance.clearResourceTimings()")}} +- {{domxref("Performance.setResourceTimingBufferSize","Performance.setResourceTimingBufferSize()")}} diff --git a/files/fr/web/api/performance/setresourcetimingbuffersize/index.md b/files/fr/web/api/performance/setresourcetimingbuffersize/index.md index ba6d23eebe..0b614c909e 100644 --- a/files/fr/web/api/performance/setresourcetimingbuffersize/index.md +++ b/files/fr/web/api/performance/setresourcetimingbuffersize/index.md @@ -2,41 +2,40 @@ title: performance.setResourceTimingBufferSize() slug: Web/API/Performance/setResourceTimingBufferSize tags: -- API -- Method -- Méthode -- Reference -- Performance web + - API + - Method + - Méthode + - Reference + - Performance web translation_of: Web/API/Performance/setResourceTimingBufferSize --- -<div>{{APIRef("Resource Timing API")}}</div> +{{APIRef("Resource Timing API")}} -<p>La méthode <strong><code>setResourceTimingBufferSize()</code></strong> définit la taille du tampon mémoire du navigateur dans lequel sont stockés les objets de mesures de performance de type <code>"resource"</code> (voir {{domxref("PerformanceEntry.entryType", "entryType")}}).</p> +La méthode **`setResourceTimingBufferSize()`** définit la taille du tampon mémoire du navigateur dans lequel sont stockés les objets de mesures de performance de type `"resource"` (voir {{domxref("PerformanceEntry.entryType", "entryType")}}). -<p>La taille recommandée du tampon de synchronisation des ressources d'un navigateur est au moins 150 objets <code>{{domxref("PerformanceEntry")}}</code>.</p> +La taille recommandée du tampon de synchronisation des ressources d'un navigateur est au moins 150 objets `{{domxref("PerformanceEntry")}}`. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - <em>performance</em>.setResourceTimingBufferSize(maxSize); -</pre> +```js + performance.setResourceTimingBufferSize(maxSize); +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt><code>maxSize</code></dt> - <dd>Un nombre (cf. {{jsxref("Number")}}) représentant le nombre maximal d'objets {{domxref("PerformanceEntry", "d'entrée de performance","",1)}} avec le type <code>"resource"</code> que le navigateur doit contenir dans le tampon correspondant.</dd> -</dl> +- `maxSize` + - : Un nombre (cf. {{jsxref("Number")}}) représentant le nombre maximal d'objets {{domxref("PerformanceEntry", "d'entrée de performance","",1)}} avec le type `"resource"` que le navigateur doit contenir dans le tampon correspondant. -<h3 id="Return_Value">Valeur de retour</h3> +### Valeur de retour -<p>Aucune.</p> +Aucune. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">function setResourceTimingBufferSize(maxSize) { +```js +function setResourceTimingBufferSize(maxSize) { if (performance === undefined) { log("Le navigateur ne prend pas en charge les performances Web"); return; @@ -49,28 +48,15 @@ translation_of: Web/API/Performance/setResourceTimingBufferSize log("... Performance.setResourceTimingBufferSize() = NON pris en charge"); } } -</pre> +``` -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<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', '#dom-performance-setresourcetimingbuffersize', - 'setResourceTimingBufferSize()')}}</td> - <td>{{Spec2('Resource Timing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- | +| {{SpecName('Resource Timing', '#dom-performance-setresourcetimingbuffersize', + 'setResourceTimingBufferSize()')}} | {{Spec2('Resource Timing')}} | Définition initiale. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.setResourceTimingBufferSize")}}</p> +{{Compat("api.Performance.setResourceTimingBufferSize")}} diff --git a/files/fr/web/api/performance/timeorigin/index.md b/files/fr/web/api/performance/timeorigin/index.md index 014045da71..da7458aa3d 100644 --- a/files/fr/web/api/performance/timeorigin/index.md +++ b/files/fr/web/api/performance/timeorigin/index.md @@ -12,39 +12,28 @@ tags: - timeOrigin translation_of: Web/API/Performance/getEntriesByName --- -<p>{{SeeCompatTable}}{{APIRef("High Resolution Time")}}</p> +{{SeeCompatTable}}{{APIRef("High Resolution Time")}} -<p>La propriété en lecture seule <strong><code>timeOrigin</code></strong> de l'interface {{domxref("Performance")}} renvoie l'horodatage haute résolution de l'heure de début de la mesure de performance.</p> +La propriété en lecture seule **`timeOrigin`** de l'interface {{domxref("Performance")}} renvoie l'horodatage haute résolution de l'heure de début de la mesure de performance. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js var timeOrigin = performance.timeOrigin -</pre> +``` -<h3 id="Value">Valeur</h3> +### Valeur -<p>Un horodatage haute résolution (voir le type <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>DOMHighResTimeStamp</code></a>).</p> +Un horodatage haute résolution (voir le type [`DOMHighResTimeStamp`](/fr/docs/Web/API/DOMHighResTimeStamp)). -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Highres Time Level 2','#timeorigin-attribute','timeOrigin')}}</td> - <td>{{Spec2('Highres Time Level 2')}}</td> - </tr> - </tbody> -</table> +| Spécification | Statut | +| ------------------------------------------------------------------------------------------------ | -------------------------------------------- | +| {{SpecName('Highres Time Level 2','#timeorigin-attribute','timeOrigin')}} | {{Spec2('Highres Time Level 2')}} | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.timeOrigin")}}</p> +{{Compat("api.Performance.timeOrigin")}} diff --git a/files/fr/web/api/performance/timing/index.md b/files/fr/web/api/performance/timing/index.md index 583aecd811..2b305436e6 100644 --- a/files/fr/web/api/performance/timing/index.md +++ b/files/fr/web/api/performance/timing/index.md @@ -14,47 +14,30 @@ tags: - Reference translation_of: Web/API/Performance/timing --- -<p>{{deprecated_header}}{{APIRef("Navigation Timing")}}</p> +{{deprecated_header}}{{APIRef("Navigation Timing")}} -<div class="warning"> - <p><strong>Attention :</strong> Cette propriété est dépréciée dans la spécification <a href="https://w3c.github.io/navigation-timing/#obsolete">Navigation Timing Level 2</a>. Veuillez utiliser l'interface {{domxref("PerformanceNavigationTiming")}} à la place.</p> -</div> +> **Attention :** Cette propriété est dépréciée dans la spécification [Navigation Timing Level 2](https://w3c.github.io/navigation-timing/#obsolete). Veuillez utiliser l'interface {{domxref("PerformanceNavigationTiming")}} à la place. -<p>L'ancienne propriété <strong><code>Performance.timing</code></strong> renvoie un objet {{domxref("PerformanceTiming")}} en lecture seule contenant des informations de performance liées à la latence.</p> +L'ancienne propriété **`Performance.timing`** renvoie un objet {{domxref("PerformanceTiming")}} en lecture seule contenant des informations de performance liées à la latence. {{warning("Cette propriété n'est pas disponible dans les Web Workers.")}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> - <var>timingInfo</var> = performance.timing; -</pre> +```js + timingInfo = performance.timing; +``` -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<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('Navigation Timing Level 2', '#obsolete')}}</td> - <td>{{Spec2('Navigation Timing Level 2')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------ | ---------------------------------------------------- | -------------------- | +| {{SpecName('Navigation Timing Level 2', '#obsolete')}} | {{Spec2('Navigation Timing Level 2')}} | Définition initiale. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.timing")}}</p> +{{Compat("api.Performance.timing")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>L'interface {{domxref("Performance")}} à laquelle il appartient.</li> -</ul> +- L'interface {{domxref("Performance")}} à laquelle il appartient. diff --git a/files/fr/web/api/performance/tojson/index.md b/files/fr/web/api/performance/tojson/index.md index 3136d2d867..1027c9cbe0 100644 --- a/files/fr/web/api/performance/tojson/index.md +++ b/files/fr/web/api/performance/tojson/index.md @@ -9,56 +9,42 @@ tags: - Référence translation_of: Web/API/Performance/toJSON --- -<div>{{APIRef("High Resolution Timing")}}</div> +{{APIRef("High Resolution Timing")}} -<p>La méthode <strong><code>toJSON()</code></strong> de l'interface {{domxref("Performance")}} est un sérialiseur standard : elle renvoie une représentation JSON des propriétés de l'objet performance.</p> +La méthode **`toJSON()`** de l'interface {{domxref("Performance")}} est un sérialiseur standard : elle renvoie une représentation JSON des propriétés de l'objet performance. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js myPerf = performance.toJSON() -</pre> +``` -<h3 id="Arguments">Arguments</h3> +### Arguments -<p>Aucun</p> +Aucun -<h3 id="Return_value">Valeur de retour</h3> +### Valeur de retour -<dl> - <dt><code>myPerf</code></dt> - <dd>Un objet JSON qui est la sérialisation de l'objet {{domxref("Performance")}}.</dd> -</dl> +- `myPerf` + - : Un objet JSON qui est la sérialisation de l'objet {{domxref("Performance")}}. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var js; +```js +var js; js = window.performance.toJSON(); console.log("json = " + JSON.stringify(js)); -</pre> +``` -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<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('Highres Time Level 2', '#dom-performance-tojson', 'toJSON() - serializer')}}</td> - <td>{{Spec2('Highres Time Level 2')}}</td> - <td>Définition de <code>toJson()</code>.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------------- | +| {{SpecName('Highres Time Level 2', '#dom-performance-tojson', 'toJSON() + serializer')}} | {{Spec2('Highres Time Level 2')}} | Définition de `toJson()`. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Performance.toJSON")}}</p> +{{Compat("api.Performance.toJSON")}} |