@paulirish/trace_engine 0.0.12 → 0.0.13

package/models/trace/insights/InsightRunners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InsightRunners.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/InsightRunners.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC","sourcesContent":["// Copyright 2024 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 * as RenderBlocking from './RenderBlocking.js';\n"]}

package/models/trace/insights/RenderBlocking.d.ts

@@ -0,0 +1,6 @@
+import type * as Types from '../types/types.js';
+import { type NavigationInsightContext, type RequiredData } from './types.js';
+export declare function deps(): ['NetworkRequests', 'Meta'];
+export declare function generateInsight(traceParsedData: RequiredData<typeof deps>, context: NavigationInsightContext): {
+    renderBlockingRequests: Types.TraceEvents.SyntheticNetworkRequest[];
+};

package/models/trace/insights/RenderBlocking.js

@@ -0,0 +1,27 @@
+// Copyright 2024 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.
+import * as Helpers from '../helpers/helpers.js';
+export function deps() {
+    return ['NetworkRequests', 'Meta'];
+}
+export function generateInsight(traceParsedData, context) {
+    const renderBlockingRequests = [];
+    for (const req of traceParsedData.NetworkRequests.byTime) {
+        if (req.args.data.frame !== context.frameId) {
+            continue;
+        }
+        const navigation = Helpers.Trace.getNavigationForTraceEvent(req, context.frameId, traceParsedData.Meta.navigationsByFrameId);
+        if (navigation?.args.data?.navigationId !== context.navigationId) {
+            continue;
+        }
+        if (req.args.data.renderBlocking !== 'blocking') {
+            continue;
+        }
+        renderBlockingRequests.push(req);
+    }
+    return {
+        renderBlockingRequests,
+    };
+}
+//# sourceMappingURL=RenderBlocking.js.map

package/models/trace/insights/RenderBlocking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderBlocking.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/RenderBlocking.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAC;AAKjD,MAAM,UAAU,IAAI;IAClB,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,eAA0C,EAAE,OAAiC;IAE3G,MAAM,sBAAsB,GAAG,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,eAAe,CAAC,MAAM,EAAE;QACxD,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,EAAE;YAC3C,SAAS;SACV;QAED,MAAM,UAAU,GACZ,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC9G,IAAI,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,YAAY,EAAE;YAChE,SAAS;SACV;QAED,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,KAAK,UAAU,EAAE;YAC/C,SAAS;SACV;QAED,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KAClC;IAED,OAAO;QACL,sBAAsB;KACvB,CAAC;AACJ,CAAC","sourcesContent":["// Copyright 2024 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\nimport * as Helpers from '../helpers/helpers.js';\nimport type * as Types from '../types/types.js';\n\nimport {type NavigationInsightContext, type RequiredData} from './types.js';\n\nexport function deps(): ['NetworkRequests', 'Meta'] {\n  return ['NetworkRequests', 'Meta'];\n}\n\nexport function generateInsight(traceParsedData: RequiredData<typeof deps>, context: NavigationInsightContext):\n    {renderBlockingRequests: Types.TraceEvents.SyntheticNetworkRequest[]} {\n  const renderBlockingRequests = [];\n  for (const req of traceParsedData.NetworkRequests.byTime) {\n    if (req.args.data.frame !== context.frameId) {\n      continue;\n    }\n\n    const navigation =\n        Helpers.Trace.getNavigationForTraceEvent(req, context.frameId, traceParsedData.Meta.navigationsByFrameId);\n    if (navigation?.args.data?.navigationId !== context.navigationId) {\n      continue;\n    }\n\n    if (req.args.data.renderBlocking !== 'blocking') {\n      continue;\n    }\n\n    renderBlockingRequests.push(req);\n  }\n\n  return {\n    renderBlockingRequests,\n  };\n}\n"]}

package/models/trace/insights/bundle-tsconfig.json

@@ -0,0 +1 @@
+{"compilerOptions":{"composite":true,"outDir":".","baseUrl":".","rootDir":"../../../../../../../front_end/models/trace/insights"},"files":["../../../../../../../front_end/models/trace/insights/insights.ts"],"references":[{"path":"./insights-tsconfig.json"}]}

package/models/trace/insights/devtools_entrypoint-bundle-typescript-tsconfig.json

@@ -0,0 +1,44 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "composite": true,
+    "declaration": true,
+    "experimentalDecorators": true,
+    "forceConsistentCasingInFileNames": true,
+    "inlineSources": true,
+    "lib": [
+      "esnext",
+      "dom",
+      "dom.iterable"
+    ],
+    "module": "esnext",
+    "noEmitOnError": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noUnusedLocals": false,
+    "outDir": ".",
+    "rootDir": "../../../../../../../front_end/models/trace/insights",
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "esnext",
+    "tsBuildInfoFile": "devtools_entrypoint-bundle-typescript-tsconfig.json.tsbuildinfo",
+    "typeRoots": [],
+    "useUnknownInCatchVariables": false
+  },
+  "files": [
+    "../../../../../../../front_end/models/trace/insights/insights.ts",
+    "../../../../../../../front_end/legacy/legacy-defs.d.ts",
+    "../../../../../../../front_end/global_typings/global_defs.d.ts",
+    "../../../../../../../front_end/global_typings/request_idle_callback.d.ts",
+    "../../../../../../../node_modules/@types/filesystem/index.d.ts",
+    "../../../../../../../node_modules/@webgpu/types/dist/index.d.ts"
+  ],
+  "references": [
+    {
+      "path": "./insights-tsconfig.json"
+    }
+  ]
+}

package/models/trace/insights/insights-tsconfig.json

@@ -0,0 +1,46 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "composite": true,
+    "declaration": true,
+    "experimentalDecorators": true,
+    "forceConsistentCasingInFileNames": true,
+    "inlineSources": true,
+    "lib": [
+      "esnext",
+      "dom",
+      "dom.iterable"
+    ],
+    "module": "esnext",
+    "noEmitOnError": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noUnusedLocals": false,
+    "outDir": ".",
+    "rootDir": "../../../../../../../front_end/models/trace/insights",
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "esnext",
+    "tsBuildInfoFile": "insights-tsconfig.json.tsbuildinfo",
+    "typeRoots": [],
+    "useUnknownInCatchVariables": false
+  },
+  "files": [
+    "../../../../../../../front_end/models/trace/insights/InsightRunners.ts",
+    "../../../../../../../front_end/models/trace/insights/RenderBlocking.ts",
+    "../../../../../../../front_end/models/trace/insights/types.ts",
+    "../../../../../../../front_end/legacy/legacy-defs.d.ts",
+    "../../../../../../../front_end/global_typings/global_defs.d.ts",
+    "../../../../../../../front_end/global_typings/request_idle_callback.d.ts",
+    "../../../../../../../node_modules/@types/filesystem/index.d.ts",
+    "../../../../../../../node_modules/@webgpu/types/dist/index.d.ts"
+  ],
+  "references": [
+    {
+      "path": "../handlers/bundle-tsconfig.json"
+    }
+  ]
+}

package/models/trace/insights/insights.d.ts

@@ -0,0 +1,2 @@
+export * as InsightRunners from './InsightRunners.js';
+export * as Types from './types.js';

package/models/trace/insights/insights.js

@@ -0,0 +1,6 @@
+// Copyright 2024 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 * as InsightRunners from './InsightRunners.js';
+export * as Types from './types.js';
+//# sourceMappingURL=insights.js.map

package/models/trace/insights/insights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/insights.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC","sourcesContent":["// Copyright 2024 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 * as InsightRunners from './InsightRunners.js';\nexport * as Types from './types.js';\n"]}

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

@@ -0,0 +1,33 @@
+import type * as Handlers from '../handlers/handlers.js';
+import type * as InsightsRunners from './InsightRunners.js';
+/**
+ * Context for which navigation an insight should look at.
+ */
+export interface NavigationInsightContext {
+    frameId: string;
+    navigationId: string;
+}
+type InsightRunnersType = typeof InsightsRunners;
+/**
+ * Contains insights for a specific navigation.
+ */
+export type NavigationInsightData = {
+    [I in keyof InsightRunnersType]?: ReturnType<InsightRunnersType[I]['generateInsight']>;
+};
+/**
+ * Contains insights for the entire trace. Insights are grouped by `navigationId`.
+ */
+export type TraceInsightData = Map<string, NavigationInsightData>;
+/**
+ * Maps each enabled insight name to its generate function. Insights that are disabled (i.e. missing one or more dependencies) will be unset/undefined.
+ */
+export type EnabledInsightRunners<EnabledModelHandlers extends {
+    [key: string]: Handlers.Types.TraceEventHandler;
+}> = {
+    [I in keyof InsightRunnersType]?: (traceParsedData: Handlers.Types.EnabledHandlerDataWithMeta<EnabledModelHandlers>, context: NavigationInsightContext) => ReturnType<InsightRunnersType[I]['generateInsight']>;
+};
+/**
+ * Represents the narrow set of dependencies defined by an insight's `deps()` function.
+ */
+export type RequiredData<D extends () => Array<keyof typeof Handlers.ModelHandlers>> = Pick<Handlers.Types.EnabledHandlerDataWithMeta<typeof Handlers.ModelHandlers>, ReturnType<D>[number]>;
+export {};

