@paulirish/trace_engine 0.0.21 → 0.0.22

package/models/trace/types/Configuration.d.ts

@@ -1,33 +1,21 @@
-export type Configuration = Readonly<{
-    settings: {};
-    experiments: {
-        /**
-         * Include V8 RCS in the timeline
-         */
-        timelineV8RuntimeCallStats: boolean;
-        /**
-         * Show all events: disable the default filtering which hides and excludes some events.
-         */
-        timelineShowAllEvents: boolean;
-    };
-    processing: {
-        /**
-         * How long the processor should pause between event chunks.
-         */
-        pauseDuration: number;
-        /**
-         * How many events should be processed before yielding to the main thread for a pause.
-         */
-        eventsPerChunk: number;
-    };
-}>;
-export declare const DEFAULT: Configuration;
+export type Configuration = {
+    /**
+     * Include V8 RCS functions in the JS stacks
+     */
+    includeRuntimeCallStats: boolean;
+    /**
+     * Show all events: disable the default filtering which hides and excludes some events.
+     */
+    showAllEvents: boolean;
+    /**
+     * Extra detail for RPP developers (eg Trace Event json in Summary, and individual JS Sample events)
+     */
+    debugMode: boolean;
+};
+export declare const defaults: () => Configuration;
 /**
  * Generates a key that can be used to represent this config in a cache. This is
  * used mainly in tests, where we want to avoid re-parsing a file if we have
- * already processed it with the same configuration. This cache key purposefully
- * does not include all settings in the configuration; the processing settings
- * do not impact the actual resulting data. Only new flags in the config that
- * alter parsing should be added to this cache key.
+ * already processed it with the same configuration.
  */
 export declare function configToCacheKey(config: Configuration): string;

package/models/trace/types/Configuration.js

@@ -1,37 +1,17 @@
 // Copyright 2023 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
-export const DEFAULT = {
-    settings: {},
-    experiments: {
-        timelineV8RuntimeCallStats: false,
-        timelineShowAllEvents: false,
-    },
-    processing: {
-        /**
-         * We want to yield regularly to maintain responsiveness. If we yield too often, we're wasting idle time.
-         * We could do this by checking `performance.now()` regularly, but it's an expensive call in such a hot loop.
-         * `eventsPerChunk` is an approximated proxy metric.
-         * But how big a chunk? We're aiming for long tasks that are no smaller than 100ms and not bigger than 200ms.
-         * It's CPU dependent, so it should be calibrated on oldish hardware.
-         * Illustration of a previous change to `eventsPerChunk`: https://imgur.com/wzp8BnR
-         */
-        eventsPerChunk: 50_000,
-        pauseDuration: 0,
-    },
-};
+export const defaults = () => ({
+    includeRuntimeCallStats: false,
+    showAllEvents: false,
+    debugMode: false,
+});
 /**
  * Generates a key that can be used to represent this config in a cache. This is
  * used mainly in tests, where we want to avoid re-parsing a file if we have
- * already processed it with the same configuration. This cache key purposefully
- * does not include all settings in the configuration; the processing settings
- * do not impact the actual resulting data. Only new flags in the config that
- * alter parsing should be added to this cache key.
+ * already processed it with the same configuration.
  */
 export function configToCacheKey(config) {
-    return [
-        `experiments.timelineShowAllEvents:${config.experiments.timelineShowAllEvents}`,
-        `experiments.timelineV8RuntimeCallStats:${config.experiments.timelineV8RuntimeCallStats}`,
-    ].join('-');
+    return JSON.stringify(config);
 }
 //# sourceMappingURL=Configuration.js.map

