console: Statische Methode timeStamp()
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die statische Methode console.timeStamp() fügt einer Leistungsaufzeichnung in Entwicklertools, die dies unterstützen, eine Markierung hinzu, beispielsweise im Chrome-Performance-Panel und im Firefox Profiler. So können Sie eine Stelle in Ihrem Code mit aufgezeichneten Ereignissen wie Layout und Painting in Beziehung setzen.
Syntax
console.timeStamp(label)
console.timeStamp(label, start, end, trackName, trackGroup, color, data)
Parameter
labelOptional-
Beschriftung für den Zeitstempel.
startOptional-
Ein String, der auf ein zuvor definiertes
timeStamp-Label verweist, oder ein Zeitstempel (DOMHighResTimeStamp), der als Startzeit verwendet wird. endOptional-
Ein String, der auf ein zuvor definiertes
timeStamp-Label verweist, oder ein Zeitstempel (DOMHighResTimeStamp), der als Endzeit verwendet wird. trackNameOptional-
Der Name des benutzerdefinierten Tracks, auf dem die Zeitstempeldaten angezeigt werden.
trackGroupOptional-
Die Gruppe des benutzerdefinierten Tracks, auf dem die Zeitstempeldaten angezeigt werden.
colorOptional-
Ein String für die Anzeigefarbe des Eintrags. Der Wert muss einer der folgenden sein:
"primary","primary-light","primary-dark","secondary","secondary-light","secondary-dark","tertiary","tertiary-light","tertiary-dark","error". dataOptional-
Ein Objekt mit zusätzlichen Daten für die Anzeige. Einige Browser wandeln URLs möglicherweise automatisch in Links um.
Rückgabewert
Keiner (undefined).
Beschreibung
Um die Markierung zu sehen, starten Sie eine Leistungsaufzeichnung, bevor der Aufruf erfolgt. Ob die Markierung aufgezeichnet und angezeigt wird, hängt vom Browser und dessen Profiling-Tool ab. Allein die Verwendung von console.timeStamp() garantiert keine sichtbare Markierung.
Diese Methode gibt keine verstrichene Zeit in der Konsole aus und erstellt keinen PerformanceEntry. Verwenden Sie console.time() und console.timeEnd() für Konsolen-Timer oder performance.mark() und performance.measure() für standardisierte Einträge, die Ihre Anwendung beobachten und auslesen kann.
Beispiele
Grundlegende Verwendung
console.timeStamp("marker 1");
Die Extensibility API für ausführlichere Anzeigedetails verwenden
// 1. Create a duration event with rich data
const start = performance.now() - 150;
const end = performance.now() - 20;
const durationData = {
processingTime: `${end - start}ms`,
info: "Check this URL: https://example.com for more.",
metrics: {
items: 5,
isCached: true,
},
};
console.timeStamp(
"My Timed Task", // label
start, // startTime
end, // endTime
"Tasks", // trackName
"My Extension", // trackGroup
"tertiary", // color
durationData, // data (object)
);
// 2. Create an instant event with a deep link for a DevTools extension
const linkData = {
url: "ext://resource/123",
description: "View Resource 123",
otherDetail: "This data also appears in the JSON viewer",
};
console.timeStamp(
"Event with Link", // label
performance.now(), // startTime (instant)
undefined, // endTime (instant)
"Tasks", // trackName
"My Extension", // trackGroup
"primary-light", // color
linkData, // data (object)
);