Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

performance.mark — nazwany punkt na osi czasu

performance.mark zapisuje nazwany znacznik czasu na osi wydajności. Reprezentuje punkt, nie przedział; opcje pozwalają ustawić czas i dołączyć metadane.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

performance.mark(markName)
performance.mark(markName, { startTime, detail })

performance.mark(markName, markOptions) należy do Web API User Timing, nie do ECMAScript. W modelu Level 3 zapisuje i zwraca PerformanceMark: entryType to "mark", a duration wynosi 0. Przedział mierzy osobne performance.measure().

Bez startTime używa performance.now(): czasu w milisekundach względem początku lokalnej osi czasu, nie daty kalendarzowej. Opcjonalne detail jest kopiowane przez klonowanie strukturalne; nie przekazuj sekretów, ponieważ inne skrypty strony mogą odczytać znaczniki.

Ujemne startTime powoduje TypeError; nieklonowalne detail może spowodować DataCloneError. W Window nazwy zastrzeżone przez dawny PerformanceTiming, np. navigationStart, powodują SyntaxError.

Powtórzona nazwa dodaje wpis zamiast zastępować poprzedni. performance.clearMarks(name) usuwa wszystkie znaczniki tej nazwy. Przykład wymaga obsługi Level 3; obecność Node 24 w repozytorium nie potwierdza obsługi przeglądarki.

Przykłady

(() => {
  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);
  }
})();

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła