База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

performance.mark — наименувана точка във времевата линия

performance.mark записва наименуван времеви маркер във времевата линия на производителността. Представлява точка, а не интервал; опциите позволяват да зададете времето и да добавите метаданни.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

performance.mark(markName, markOptions) е част от уеб API User Timing, а не от ECMAScript. В модела от ниво 3 записва и връща PerformanceMark: entryType е "mark", а duration е 0. Интервал се измерва отделно с performance.measure().

Ако startTime не е зададен, се използва performance.now(): милисекунди спрямо локалното начало на времето, а не календарна дата. Незадължителното detail се копира чрез структурирано клониране. Не включвайте тайни, защото други скриптове на страницата могат да четат маркерите.

Отрицателен startTime предизвиква TypeError; detail, което не може да се клонира, може да причини DataCloneError. В Window имената, запазени от остарелия PerformanceTiming, например navigationStart, предизвикват SyntaxError.

Повторното използване на име добавя запис, вместо да замени предишния. performance.clearMarks(name) премахва всички маркери с това име. Примерът изисква поддръжка на ниво 3; наличието на Node 24 в хранилището не доказва поддръжка от браузърите.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници