Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

performance.mark — poimenovana točka na časovnici

performance.mark zabeleži poimenovan časovni žig na časovnici zmogljivosti. Predstavlja točko, ne intervala; z možnostmi lahko nastavimo čas in dodamo metapodatke.

Različica: 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) spada v spletni API User Timing, ne v ECMAScript. V modelu ravni 3 zabeleži in vrne PerformanceMark: entryType je "mark", duration pa 0. Interval meri ločena metoda performance.measure().

Če startTime ni podan, metoda uporabi performance.now(): milisekunde glede na lokalni časovni izhodiščni trenutek, ne koledarski datum. Izbirni detail se kopira s strukturiranim kloniranjem. Vanj ne vključujte skrivnosti, saj lahko oznake berejo tudi drugi skripti na strani.

Negativen startTime sproži TypeError; neklonljiv detail lahko povzroči DataCloneError. V okolju Window imena, rezervirana za zastareli PerformanceTiming, na primer navigationStart, sprožijo SyntaxError.

Ponovna uporaba imena doda vnos, namesto da bi zamenjala prejšnjega. performance.clearMarks(name) odstrani vse oznake s tem imenom. Primer zahteva podporo ravni 3; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.

Primeri

(() => {
  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"]

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri