CKTIS / JavaScript
performance.mark — een benoemd punt op de tijdlijn
performance.mark legt een benoemd tijdstip vast op de prestatietijdlijn. Het stelt een punt voor, geen interval; met opties kun je het tijdstip instellen en metadata toevoegen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
performance.mark(markName)
performance.mark(markName, { startTime, detail })performance.mark(markName, markOptions) hoort bij de User Timing-web-API, niet bij ECMAScript. In het Level 3-model legt de methode een PerformanceMark vast en geeft die terug: entryType is "mark" en duration is 0. Een interval meet je apart met performance.measure().
Zonder startTime gebruikt de methode performance.now(): milliseconden ten opzichte van het lokale tijdsoorsprongspunt, niet een kalenderdatum. De optionele detail wordt gekopieerd met structured cloning. Neem geen geheimen op, want andere scripts op de pagina kunnen marks lezen.
Een negatieve startTime veroorzaakt een TypeError; een niet-kloonbare detail kan een DataCloneError veroorzaken. In Window veroorzaken namen die zijn gereserveerd door het verouderde PerformanceTiming, zoals navigationStart, een SyntaxError.
Een naam opnieuw gebruiken voegt een item toe in plaats van het vorige te vervangen. performance.clearMarks(name) verwijdert alle marks met die naam. Het voorbeeld vereist Level 3-ondersteuning; de aanwezigheid van Node 24 in de repository bewijst geen browserondersteuning.
Voorbeelden
(() => {
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);
}
})();Resultaat
["cktis:performance-mark:demo","mark",12,0,"ready"]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.