CKTIS / JavaScript
Performance.getEntriesByName — items op naam ophalen
Performance.getEntriesByName haalt de huidige items op de prestatie-tijdlijn op met een opgegeven naam en eventueel een type. De methode retourneert een array in plaats van één item en volgt geen toekomstige gebeurtenissen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
performance.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName is een Web API-methode die je aanroept als performance.getEntriesByName(name, type). De verplichte parameter name geeft de naam van het item aan; de optionele parameter type, bijvoorbeeld "mark", beperkt het resultaat. Als je die weglaat, wordt alleen op naam gefilterd. Dit is geen functie van ECMAScript zelf.
Het resultaat is een array met PerformanceEntry-objecten, oplopend gesorteerd op startTime. Meerdere items kunnen dezelfde naam hebben; zonder overeenkomsten is het resultaat []. De methode leest de items die op het moment van aanroepen aanwezig zijn, in plaats van zich op latere items te abonneren. Gebruik PerformanceObserver voor meldingen.
Niet elk itemtype is via deze methode toegankelijk: typen zoals "element", "event", "largest-contentful-paint", "layout-shift" en "longtask" vereisen PerformanceObserver. MDN vermeldt dat de methode sinds september 2017 breed beschikbaar is in browsers; ze is ook beschikbaar in Web Workers. De aanwezigheid van Node 24 in een repository bewijst niet dat browsers de methode ondersteunen.
Het voorbeeld maakt twee markeringen met dezelfde naam en haalt ze op met het filter "mark". Het voorkomt bewust dat variabele tijdstempels worden afgedrukt. Markeringen met de demonstratienaam worden vóór de uitvoering en in finally gewist; andere namen blijven ongemoeid.
Voorbeelden
(() => {
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);
}
})();Resultaat
2 mark,mark true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.