PerformanceEntry
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2017.
L'objet PerformanceEntry encapsule une seule mesure de performance qui fait partie de la chronologie de performance. Une entrée de performance peut être créée directement en faisant une marque ou une mesure (par exemple en appelant la méthode mark()) à un point explicite d'une application. Les entrées de performance sont également créées de manière indirecte, par exemple en chargeant une ressource (telle qu'une image).
Les instances PerformanceEntry auront toujours l'un des sous-types suivants :
PerformanceMarkPerformanceMeasurePerformanceFrameTimingPerformanceNavigationTimingPerformanceResourceTimingPerformancePaintTiming
Note : Cette fonctionnalité est disponible via les Web Workers.
Propriétés
PerformanceEntry.nameLecture seule-
Une valeur qui précise davantage la valeur renvoyée par la propriété
PerformanceEntry.entryType. La valeur des deux dépend du sous-type. Voir la page de la propriété pour les valeurs valides. PerformanceEntry.entryTypeLecture seule-
Une chaîne de caractère
DOMStringreprésentant le type de mesure de performance comme, par exemple, "mark". Voir la page des propriétés pour les valeurs valides. PerformanceEntry.startTimeLecture seule-
Un objet
DOMHighResTimeStampreprésentant l'heure de départ de la mesure de performance. PerformanceEntry.durationLecture seule-
Un objet
DOMHighResTimeStampreprésentant la valeur temporelle de la durée de l'événement de performance.
Méthodes
PerformanceEntry.toJSON()-
Renvoie une représentation JSON de l'objet
PerformanceEntry.
Exemple
L'exemple suivant vérifie toutes les propriétés PerformanceEntry pour voir si le navigateur les prend en charge et, le cas échéant, écrit leurs valeurs dans la console.
function print_PerformanceEntries() {
// Utilise getEntries() pour obtenir une liste de toutes les entrées de performance.
let p = performance.getEntries();
for (let i = 0; i < p.length; i++) {
console.log("PerformanceEntry[" + i + "]");
print_PerformanceEntry(p[i]);
}
}
function print_PerformanceEntry(perfEntry) {
let properties = ["name", "entryType", "startTime", "duration"];
for (let i = 0; i < properties.length; i++) {
// Vérifie chaque propriété
let supported = properties[i] in perfEntry;
if (supported) {
let value = perfEntry[properties[i]];
console.log("... " + properties[i] + " = " + value);
} else {
console.log("... " + properties[i] + " n'est PAS pris en charge");
}
}
}
Spécifications
| Specification |
|---|
| Performance Timeline # dom-performanceentry |
Compatibilité des navigateurs
Chargement…