CKTIS / JavaScript
performance.mark – ein benannter Punkt auf der Zeitachse
performance.mark zeichnet einen benannten Zeitstempel auf der Performance-Zeitachse auf. Es bezeichnet einen Punkt, kein Intervall; mit Optionen lassen sich der Zeitpunkt festlegen und Metadaten hinzufügen.
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.mark(markName)
performance.mark(markName, { startTime, detail })performance.mark(markName, markOptions) gehört zur User-Timing-Web-API, nicht zu ECMAScript. Im Level-3-Modell zeichnet die Methode einen PerformanceMark auf und gibt ihn zurück: entryType ist "mark" und duration ist 0. Ein Intervall wird separat mit performance.measure() gemessen.
Ohne startTime verwendet die Methode performance.now(): Millisekunden relativ zum lokalen Zeitursprung, nicht zu einem Kalenderdatum. Das optionale detail wird per Structured Clone kopiert. Füge keine Geheimnisse ein, da andere Skripte auf der Seite die Markierungen lesen können.
Ein negatives startTime löst einen TypeError aus; nicht klonierbares detail kann einen DataCloneError verursachen. In Window führen Namen, die für das veraltete PerformanceTiming reserviert sind, etwa navigationStart, zu einem SyntaxError.
Wird ein Name wiederverwendet, kommt ein weiterer Eintrag hinzu, statt den vorherigen zu ersetzen. performance.clearMarks(name) entfernt alle Markierungen mit diesem Namen. Das Beispiel erfordert Level-3-Unterstützung; Node 24 im Repository belegt keine Browserunterstützung.
Beispiele
(() => {
const name = "cktis:performance-mark:demo";
performance.clearMarks(name);
try {
const mark = performance.mark(name, {
startTime: 12,
detail: { phase: "ready" }
});
console.log(JSON.stringify([
mark.name,
mark.entryType,
mark.startTime,
mark.duration,
mark.detail.phase
]));
} finally {
performance.clearMarks(name);
}
})();Ergebnis
["cktis:performance-mark:demo","mark",12,0,"ready"]
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.