CKTIS / JavaScript
performance.clearMarks() — odstránenie časových značiek
performance.clearMarks() odstraňuje značky User Timing z buffera záznamov výkonu. Pri zadaní názvu odstráni všetky zodpovedajúce značky; bez argumentu odstráni všetky značky, nie však merania.
Verzia: 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.clearMarks();
performance.clearMarks(markName);performance.clearMarks(markName) odstráni z buffera záznamov výkonu všetky objekty PerformanceMark s presne zadaným názvom, nielen najnovší. Ak názvu nezodpovedá žiadna značka, nič sa nezmení. Metóda vracia undefined, nie počet odstránených záznamov.
performance.clearMarks() bez argumentu odstráni všetky značky. Záznamy PerformanceMeasure neodstráni; na to slúži performance.clearMeasures(). Uprednostnite mazanie podľa názvu, aby ste neodstránili značky patriace iným častiam aplikácie.
Meranie vytvorte ešte pred odstránením značiek, na ktoré odkazuje podľa názvu. Neskoršie volanie performance.measure() s názvom odstránenej značky aplikácie vyvolá SyntaxError, ak značku znovu nevytvoríte. Existujúce merania zostávajú v buffri.
Ide o webové API špecifikované v User Timing, nie o funkciu konkrétnej edície ECMAScript; nachádza sa už v User Timing Level 2. Špecifikácia nie je tabuľkou kompatibility prehliadačov. V cieľovom prostredí skontrolujte typeof globalThis.performance?.clearMarks === "function"; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch.
Príklady
(() => {
const name = "cktis:clearMarks:demo";
performance.clearMarks(name);
try {
performance.mark(name);
performance.mark(name);
console.log(performance.getEntriesByName(name, "mark").length);
const result = performance.clearMarks(name);
console.log(performance.getEntriesByName(name, "mark").length);
console.log(result === undefined);
performance.clearMarks(name);
console.log(performance.getEntriesByName(name, "mark").length);
} finally {
performance.clearMarks(name);
}
})();Výsledok
2 0 true 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.