CKTIS / JavaScript
performance.mark — imenovana točka na vremenskoj crti
performance.mark bilježi imenovanu vremensku oznaku na vremenskoj crti performansi. Predstavlja točku, a ne interval; opcije omogućuju postavljanje vremena i dodavanje metapodataka.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
performance.mark(markName)
performance.mark(markName, { startTime, detail })performance.mark(markName, markOptions) dio je web-sučelja User Timing, a ne ECMAScripta. U modelu razine 3 bilježi i vraća PerformanceMark: entryType je "mark", a duration je 0. Interval zasebno mjeri performance.measure().
Ako startTime nije zadan, upotrebljava se performance.now(): milisekunde u odnosu na lokalno vremensko ishodište, a ne kalendarski datum. Neobavezni detail kopira se strukturiranim kloniranjem. Nemojte uključivati tajne jer oznake mogu čitati i druge skripte na stranici.
Negativan startTime uzrokuje TypeError; detail koji se ne može klonirati može uzrokovati DataCloneError. U okruženju Window nazivi rezervirani za zastarjeli PerformanceTiming, primjerice navigationStart, uzrokuju SyntaxError.
Ponovna upotreba naziva dodaje unos umjesto da zamijeni prethodni. performance.clearMarks(name) uklanja sve oznake s tim nazivom. Primjer zahtijeva podršku razine 3; prisutnost Nodea 24 u repozitoriju ne dokazuje podršku preglednika.
Primjeri
(() => {
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);
}
})();Rezultat
["cktis:performance-mark:demo","mark",12,0,"ready"]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.