Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje