Performance

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨septembre 2015⁩.

* Some parts of this feature may have varying levels of support.

L'interfacePerformance 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 APIsPerformance Timeline,Navigation Timing,User Timing, etResource Timing.

Un objet de ce type peut être obtenu en appelant l'attribut en lecture seulewindow.performance.

Note :Cette interface et ses attributs sont accessibles auxWeb Workers viaWorkerGlobalScope.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'interfacePerformance n'hérite d'aucune propriété.

performance.navigationLecture seuleObsolète: PerformanceNavigation est un objet qui fournit des informations contextuelles sur les opérations incluses dans les indicateurs detiming, 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.
performance.timingLecture seuleObsolète: PerformanceTiming est un objet contenant des informations de performance liées à la latence.
Note :Indisponible dans les Web Workers.
performance.memoryLecture seuleNon standard: Une extensionnon standard ajoutée dans Chrome, cette propriété fournit à un objet des informations de base sur l'utilisation de la mémoire.Vousne devriez pas utiliser cette API non standard.
Performance.timeOriginLecture seuleExpérimental: Fournit un horodatage haute résolution de l'heure de début de la mesure de performance.

Méthodes

L'interfacePerformance n'hérite d'aucune méthode.

performance.clearMarks(): Supprime lemarqueur indiqué des données de performances du navigateur mises en mémoire tampon.
performance.clearMeasures(): Supprime lamesure indiquée des données de performances du navigateur mises en mémoire tampon.
performance.clearResourceTimings(): Supprime toutes lesentrées de performance avec unentryType "resource" des données de performances du navigateur mises en mémoire tampon.
performance.getEntries(): Retourne une liste d'objetsPerformanceEntry basée sur lefiltre indiqué.
performance.getEntriesByName(): Retourne une liste d'objetsPerformanceEntry basée sur lenom indiqué.
performance.getEntriesByType(): Retourne une liste d'objetsPerformanceEntry basée sur letype indiqué.
performance.mark(): Crée untimestamp avec le nom indiqué, dans la mémoire tampon du navigateur dédiée aux performances.
performance.measure(): Crée untimestamp nommé, dans la mémoire tampon du navigateur dédiée aux performances, entre deux marqueurs spécifiques (connus comme lemarqueur de début et lemarqueur de fin, respectivement).
Performance.now(): Retourne un objetDOMHighResTimeStamp représentant le nombre de millisecondes écoulées depuis un instant donné.
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'objetsPerformanceEntry ayant letype "resource" qu'il sera possible d'y stocker.
Performance.toJSON(): Retourne un objet JSON représentant l'objetPerformance.

Événements

On pourra écouter ces événements en utilisantaddEventListener() ou en assignant un gestionnaire d'événement à la propriétéon<EventName> de cette interface.

resourcetimingbufferfull: Déclenché lorsque letampon de synchronisation des ressources du navigateur est plein. Également disponible via la propriétéonresourcetimingbufferfull.

Spécifications

Specification
High Resolution Time # sec-performance
Performance Timeline # extensions-to-the-performance-interface
Resource Timing # sec-extensions-performance-interface
User Timing # extensions-performance-interface