Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori