chore: migrate src/Puppeteer to TypeScript (#5789)

* chore: migrate src/Puppeteer to TypeScript.

* fix api js

index.js

@@ -25,7 +25,7 @@ for (const className in api) {
 // Expose alias for deprecated method.
 Page.prototype.emulateMedia = Page.prototype.emulateMediaType;
 
-const Puppeteer = require('./lib/Puppeteer');
+const {Puppeteer} = require('./lib/Puppeteer');
 const packageJson = require('./package.json');
 let preferredRevision = packageJson.puppeteer.chromium_revision;
 const isPuppeteerCore = packageJson.name === 'puppeteer-core';

src/Browser.ts

@@ -20,18 +20,19 @@ import * as EventEmitter from 'events';
 import {TaskQueue} from './TaskQueue';
 import {Events} from './Events';
 import {Connection} from './Connection';
+import {ChildProcess} from 'child_process';
 
 type BrowserCloseCallback = () => Promise<void> | void;
 
 export class Browser extends EventEmitter {
-  static async create(connection: Connection, contextIds: string[], ignoreHTTPSErrors: boolean, defaultViewport?: Puppeteer.Viewport, process?: Puppeteer.ChildProcess, closeCallback?: BrowserCloseCallback): Promise<Browser> {
+  static async create(connection: Connection, contextIds: string[], ignoreHTTPSErrors: boolean, defaultViewport?: Puppeteer.Viewport, process?: ChildProcess, closeCallback?: BrowserCloseCallback): Promise<Browser> {
     const browser = new Browser(connection, contextIds, ignoreHTTPSErrors, defaultViewport, process, closeCallback);
     await connection.send('Target.setDiscoverTargets', {discover: true});
     return browser;
   }
    _ignoreHTTPSErrors: boolean;
    _defaultViewport?: Puppeteer.Viewport;
-   _process?: Puppeteer.ChildProcess;
+   _process?: ChildProcess;
    _screenshotTaskQueue = new TaskQueue();
    _connection: Connection;
    _closeCallback: BrowserCloseCallback;
@@ -40,7 +41,7 @@ export class Browser extends EventEmitter {
    // TODO: once Target is in TypeScript we can type this properly.
    _targets: Map<string, Target>;
 
-   constructor(connection: Connection, contextIds: string[], ignoreHTTPSErrors: boolean, defaultViewport?: Puppeteer.Viewport, process?: Puppeteer.ChildProcess, closeCallback?: BrowserCloseCallback) {
+   constructor(connection: Connection, contextIds: string[], ignoreHTTPSErrors: boolean, defaultViewport?: Puppeteer.Viewport, process?: ChildProcess, closeCallback?: BrowserCloseCallback) {
      super();
      this._ignoreHTTPSErrors = ignoreHTTPSErrors;
      this._defaultViewport = defaultViewport;
@@ -61,7 +62,7 @@ export class Browser extends EventEmitter {
      this._connection.on('Target.targetInfoChanged', this._targetInfoChanged.bind(this));
    }
 
-   process(): Puppeteer.ChildProcess | null {
+   process(): ChildProcess | null {
      return this._process;
    }
 

src/BrowserFetcher.ts

@@ -99,10 +99,6 @@ function existsAsync(filePath: string): Promise<boolean> {
   });
 }
 
-/**
- * @typedef {Object} BrowserFetcher.Options
- */
-
 export interface BrowserFetcherOptions {
   platform?: Platform;
   product?: string;

src/DeviceDescriptors.ts

@@ -882,7 +882,7 @@ const devices: Device[] = [
   }
 ];
 
-type DevicesMap = {
+export type DevicesMap = {
   [name: string]: Device;
 };
 
@@ -891,5 +891,4 @@ const devicesMap: DevicesMap = {};
 for (const device of devices)
   devicesMap[device.name] = device;
 
-
-export = devicesMap;
+export {devicesMap};

src/Errors.ts

@@ -23,3 +23,9 @@ class CustomError extends Error {
 }
 
 export class TimeoutError extends CustomError {}
+
+export type PuppeteerErrors = Record<string, typeof CustomError>;
+
+export const puppeteerErrors: PuppeteerErrors = {
+  TimeoutError,
+};

src/Launcher.ts

@@ -375,9 +375,6 @@ class ChromeLauncher implements ProductLauncher {
 
 }
 
-/**
- * @implements {!Puppeteer.ProductLauncher}
- */
 class FirefoxLauncher implements ProductLauncher {
   _projectRoot: string;
   _preferredRevision: string;
@@ -738,7 +735,7 @@ class FirefoxLauncher implements ProductLauncher {
 }
 
 
-function waitForWSEndpoint(browserProcess: Puppeteer.ChildProcess, timeout: number, preferredRevision: string): Promise<string> {
+function waitForWSEndpoint(browserProcess: childProcess.ChildProcess, timeout: number, preferredRevision: string): Promise<string> {
   return new Promise((resolve, reject) => {
     const rl = readline.createInterface({input: browserProcess.stderr});
     let stderr = '';