CKTIS / JavaScript
Performance.getEntriesByName — Einträge nach Namen abrufen
Performance.getEntriesByName ruft aktuelle Einträge der Performance-Timeline mit einem bestimmten Namen und optional einem Typ ab. Die Methode gibt ein Array statt eines einzelnen Eintrags zurück und verfolgt keine zukünftigen Ereignisse.
Version: 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 ist eine Web-API-Methode und wird als performance.getEntriesByName(name, type) aufgerufen. Der erforderliche Parameter name gibt den Eintragsnamen an; der optionale Parameter type, etwa "mark", schränkt das Ergebnis ein. Wird er weggelassen, wird nur nach dem Namen gefiltert. Die Methode gehört nicht zu ECMAScript selbst.
Das Ergebnis ist ein Array von PerformanceEntry-Objekten, aufsteigend nach startTime sortiert. Mehrere Einträge können denselben Namen haben; ohne Treffer wird [] zurückgegeben. Die Methode liest die zum Aufrufzeitpunkt vorhandenen Einträge aus, statt spätere Einträge zu abonnieren. Für Benachrichtigungen eignet sich PerformanceObserver.
Nicht jeder Eintragstyp ist über diese Methode zugänglich: Typen wie "element", "event", "largest-contentful-paint", "layout-shift" und "longtask" erfordern PerformanceObserver. MDN kennzeichnet die Methode seit September 2017 als breit in Browsern verfügbar; sie ist auch in Web Workers verfügbar. Dass ein Repository Node 24 enthält, belegt keine Browserunterstützung.
Das Beispiel erstellt zwei Markierungen mit demselben Namen und ruft sie mit dem Filter "mark" ab. Es gibt bewusst keine variablen Zeitstempel aus. Markierungen mit dem Beispielnamen werden vor der Ausführung und in finally entfernt; andere Namen bleiben unberührt.
Beispiele
(() => {
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);
}
})();Ergebnis
2 mark,mark true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.