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.