CKTIS / JavaScript
performance.mark — pojmenovaný bod na časové ose
performance.mark zaznamená pojmenované časové razítko na výkonnostní časovou osu. Představuje bod, nikoli interval; pomocí možností lze nastavit jeho čas a připojit metadata.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
performance.mark(markName)
performance.mark(markName, { startTime, detail })performance.mark(markName, markOptions) patří do webového rozhraní User Timing, nikoli do ECMAScriptu. V modelu úrovně 3 zaznamená a vrátí objekt PerformanceMark: entryType je "mark" a duration je 0. Interval měří samostatně performance.measure().
Bez startTime používá performance.now(): milisekundy vztažené k místnímu počátku času, nikoli ke kalendářnímu datu. Volitelné detail se kopíruje pomocí strukturovaného klonování. Nevkládejte do něj tajné údaje, protože značky mohou číst i jiné skripty na stránce.
Záporné startTime vyvolá TypeError; neklonovatelné detail může způsobit DataCloneError. V prostředí Window vyvolají názvy vyhrazené starším PerformanceTiming, například navigationStart, chybu SyntaxError.
Opětovné použití názvu přidá položku, místo aby nahradilo předchozí. performance.clearMarks(name) odstraní všechny značky s daným názvem. Příklad vyžaduje podporu úrovně 3; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.
Příklady
(() => {
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);
}
})();Výsledek
["cktis:performance-mark:demo","mark",12,0,"ready"]
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.