package/models/trace/types/Configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/Configuration.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AA4B7B,MAAM,CAAC,MAAM,OAAO,GAAkB;IACpC,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE;QACX,0BAA0B,EAAE,KAAK;QACjC,qBAAqB,EAAE,KAAK;KAC7B;IACD,UAAU,EAAE;QAEV;;;;;;;WAOG;QACH,cAAc,EAAE,MAAM;QACtB,aAAa,EAAE,CAAC;KACjB;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,OAAO;QACL,qCAAqC,MAAM,CAAC,WAAW,CAAC,qBAAqB,EAAE;QAC/E,0CAA0C,MAAM,CAAC,WAAW,CAAC,0BAA0B,EAAE;KAC1F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC","sourcesContent":["// Copyright 2023 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nexport type Configuration = Readonly<{\n  settings: {\n      // Currently empty but defining here as we will migrate more settings into this.\n  },\n  experiments: {\n    /**\n     * Include V8 RCS in the timeline\n     */\n    timelineV8RuntimeCallStats: boolean,\n    /**\n     * Show all events: disable the default filtering which hides and excludes some events.\n     */\n    timelineShowAllEvents: boolean,\n  },\n  processing: {\n    /**\n     * How long the processor should pause between event chunks.\n     */\n    pauseDuration: number,\n    /**\n     * How many events should be processed before yielding to the main thread for a pause.\n     */\n    eventsPerChunk: number,\n  },\n}>;\n\nexport const DEFAULT: Configuration = {\n  settings: {},\n  experiments: {\n    timelineV8RuntimeCallStats: false,\n    timelineShowAllEvents: false,\n  },\n  processing: {\n\n    /**\n     * We want to yield regularly to maintain responsiveness. If we yield too often, we're wasting idle time.\n     * We could do this by checking `performance.now()` regularly, but it's an expensive call in such a hot loop.\n     * `eventsPerChunk` is an approximated proxy metric.\n     * But how big a chunk? We're aiming for long tasks that are no smaller than 100ms and not bigger than 200ms.\n     * It's CPU dependent, so it should be calibrated on oldish hardware.\n     * Illustration of a previous change to `eventsPerChunk`: https://imgur.com/wzp8BnR\n     */\n    eventsPerChunk: 50_000,\n    pauseDuration: 0,\n  },\n};\n\n/**\n * Generates a key that can be used to represent this config in a cache. This is\n * used mainly in tests, where we want to avoid re-parsing a file if we have\n * already processed it with the same configuration. This cache key purposefully\n * does not include all settings in the configuration; the processing settings\n * do not impact the actual resulting data. Only new flags in the config that\n * alter parsing should be added to this cache key.\n */\nexport function configToCacheKey(config: Configuration): string {\n  return [\n    `experiments.timelineShowAllEvents:${config.experiments.timelineShowAllEvents}`,\n    `experiments.timelineV8RuntimeCallStats:${config.experiments.timelineV8RuntimeCallStats}`,\n  ].join('-');\n}\n"]}
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/Configuration.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAiB7B,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAkB,EAAE,CAAC,CAAC;IAC5C,uBAAuB,EAAE,KAAK;IAC9B,aAAa,EAAE,KAAK;IACpB,SAAS,EAAE,KAAK;CACjB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC","sourcesContent":["// Copyright 2023 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nexport type Configuration = {\n  /**\n   * Include V8 RCS functions in the JS stacks\n   */\n  includeRuntimeCallStats: boolean,\n  /**\n   * Show all events: disable the default filtering which hides and excludes some events.\n   */\n  showAllEvents: boolean,\n  /**\n   * Extra detail for RPP developers (eg Trace Event json in Summary, and individual JS Sample events)\n   */\n  debugMode: boolean,\n};\n\nexport const defaults = (): Configuration => ({\n  includeRuntimeCallStats: false,\n  showAllEvents: false,\n  debugMode: false,\n});\n\n/**\n * Generates a key that can be used to represent this config in a cache. This is\n * used mainly in tests, where we want to avoid re-parsing a file if we have\n * already processed it with the same configuration.\n */\nexport function configToCacheKey(config: Configuration): string {\n  return JSON.stringify(config);\n}\n"]}

package/models/trace/types/TraceEvents.d.ts

