@paulirish/trace_engine 0.0.52 → 0.0.54

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

@@ -1,7 +1,7 @@
 import type * as Platform from '../../../core/platform/platform.js';
 import type * as Protocol from '../../../generated/protocol.js';
 import type { Micro, Milli, Seconds, TraceWindowMicro } from './Timing.js';
-export declare const enum Phase {
+export declare enum Phase {
     BEGIN = "B",
     END = "E",
     COMPLETE = "X",
@@ -30,7 +30,7 @@ export declare const enum Phase {
 export declare function isNestableAsyncPhase(phase: Phase): boolean;
 export declare function isPhaseAsync(phase: Phase): boolean;
 export declare function isFlowPhase(phase: Phase): boolean;
-export declare const enum Scope {
+export declare enum Scope {
     THREAD = "t",
     PROCESS = "p",
     GLOBAL = "g"
@@ -174,10 +174,10 @@ export interface ParseHTML extends Complete {
     name: 'ParseHTML';
     args: Args & {
         beginData: {
-            sampleTraceId?: number;
             frame: string;
             startLine: number;
             url: string;
+            sampleTraceId?: number;
         };
         endData?: {
             endLine: number;
@@ -279,8 +279,9 @@ export interface SyntheticNetworkRequest extends Complete, SyntheticBased<Phase.
              */
             encodedDataLength: number;
             frame: string;
-            fromServiceWorker: boolean;
+            fromServiceWorker: boolean | undefined;
             isLinkPreload: boolean;
+            /** Empty string if no response. */
             mimeType: string;
             priority: Protocol.Network.ResourcePriority;
             initialPriority: Protocol.Network.ResourcePriority;
@@ -296,20 +297,24 @@ export interface SyntheticNetworkRequest extends Complete, SyntheticBased<Phase.
             renderBlocking: RenderBlocking;
             requestId: string;
             requestingFrameUrl: string;
+            /** 0 if no response. */
             statusCode: number;
             resourceType: Protocol.Network.ResourceType;
             responseHeaders: Array<{
                 name: string;
                 value: string;
-            }>;
+            }> | null;
             fetchPriorityHint: FetchPriorityHint;
             url: string;
             /** True only if got a 'resourceFinish' event indicating a failure. */
             failed: boolean;
-            /** True only if got a 'resourceFinish' event. */
+            /** True only if got a 'resourceFinish' event. Note even failed requests with no response may be "finished". */
             finished: boolean;
-            connectionId: number;
-            connectionReused: boolean;
+            hasResponse: boolean;
+            /** If undefined, trace was either too old or had no response. */
+            connectionId: number | undefined;
+            /** If undefined, trace was either too old or had no response. */
+            connectionReused: boolean | undefined;
             initiator?: Initiator;
             requestMethod?: string;
             timing?: ResourceReceiveResponseTimingData;
@@ -343,7 +348,7 @@ export interface SyntheticWebSocketConnection extends Complete, SyntheticBased<P
     tid: ThreadID;
     s: Scope;
 }
-export declare const enum AuctionWorkletType {
+export declare enum AuctionWorkletType {
     BIDDER = "bidder",
     SELLER = "seller",
     UNKNOWN = "unknown"
@@ -363,11 +368,11 @@ export interface SyntheticAuctionWorklet extends Instant, SyntheticBased<Phase.I
             runningInProcessEvent: AuctionWorkletRunningInProcess;
             doneWithProcessEvent: AuctionWorkletDoneWithProcess;
         } | {
-            runningInProcessEvent?: AuctionWorkletRunningInProcess;
             doneWithProcessEvent: AuctionWorkletDoneWithProcess;
+            runningInProcessEvent?: AuctionWorkletRunningInProcess;
         } | {
-            doneWithProcessEvent?: AuctionWorkletDoneWithProcess;
             runningInProcessEvent: AuctionWorkletRunningInProcess;
+            doneWithProcessEvent?: AuctionWorkletDoneWithProcess;
         });
     };
 }
@@ -623,8 +628,8 @@ export interface TracingStartedInBrowser extends Instant {
     args: Args & {
         data?: ArgsData & {
             frameTreeNodeId: number;
-            frames?: TraceFrame[];
             persistentIds: boolean;
+            frames?: TraceFrame[];
         };
     };
 }
@@ -676,8 +681,8 @@ export interface MarkDOMContent extends Instant {
         data?: ArgsData & {
             frame: string;
             isMainFrame: boolean;
-            isOutermostMainFrame?: boolean;
             page: string;
+            isOutermostMainFrame?: boolean;
         };
     };
 }
@@ -887,9 +892,9 @@ export interface ResourceReceiveResponse extends Instant {
             requestId: string;
             responseTime: Milli;
             statusCode: number;
-            timing?: ResourceReceiveResponseTimingData;
             connectionId: number;
             connectionReused: boolean;
+            timing?: ResourceReceiveResponseTimingData;
             headers?: Array<{
                 name: string;
                 value: string;
@@ -905,7 +910,7 @@ export interface ResourceMarkAsCached extends Instant {
         };
     };
 }
-export declare const enum LayoutInvalidationReason {
+export declare enum LayoutInvalidationReason {
     SIZE_CHANGED = "Size changed",
     ATTRIBUTE = "Attribute",
     ADDED_TO_LAYOUT = "Added to layout",
@@ -944,7 +949,7 @@ export interface ScheduleStyleInvalidationTracking extends Instant {
     };
 }
 export declare function isScheduleStyleInvalidationTracking(event: Event): event is ScheduleStyleInvalidationTracking;
-export declare const enum StyleRecalcInvalidationReason {
+export declare enum StyleRecalcInvalidationReason {
     ANIMATION = "Animation"
 }
 export interface StyleRecalcInvalidationTracking extends Instant {
@@ -969,8 +974,8 @@ export interface StyleInvalidatorInvalidationTracking extends Instant {
             nodeId: Protocol.DOM.BackendNodeId;
             reason: string;
             invalidationList: Array<{
-                classes?: string[];
                 id: string;
+                classes?: string[];
             }>;
             subtree: boolean;
             nodeName?: string;
@@ -998,6 +1003,17 @@ export interface ParseMetaViewport extends Instant {
     };
 }
 export declare function isParseMetaViewport(event: Event): event is ParseMetaViewport;
+export interface LinkPreconnect extends Instant {
+    name: Name.LINK_PRECONNECT;
+    args: Args & {
+        data: {
+            node_id: Protocol.DOM.BackendNodeId;
+            url: string;
+            frame?: string;
+        };
+    };
+}
+export declare function isLinkPreconnect(event: Event): event is LinkPreconnect;
 export interface ScheduleStyleRecalculation extends Instant {
     name: Name.SCHEDULE_STYLE_RECALCULATION;
     args: Args & {
@@ -1316,8 +1332,8 @@ export interface SyntheticJSSample extends Event {
     name: Name.JS_SAMPLE;
     args: Args & {
         data: ArgsData & {
-            traceId?: number;
             stackTrace: Protocol.Runtime.CallFrame[];
+            traceId?: number;
         };
     };
     ph: Phase.INSTANT;
@@ -1467,8 +1483,8 @@ export interface UpdateLayoutTree extends Complete {
     args: Args & {
         elementCount: number;
         beginData?: {
-            sampleTraceId?: number;
             frame: string;
+            sampleTraceId?: number;
             stackTrace?: CallFrame[];
         };
     };
@@ -1478,11 +1494,11 @@ export interface Layout extends Complete {
     name: Name.LAYOUT;
     args: Args & {
         beginData: {
-            sampleTraceId?: number;
             frame: string;
             dirtyObjects: number;
             partialLayout: boolean;
             totalObjects: number;
+            sampleTraceId?: number;
             stackTrace?: CallFrame[];
         };
         endData?: {
@@ -1629,12 +1645,12 @@ export interface PaintImage extends Complete {
             x: number;
             y: number;
             isCSS: boolean;
+            srcHeight: number;
+            srcWidth: number;
             isPicture?: boolean;
             loadingAttribute?: string;
             srcsetAttribute?: string;
             url?: string;
-            srcHeight: number;
-            srcWidth: number;
             nodeId?: Protocol.DOM.BackendNodeId;
             nodeName?: string;
             frame?: string;
@@ -1764,9 +1780,9 @@ export interface TimerInstall extends Instant {
         data: {
             frame: string;
             singleShot: boolean;
-            stackTrace?: CallFrame;
             timeout: number;
             timerId: number;
+            stackTrace?: CallFrame;
         };
     };
 }
@@ -1824,9 +1840,9 @@ export interface WebSocketTransfer extends Instant {
         data: ArgsData & {
             identifier: number;
             url: string;
+            dataLength: number;
             frame?: string;
             workerId?: string;
-            dataLength: number;
         };
     };
 }
@@ -1838,9 +1854,9 @@ export interface WebSocketSend extends Instant {
         data: ArgsData & {
             identifier: number;
             url: string;
+            dataLength: number;
             frame?: string;
             workerId?: string;
-            dataLength: number;
         };
     };
 }
@@ -1851,9 +1867,9 @@ export interface WebSocketReceive extends Instant {
         data: ArgsData & {
             identifier: number;
             url: string;
+            dataLength: number;
             frame?: string;
             workerId?: string;
-            dataLength: number;
         };
     };
 }
@@ -1976,13 +1992,22 @@ export interface FlowEvent extends Event {
     ph: Phase.FLOW_START | Phase.FLOW_END | Phase.FLOW_STEP;
 }
 export declare function isFlowPhaseEvent(event: Event): event is FlowEvent;
+export interface ParseAuthorStyleSheet extends Complete {
+    name: Name.PARSE_AUTHOR_STYLE_SHEET;
+    args?: Args & {
+        data: {
+            stylesheetUrl: string;
+        };
+    };
+}
+export declare function isParseAuthorStyleSheetEvent(event: Event): event is ParseAuthorStyleSheet;
 /**
  * This is an exhaustive list of events we track in the Performance
  * panel. Note not all of them are necessarliry shown in the flame
  * chart, some of them we only use for parsing.
  * TODO(crbug.com/1428024): Complete this enum.
  */
-export declare const enum Name {
+export declare enum Name {
     THREAD_NAME = "thread_name",
     PROGRAM = "Program",
     RUN_TASK = "RunTask",
@@ -2150,7 +2175,8 @@ export declare const enum Name {
     ANIMATION_FRAME = "AnimationFrame",
     ANIMATION_FRAME_PRESENTATION = "AnimationFrame::Presentation",
     SYNTHETIC_NETWORK_REQUEST = "SyntheticNetworkRequest",
-    USER_TIMING_MEASURE = "UserTiming::Measure"
+    USER_TIMING_MEASURE = "UserTiming::Measure",
+    LINK_PRECONNECT = "LinkPreconnect"
 }
 export declare const Categories: {
     readonly Console: "blink.console";
@@ -2231,6 +2257,7 @@ export interface V8SourceRundownEvent extends Event {
             url?: string;
             sourceUrl?: string;
             sourceMapUrl?: string;
+            sourceMapUrlElided?: boolean;
         };
     };
 }