packages/benchpress/src/web_driver_extension.ts - main - githubmirror/angular

packages/benchpress/src/web_driver_extension.ts
120 строк3 KB
Joey Perrott
refactor: update license text to point to angular.dev (#57901)
24 сен 2024, 16:33
24 сен 2024, 16:339dbe6fc
/**
 * @license
 * Copyright Google LLC All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.dev/license
 */

import {InjectionToken, Injector} from '@angular/core';

import {Options} from './common_options';

export type PerfLogEvent = {
  [key: string]: any;
} & {
  ph?: 'X' | 'B' | 'E' | 'I';
  ts?: number;
  dur?: number;
  name?: string;
  pid?: string;
  args?: {
    encodedDataLength?: number;
    usedHeapSize?: number;
    gcAmount?: number;
    majorGc?: boolean;
    url?: string;
    method?: string;
  };
};

/**
 * A WebDriverExtension implements extended commands of the webdriver protocol
 * for a given browser, independent of the WebDriverAdapter.
 * Needs one implementation for every supported Browser.
 */
export abstract class WebDriverExtension {
  static provideFirstSupported(childTokens: any[]): any[] {
    const res = [
      {
        provide: _CHILDREN,
        useFactory: (injector: Injector) => childTokens.map((token) => injector.get(token)),
        deps: [Injector],
      },
      {
        provide: WebDriverExtension,
        useFactory: (children: WebDriverExtension[], capabilities: {[key: string]: any}) => {
          let delegate: WebDriverExtension = undefined!;
          children.forEach((extension) => {
            if (extension.supports(capabilities)) {
              delegate = extension;
            }
          });
          if (!delegate) {
            throw new Error('Could not find a delegate for given capabilities!');
          }
          return delegate;
        },
        deps: [_CHILDREN, Options.CAPABILITIES],
      },
    ];
    return res;
  }

  gc(): Promise<any> {
    throw new Error('NYI');
  }

  timeBegin(name: string): Promise<any> {
    throw new Error('NYI');
  }

  timeEnd(name: string, restartName: string | null): Promise<any> {
    throw new Error('NYI');
  }

  /**
   * Format:
   * - cat: category of the event
   * - name: event name: 'script', 'gc', 'render', ...
   * - ph: phase: 'B' (begin), 'E' (end), 'X' (Complete event), 'I' (Instant event)
   * - ts: timestamp in ms, e.g. 12345
   * - pid: process id
   * - args: arguments, e.g. {heapSize: 1234}
   *
   * Based on [Chrome Trace Event
   *Format](https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/edit)
   **/
  readPerfLog(): Promise<PerfLogEvent[]> {
    throw new Error('NYI');
  }

  perfLogFeatures(): PerfLogFeatures {
    throw new Error('NYI');
  }

  supports(capabilities: {[key: string]: any}): boolean {
    return true;
  }
}

export class PerfLogFeatures {
  render: boolean;
  gc: boolean;
  frameCapture: boolean;
  userTiming: boolean;

  constructor({
    render = false,
    gc = false,
    frameCapture = false,
    userTiming = false,
  }: {render?: boolean; gc?: boolean; frameCapture?: boolean; userTiming?: boolean} = {}) {
    this.render = render;
    this.gc = gc;
    this.frameCapture = frameCapture;
    this.userTiming = userTiming;
  }
}

const _CHILDREN = new InjectionToken('WebDriverExtension.children');