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.