console: Methode timeStamp() (statisch)
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 console.timeStamp()-Methode fügt ein einzelnes Markierungselement im Performance-Werkzeug des Browsers hinzu (Firefox-Bug 1387528, Chrome). Dies ermöglicht es Ihnen, einen Punkt in Ihrem Code mit anderen Ereignissen, die in der Zeitleiste aufgezeichnet wurden, wie Layout- und Paint-Ereignisse, zu korrelieren.
Sie können optional ein Argument übergeben, um den Zeitstempel zu beschriften; diese Beschriftung wird dann neben der Markierung angezeigt.
Einige Browser haben diese console.timeStamp()-Methode weiterentwickelt, um zusätzliche optionale Parameter zuzulassen, die als Teil ihrer Extensibility-API in Leistungsabläufen angezeigt werden. Weitere Informationen finden Sie in der Dokumentation zur Extensibility-API von Chrome.
Syntax
console.timeStamp(label);
console.timeStamp(label, start, end, trackName, trackGroup, color, data);
Parameter
colorOptional Experimentell-
Ein String für die Anzeigefarbe des Eintrags. Muss einer der folgenden Werte sein:
"primary","primary-light","primary-dark","secondary","secondary-light","secondary-dark","tertiary","tertiary-light","tertiary-dark","error". dataOptional Experimentell-
Ein Objekt mit zusätzlichen Daten zur Anzeige. URLs können von einigen Browsern automatisch in Links umgewandelt werden.
Hinweis:
Die Unterstützung des data-Parameters variiert je nach Browser und deren DevTools-Implementierungen. Beispielsweise können in einigen Versionen von Chrome diese Daten im Performance-Panel nicht erscheinen.
endOptional Experimentell-
Ein String, der auf ein zuvor definiertes
timeStamp-Label oder einen Zeitstempel (DOMHighResTimeStamp) verweist, der als Endzeit verwendet wird. labelOptional-
Beschriftung für den Zeitstempel.
startOptional Experimentell-
Ein String, der auf ein zuvor definiertes
timeStamp-Label oder einen Zeitstempel (DOMHighResTimeStamp) verweist, der als Startzeit verwendet wird. trackNameOptional Experimentell-
Der Name der benutzerdefinierten Spur, die zur Anzeige der Zeitstempeldaten verwendet wird.
trackGroupOptional Experimentell-
Die Gruppe der benutzerdefinierten Spur, die zur Anzeige der Zeitstempeldaten verwendet wird.
Rückgabewert
Keiner (undefined).
Beispiele
Grundlegende Verwendung
console.timeStamp("marker 1");
Verwendung der Extensibility-API zur Bereitstellung detaillierterer Anzeigeinformationen
// 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)
);