CKTIS / JavaScript
performance.clearMarks() — odstranění časových značek
performance.clearMarks() odstraňuje značky User Timing z bufferu výkonnostních záznamů. Při zadání názvu odstraní všechny odpovídající značky; bez argumentu odstraní všechny značky, nikoli však měření.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
performance.clearMarks();
performance.clearMarks(markName);performance.clearMarks(markName) odstraní z bufferu výkonnostních záznamů všechny objekty PerformanceMark s přesně zadaným názvem, nejen nejnovější. Pokud žádná značka názvu neodpovídá, nic se nezmění. Metoda vrací undefined, nikoli počet odstraněných záznamů.
performance.clearMarks() bez argumentu odstraní všechny značky. Záznamy PerformanceMeasure neodstraní; k tomu slouží performance.clearMeasures(). Dávejte přednost mazání podle názvu, abyste neodstranili značky patřící jiným částem aplikace.
Než odstraníte značky, na které měření odkazuje názvem, vytvořte toto měření. Pozdější volání performance.measure() s názvem odstraněné značky aplikace vyvolá SyntaxError, pokud značku znovu nevytvoříte. Existující měření zůstávají v bufferu.
Jde o webové API specifikované v User Timing, nikoli o funkci určité edice ECMAScript; je součástí už User Timing Level 2. Specifikace není tabulkou kompatibility prohlížečů. V cílovém prostředí ověřte typeof globalThis.performance?.clearMarks === "function"; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.
Pří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ýsledek
2 0 true 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.