PerformanceEntry: name-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die schreibgeschützte name
-Eigenschaft des PerformanceEntry
-Interfaces ist ein String, der den Namen für einen Performance-Eintrag darstellt. Er dient als Bezeichner, muss jedoch nicht einzigartig sein. Der Wert hängt von der Unterklasse ab.
Wert
Ein String. Der Wert hängt von der Unterklasse des PerformanceEntry
-Objekts ab, wie in der Tabelle unten gezeigt.
Unterklasse | Wert |
---|---|
[`LargestContentfulPaint`](/de/docs/Web/API/LargestContentfulPaint) | Liefert immer einen leeren String zurück. |
[`LayoutShift`](/de/docs/Web/API/LayoutShift) | Liefert immer "layout-shift" zurück. |
[`PerformanceElementTiming`](/de/docs/Web/API/PerformanceElementTiming) | Einer der folgenden Strings:
|
[`PerformanceEventTiming`](/de/docs/Web/API/PerformanceEventTiming) | Der Typ des zugehörigen Ereignisses. |
[`PerformanceLongTaskTiming`](/de/docs/Web/API/PerformanceLongTaskTiming) | Einer der folgenden Strings:
|
[`PerformanceMark`](/de/docs/Web/API/PerformanceMark) | Der Name, der verwendet wurde, als die Markierung durch den Aufruf von [`performance.mark()`](/de/docs/Web/API/Performance/mark) erstellt wurde. |
[`PerformanceMeasure`](/de/docs/Web/API/PerformanceMeasure) | Der Name, der verwendet wurde, als die Messung durch den Aufruf von [`performance.measure()`](/de/docs/Web/API/Performance/measure) erstellt wurde. |
[`PerformanceNavigationTiming`](/de/docs/Web/API/PerformanceNavigationTiming) | Die aufgelöste URL der angeforderten Ressource. Beachten Sie, dass dies alle Textfragmente oder andere Fragmentanweisungen ausschließt. Der Wert ändert sich nicht, selbst wenn die Anfrage umgeleitet wird. |
[`PerformancePaintTiming`](/de/docs/Web/API/PerformancePaintTiming) | Einer der folgenden Strings:
|
[`PerformanceResourceTiming`](/de/docs/Web/API/PerformanceResourceTiming) | Die aufgelöste URL der angeforderten Ressource. Dieser Wert ändert sich nicht, selbst wenn die Anfrage umgeleitet wird. |
[`TaskAttributionTiming`](/de/docs/Web/API/TaskAttributionTiming) | Liefert immer "unknown" zurück. |
[`VisibilityStateEntry`](/de/docs/Web/API/VisibilityStateEntry) | Einer der folgenden Strings:
|
Beispiele
Filtern von Performance-Einträgen nach Name
Wenn das PerformanceEntry
-Objekt ein PerformanceResourceTiming
-Objekt ist, bezieht sich die name
-Eigenschaft auf die aufgelöste URL der angeforderten Ressource.
In diesem Fall kann die name
-Eigenschaft nützlich sein, um bestimmte Ressourcen herauszufiltern, beispielsweise alle SVG-Bilder.
// Log durations of SVG resources
performance.getEntriesByType("resource").forEach((entry) => {
if (entry.name.endsWith(".svg")) {
console.log(`${entry.name}'s duration: ${entry.duration}`);
}
});
Abrufen von Performance-Einträgen nach Name
Sowohl Performance
als auch PerformanceObserver
bieten Methoden, die es ermöglichen, Performance-Einträge direkt nach Name abzurufen. Sie benötigen dafür nicht unbedingt die name
-Eigenschaft, stattdessen können Sie Performance.getEntriesByName()
oder PerformanceObserverEntryList.getEntriesByName()
verwenden.
// Log all marks named "debug-marks" at this point in time
const debugMarks = performance.getEntriesByName("debug-mark", "mark");
debugMarks.forEach((entry) => {
console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});
// PerformanceObserver version
// Log all marks named "debug-marks" when they happen
function perfObserver(list, observer) {
list.getEntriesByName("debug-mark", "mark").forEach((entry) => {
console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});
}
const observer = new PerformanceObserver(perfObserver);
observer.observe({ entryTypes: ["measure", "mark"] });
Spezifikationen
Specification |
---|
Performance Timeline # dom-performanceentry-name |
Browser-Kompatibilität
BCD tables only load in the browser