Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje