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"]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.