Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

performance.clearMarks() — odstranjevanje časovnih oznak

performance.clearMarks() odstrani oznake User Timing iz medpomnilnika vnosov učinkovitosti. Če podate ime, odstrani vse ujemajoče se oznake; brez argumenta odstrani vse oznake, ne pa meritev.

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.clearMarks();
performance.clearMarks(markName);

performance.clearMarks(markName) iz medpomnilnika vnosov učinkovitosti odstrani vse objekte PerformanceMark s točno podanim imenom, ne samo najnovejšega. Če se nobena oznaka ne ujema, se nič ne spremeni. Metoda vrne undefined, ne pa števila odstranjenih vnosov.

performance.clearMarks() brez argumenta odstrani vse oznake. Vnosov PerformanceMeasure ne odstrani; za to uporabite performance.clearMeasures(). Prednost dajte odstranjevanju po imenu, da ne izbrišete oznak, ki pripadajo drugim delom aplikacije.

Meritev ustvarite, preden odstranite oznake, na katere se sklicuje po imenu. Poznejši klic performance.measure(), ki uporabi ime odstranjene oznake aplikacije, sproži SyntaxError, razen če oznako znova ustvarite. Obstoječe meritve ostanejo v medpomnilniku.

To je spletni API, določen v User Timing, in ne funkcija določene izdaje ECMAScript; vključen je že v User Timing Level 2. Specifikacija ni tabela združljivosti brskalnikov. V ciljnem okolju preverite typeof globalThis.performance?.clearMarks === "function"; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.

Primeri

(() => {
  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);
  }
})();

Rezultat

2
0
true
0

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri