JS Self-Profiling API

Um ein Profil zu starten, erstellt eine Website eine Profiler-Instanz. Sobald die Instanz erstellt wird, beginnt sie, den JavaScript-Ausführungskontext zu sampeln.

Um das Sammeln von Samples zu stoppen und das Profil abzurufen, ruft die Website Profiler.stop() auf. Dies gibt ein Promise zurück, das sich zu einem Objekt auflöst, das die Profildaten enthält.

Zum Beispiel erstellt die folgende Funktion einen Profiler, ruft dann eine Funktion genPrimes() auf, stoppt dann den Profiler und ruft die Profildaten ab:

async function profileGeneratePrimes() {
  const profiler = new Profiler({ sampleInterval: 10, maxBufferSize: 10000 });

  genPrimes();

  const trace = await profiler.stop();
  console.log(trace);
}

Der Profiler ist ein Sampling-Profiler: Das bedeutet, dass er periodisch den aktuellen Zustand des JavaScript-Call Stacks aufzeichnet (oder sampelt). Das Profil besteht aus der Sammlung dieser Samples. Dies ermöglicht es Ihnen zu verstehen, wo das Programm statistisch gesehen die meiste Zeit verbringt.

Um genau zu verstehen, was ein Profil enthält und wie es formatiert ist, siehe Profile anatomy and format.

Das Sammeln und Verarbeiten von Profildaten bringt selbst einen Leistungsaufwand mit sich, und Entwickler sollten darauf achten, diesen zu steuern. Praktiken zur Minimierung des Leistungsaufwands umfassen:

• Verwenden Sie die Optionen maxbuffersize und sampleinterval, um zu steuern, wie viele Samples genommen werden und wie oft gesampelt wird.
• Sampeln Sie für kurze Zeiträume in einer abgetasteten Weise: Zum Beispiel, trace für 5 Sekunden alle 60 Sekunden.
• Verarbeiten Sie die Samples in einem Web-Worker, um die Leistung im Haupt-Thread nicht zu beeinträchtigen.
• Aggregieren Sie Samples auf dem Client, bevor Sie sie an einen Telemetrie-Endpunkt senden.

Wenn das JavaScript auf Ihrer Seite minifiziert ist, müssen Sie die Profildaten basierend auf einer Source Map entweder auf dem Client oder auf dem Server transformieren, bevor die Daten nutzbar sind.

Profiler Experimentell

Die Profiler-Schnittstelle wird verwendet, um Profile zu erstellen.

Um diese API zu nutzen, muss das Dokument mit einer Dokumentenrichtlinie bereitgestellt werden, die den Konfigurationspunkt "js-profiling" enthält.