package/models/trace/insights/types.js

@@ -0,0 +1,5 @@
+// Copyright 2024 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 {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B","sourcesContent":["// Copyright 2024 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\nimport type * as Handlers from '../handlers/handlers.js';\n\nimport type * as InsightsRunners from './InsightRunners.js';\n\n/**\n * Context for which navigation an insight should look at.\n */\nexport interface NavigationInsightContext {\n  frameId: string;\n  navigationId: string;\n}\n\ntype InsightRunnersType = typeof InsightsRunners;\n\n/**\n * Contains insights for a specific navigation.\n */\nexport type NavigationInsightData = {\n  [I in keyof InsightRunnersType]?: ReturnType<InsightRunnersType[I]['generateInsight']>;\n};\n\n/**\n * Contains insights for the entire trace. Insights are grouped by `navigationId`.\n */\nexport type TraceInsightData = Map<string, NavigationInsightData>;\n\n/**\n * Maps each enabled insight name to its generate function. Insights that are disabled (i.e. missing one or more dependencies) will be unset/undefined.\n */\nexport type EnabledInsightRunners<EnabledModelHandlers extends {[key: string]: Handlers.Types.TraceEventHandler}> = {\n  [I in keyof InsightRunnersType]?: (\n      traceParsedData: Handlers.Types.EnabledHandlerDataWithMeta<EnabledModelHandlers>,\n      context: NavigationInsightContext) => ReturnType<InsightRunnersType[I]['generateInsight']>;\n};\n\n/**\n * Represents the narrow set of dependencies defined by an insight's `deps()` function.\n */\nexport type RequiredData<D extends() => Array<keyof typeof Handlers.ModelHandlers>> =\n    Pick<Handlers.Types.EnabledHandlerDataWithMeta<typeof Handlers.ModelHandlers>, ReturnType<D>[number]>;\n"]}

package/models/trace/trace-tsconfig.json

@@ -59,6 +59,9 @@
     {
       "path": "helpers/bundle-tsconfig.json"
     },
+    {
+      "path": "insights/bundle-tsconfig.json"
+    },
     {
       "path": "root-causes/bundle-tsconfig.json"
     },

package/models/trace/trace.d.ts

@@ -2,10 +2,11 @@ import * as EntriesFilter from './EntriesFilter.js';
 import * as Extras from './extras/extras.js';
 import * as Handlers from './handlers/handlers.js';
 import * as Helpers from './helpers/helpers.js';
+import * as Insights from './insights/insights.js';
 import * as Legacy from './LegacyTracingModel.js';
 import * as TraceModel from './ModelImpl.js';
 import * as Processor from './Processor.js';
 import * as RootCauses from './root-causes/root-causes.js';
 import * as TracingManager from './TracingManager.js';
 import * as Types from './types/types.js';
-export { EntriesFilter, Extras, Handlers, Helpers, Legacy, Processor, RootCauses, TraceModel, TracingManager, Types, };
+export { EntriesFilter, Extras, Handlers, Helpers, Insights, Legacy, Processor, RootCauses, TraceModel, TracingManager, Types, };

package/models/trace/trace.js

@@ -5,6 +5,7 @@ import * as EntriesFilter from './EntriesFilter.js';
 import * as Extras from './extras/extras.js';
 import * as Handlers from './handlers/handlers.js';
 import * as Helpers from './helpers/helpers.js';
+import * as Insights from './insights/insights.js';
 // Purposefully use a shorter name here so references to this are
 // Legacy.TracingModel.
 import * as Legacy from './LegacyTracingModel.js';
@@ -13,5 +14,5 @@ import * as Processor from './Processor.js';
 import * as RootCauses from './root-causes/root-causes.js';
 import * as TracingManager from './TracingManager.js';
 import * as Types from './types/types.js';
-export { EntriesFilter, Extras, Handlers, Helpers, Legacy, Processor, RootCauses, TraceModel, TracingManager, Types, };
+export { EntriesFilter, Extras, Handlers, Helpers, Insights, Legacy, Processor, RootCauses, TraceModel, TracingManager, Types, };
 //# sourceMappingURL=trace.js.map