@@ -251,12 +251,16 @@ export interface SyntheticNetworkRequest extends TraceEventComplete {
             frame: string;
             fromServiceWorker: boolean;
             isLinkPreload: boolean;
-            host: string;
             mimeType: string;
-            pathname: string;
-            search: string;
             priority: Protocol.Network.ResourcePriority;
             initialPriority: Protocol.Network.ResourcePriority;
+            /**
+             * This is the protocol used to resolve the request.
+             *
+             * Note, this is not the same as URL.protocol.
+             *
+             * Example values (not exhaustive): http/0.9, http/1.0, http/1.1, http, h2, h3-Q050, data, blob
+             */
             protocol: string;
             redirects: SyntheticNetworkRedirect[];
             renderBlocking: RenderBlocking;
@@ -371,19 +375,22 @@ export interface SyntheticScreenshot extends TraceEventData {
 }
 export interface TraceEventAnimation extends TraceEventData {
     args: TraceEventArgs & {
-        id?: string;
-        name?: string;
-        nodeId?: number;
-        nodeName?: string;
-        state?: string;
-        compositeFailed?: number;
-        unsupportedProperties?: string[];
+        data: TraceEventArgsData & {
+            nodeName?: string;
+            nodeId?: number;
+            displayName?: string;
+            id?: string;
+            name?: string;
+            state?: string;
+            compositeFailed?: number;
+            unsupportedProperties?: string[];
+        };
     };
     name: 'Animation';
     id2?: {
         local?: string;
     };
-    ph: Phase.ASYNC_NESTABLE_START | Phase.ASYNC_NESTABLE_END;
+    ph: Phase.ASYNC_NESTABLE_START | Phase.ASYNC_NESTABLE_END | Phase.ASYNC_NESTABLE_INSTANT;
 }
 export interface TraceEventMetadata extends TraceEventData {
     ph: Phase.METADATA;
@@ -709,6 +716,14 @@ export interface TraceEventResourceReceiveResponse extends TraceEventInstant {
     name: 'ResourceReceiveResponse';
     args: TraceEventArgs & {
         data: TraceEventArgsData & {
+            /**
+             * This is the protocol used to resolve the request.
+             *
+             * Note, this is not the same as URL.protocol.
+             *
+             * Example values (not exhaustive): http/0.9, http/1.0, http/1.1, http, h2, h3-Q050, data, blob
+             */
+            protocol: string;
             encodedDataLength: number;
             frame: string;
             fromCache: boolean;
@@ -831,7 +846,7 @@ export interface TraceEventPrePaint extends TraceEventComplete {
     name: 'PrePaint';
 }
 export interface TraceEventPairableAsync extends TraceEventData {
-    ph: Phase.ASYNC_NESTABLE_START | Phase.ASYNC_NESTABLE_END;
+    ph: Phase.ASYNC_NESTABLE_START | Phase.ASYNC_NESTABLE_END | Phase.ASYNC_NESTABLE_INSTANT;
     id2?: {
         local?: string;
         global?: string;
@@ -841,6 +856,9 @@ export interface TraceEventPairableAsync extends TraceEventData {
 export interface TraceEventPairableAsyncBegin extends TraceEventPairableAsync {
     ph: Phase.ASYNC_NESTABLE_START;
 }
+export interface TraceEventPairableAsyncInstant extends TraceEventPairableAsync {
+    ph: Phase.ASYNC_NESTABLE_INSTANT;
+}
 export interface TraceEventPairableAsyncEnd extends TraceEventPairableAsync {
     ph: Phase.ASYNC_NESTABLE_END;
 }
@@ -989,6 +1007,7 @@ export interface SyntheticEventPair<T extends TraceEventPairableAsync = TraceEve
         data: {
             beginEvent: T & TraceEventPairableAsyncBegin;
             endEvent: T & TraceEventPairableAsyncEnd;
+            instantEvents?: Array<T & TraceEventPairableAsyncInstant>;
         };
     };
 }
@@ -1017,10 +1036,32 @@ export interface SyntheticTraceEntry extends TraceEventData {
 /**
  * A profile call created in the frontend from samples disguised as a
  * trace event.
+ *
+ * We store the sampleIndex, profileId and nodeId so that we can easily link
+ * back a Synthetic Trace Entry to an indivdual Sample trace event within a
+ * Profile.
+ *
+ * Because a sample contains a set of call frames representing the stack at the
+ * point in time that the sample was created, we also have to store the ID of
+ * the Node that points to the function call that this profile call represents.
  */
 export interface SyntheticProfileCall extends SyntheticTraceEntry {
     callFrame: Protocol.Runtime.CallFrame;
     nodeId: Protocol.integer;
+    sampleIndex: number;
+    profileId: ProfileID;
+}
+/**
+ * A JS Sample reflects a single sample from the V8 CPU Profile
+ */
+export interface SyntheticJSSample extends SyntheticTraceEntry {
+    name: KnownEventName.JSSample;
+    args: TraceEventArgs & {
+        data: TraceEventArgsData & {
+            stackTrace: Protocol.Runtime.CallFrame[];
+        };
+    };
+    ph: Phase.INSTANT;
 }
 /**
  * A trace event augmented synthetically in the frontend to contain
@@ -1528,6 +1569,9 @@ export interface TraceEventV8Compile extends TraceEventComplete {
         data?: {
             url?: string;
             columnNumber?: number;
+            consumedCacheSize?: number;
+            cacheRejected?: boolean;
+            cacheKind?: 'full' | 'normal';
             lineNumber?: number;
             notStreamedReason?: string;
             streamed?: boolean;
@@ -1620,7 +1664,6 @@ export declare const enum KnownEventName {
     GCCollectGarbage = "BlinkGC.AtomicPhase",
     CPPGCSweep = "CppGC.IncrementalSweep",
     ScheduleStyleRecalculation = "ScheduleStyleRecalculation",
-    RecalculateStyles = "RecalculateStyles",
     Layout = "Layout",
     UpdateLayoutTree = "UpdateLayoutTree",
     InvalidateLayout = "InvalidateLayout",
@@ -1696,6 +1739,7 @@ export declare const enum KnownEventName {
     StartProfiling = "CpuProfiler::StartProfiling",
     ProfileChunk = "ProfileChunk",
     UpdateCounters = "UpdateCounters",
+    JSSample = "JSSample",
     Animation = "Animation",
     ParseAuthorStyleSheet = "ParseAuthorStyleSheet",
     EmbedderCallback = "EmbedderCallback",

package/models/trace/types/TraceEvents.js

@@ -212,7 +212,8 @@ export function isTraceEventNavigationStart(traceEventData) {
     return traceEventData.name === 'navigationStart';
 }
 export function isTraceEventAnimation(traceEventData) {
-    return traceEventData.name === 'Animation';
+    // We've found some rare traces with an Animtation trace event from a different category: https://crbug.com/1472375#comment7
+    return traceEventData.name === 'Animation' && traceEventData.cat.includes('devtools.timeline');
 }
 export function isTraceEventLayoutShift(traceEventData) {
     return traceEventData.name === 'LayoutShift';