CKTIS / JavaScript
Performance.getEntriesByName — récupérer des entrées par nom
Performance.getEntriesByName récupère les entrées actuelles de la chronologie des performances portant un nom donné et, facultativement, un type donné. La méthode renvoie un tableau plutôt qu’une seule entrée et ne suit pas les événements futurs.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
performance.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName est une méthode de l’API Web qui s’appelle sous la forme performance.getEntriesByName(name, type). Le paramètre obligatoire name indique le nom de l’entrée ; le paramètre facultatif type, par exemple "mark", restreint le résultat. S’il est omis, le filtrage porte uniquement sur le nom. Cette méthode ne fait pas partie d’ECMAScript lui-même.
Le résultat est un tableau d’objets PerformanceEntry, triés par ordre croissant de startTime. Plusieurs entrées peuvent avoir le même nom ; si aucune ne correspond, le résultat est []. La méthode lit les entrées présentes au moment de l’appel, sans s’abonner aux entrées suivantes. Pour recevoir des notifications, utilisez PerformanceObserver.
Tous les types d’entrée ne sont pas accessibles par cette méthode : des types comme "element", "event", "largest-contentful-paint", "layout-shift" et "longtask" nécessitent PerformanceObserver. MDN indique que la méthode est largement disponible dans les navigateurs depuis septembre 2017 ; elle est également disponible dans les Web Workers. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.
L’exemple crée deux marques portant le même nom et les récupère avec le filtre "mark". Il évite volontairement d’afficher des horodatages variables. Il efface les marques portant le nom de démonstration avant l’exécution et dans finally, sans toucher aux autres noms.
Exemples
(() => {
const name = "cktis-getEntriesByName-demo";
performance.clearMarks(name);
try {
performance.mark(name);
performance.mark(name);
const entries = performance.getEntriesByName(name, "mark");
console.log(entries.length);
console.log(entries.map(entry => entry.entryType).join(","));
console.log(entries.every(entry => entry.name === name));
} finally {
performance.clearMarks(name);
}
})();Résultat
2 mark,mark true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.