package/models/trace/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../../../front_end/models/trace/trace.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,iEAAiE;AACjE,uBAAuB;AACvB,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,UAAU,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EACL,aAAa,EACb,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,SAAS,EACT,UAAU,EACV,UAAU,EACV,cAAc,EACd,KAAK,GACN,CAAC","sourcesContent":["// Copyright 2022 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\nimport * as EntriesFilter from './EntriesFilter.js';\nimport * as Extras from './extras/extras.js';\nimport * as Handlers from './handlers/handlers.js';\nimport * as Helpers from './helpers/helpers.js';\n// Purposefully use a shorter name here so references to this are\n// Legacy.TracingModel.\nimport * as Legacy from './LegacyTracingModel.js';\nimport * as TraceModel from './ModelImpl.js';\nimport * as Processor from './Processor.js';\nimport * as RootCauses from './root-causes/root-causes.js';\nimport * as TracingManager from './TracingManager.js';\nimport * as Types from './types/types.js';\n\nexport {\n  EntriesFilter,\n  Extras,\n  Handlers,\n  Helpers,\n  Legacy,\n  Processor,\n  RootCauses,\n  TraceModel,\n  TracingManager,\n  Types,\n};\n"]}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../../../front_end/models/trace/trace.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AACnD,iEAAiE;AACjE,uBAAuB;AACvB,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,UAAU,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EACL,aAAa,EACb,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,UAAU,EACV,UAAU,EACV,cAAc,EACd,KAAK,GACN,CAAC","sourcesContent":["// Copyright 2022 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\nimport * as EntriesFilter from './EntriesFilter.js';\nimport * as Extras from './extras/extras.js';\nimport * as Handlers from './handlers/handlers.js';\nimport * as Helpers from './helpers/helpers.js';\nimport * as Insights from './insights/insights.js';\n// Purposefully use a shorter name here so references to this are\n// Legacy.TracingModel.\nimport * as Legacy from './LegacyTracingModel.js';\nimport * as TraceModel from './ModelImpl.js';\nimport * as Processor from './Processor.js';\nimport * as RootCauses from './root-causes/root-causes.js';\nimport * as TracingManager from './TracingManager.js';\nimport * as Types from './types/types.js';\n\nexport {\n  EntriesFilter,\n  Extras,\n  Handlers,\n  Helpers,\n  Insights,\n  Legacy,\n  Processor,\n  RootCauses,\n  TraceModel,\n  TracingManager,\n  Types,\n};\n"]}

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

@@ -232,6 +232,7 @@ export interface SyntheticNetworkRequest extends TraceEventComplete {
             encodedDataLength: number;
             frame: string;
             fromServiceWorker: boolean;
+            isLinkPreload: boolean;
             host: string;
             mimeType: string;
             pathname: string;
@@ -244,7 +245,14 @@ export interface SyntheticNetworkRequest extends TraceEventComplete {
             requestId: string;
             requestingFrameUrl: string;
             statusCode: number;
+            resourceType: Protocol.Network.ResourceType;
+            responseHeaders: Array<{
+                name: string;
+                value: string;
+            }>;
+            fetchPriorityHint: FetchPriorityHint;
             url: string;
+            initiator?: Initiator;
             requestMethod?: string;
             timing?: TraceEventResourceReceiveResponseTimingData;
         };
@@ -582,7 +590,15 @@ export interface SyntheticLayoutShift extends TraceEventLayoutShift {
     parsedData: LayoutShiftParsedData;
 }
 export type Priority = 'Low' | 'High' | 'Medium' | 'VeryHigh' | 'Highest';
+export type FetchPriorityHint = 'low' | 'high' | 'auto';
 export type RenderBlocking = 'blocking' | 'non_blocking' | 'in_body_parser_blocking' | 'potentially_blocking';
+export interface Initiator {
+    type: Protocol.Network.InitiatorType;
+    fetchType: string;
+    columnNumber?: number;
+    lineNumber?: number;
+    url?: string;
+}
 export interface TraceEventResourceSendRequest extends TraceEventInstant {
     name: 'ResourceSendRequest';
     args: TraceEventArgs & {
@@ -591,8 +607,11 @@ export interface TraceEventResourceSendRequest extends TraceEventInstant {
             requestId: string;
             url: string;
             priority: Priority;
+            resourceType: Protocol.Network.ResourceType;
+            fetchPriorityHint: FetchPriorityHint;
             requestMethod?: string;
             renderBlocking?: RenderBlocking;
+            initiator?: Initiator;
         };
     };
 }
@@ -666,6 +685,11 @@ export interface TraceEventResourceReceiveResponse extends TraceEventInstant {
             responseTime: MilliSeconds;
             statusCode: number;
             timing: TraceEventResourceReceiveResponseTimingData;
+            isLinkPreload?: boolean;
+            headers?: Array<{
+                name: string;
+                value: string;
+            }>;
         };
     };
 }