Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

performance.mark — pomenovaný bod na časovej osi

performance.mark zaznamená pomenovanú časovú značku na výkonnostnú časovú os. Predstavuje bod, nie interval; možnosti umožňujú nastaviť čas a pripojiť metadáta.

Verzia: 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) patrí do webového rozhrania User Timing, nie do ECMAScriptu. V modeli úrovne 3 zaznamená a vráti objekt PerformanceMark: entryType je "mark" a duration je 0. Interval meria samostatne performance.measure().

Bez startTime používa performance.now(): milisekundy vzhľadom na miestny časový počiatok, nie kalendárny dátum. Voliteľné detail sa kopíruje pomocou štruktúrovaného klonovania. Nevkladajte doň tajné údaje, pretože značky môžu čítať aj iné skripty na stránke.

Záporné startTime vyvolá TypeError; neklonovateľné detail môže spôsobiť DataCloneError. V prostredí Window vyvolajú názvy vyhradené starším PerformanceTiming, napríklad navigationStart, chybu SyntaxError.

Opätovné použitie názvu pridá položku namiesto nahradenia predchádzajúcej. performance.clearMarks(name) odstráni všetky značky s daným názvom. Príklad vyžaduje podporu úrovne 3; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch.

Prí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ýsledok

["cktis:performance-mark:demo","mark",12,0,"ready"]

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje