From ae5f2af1e2fb6ab808097ac6b05efc888a3bb3e5 Mon Sep 17 00:00:00 2001 From: Jack Franklin Date: Mon, 29 Jun 2020 11:44:57 +0100 Subject: [PATCH 1/2] chore(docs): reduce warnings when generating docs This is a bunch of small miscellaneous fixes that reduce the amount of warnings logged when generating our new docs. The long term goal is to get this list down to 0 warnings, but I'll do it in multiple PRs. --- api-extractor.json | 3 ++ new-docs/puppeteer.browserfetcher.download.md | 2 +- new-docs/puppeteer.browserfetcher.platform.md | 2 +- new-docs/puppeteer.browserfetcher.product.md | 2 +- .../puppeteer.browserfetcher.revisioninfo.md | 2 +- new-docs/puppeteer.browserfetcheroptions.md | 3 +- ...owserfetcherrevisioninfo.executablepath.md | 11 +++++++ ...r.browserfetcherrevisioninfo.folderpath.md | 11 +++++++ ...peteer.browserfetcherrevisioninfo.local.md | 11 +++++++ .../puppeteer.browserfetcherrevisioninfo.md | 24 ++++++++++++++ ...teer.browserfetcherrevisioninfo.product.md | 11 +++++++ ...eer.browserfetcherrevisioninfo.revision.md | 11 +++++++ ...uppeteer.browserfetcherrevisioninfo.url.md | 11 +++++++ ...uppeteer.browseroptions.defaultviewport.md | 11 +++++++ ...peteer.browseroptions.ignorehttpserrors.md | 11 +++++++ new-docs/puppeteer.browseroptions.md | 22 +++++++++++++ new-docs/puppeteer.browseroptions.slowmo.md | 11 +++++++ new-docs/puppeteer.chromeargoptions.args.md | 11 +++++++ .../puppeteer.chromeargoptions.devtools.md | 11 +++++++ .../puppeteer.chromeargoptions.headless.md | 11 +++++++ new-docs/puppeteer.chromeargoptions.md | 23 +++++++++++++ .../puppeteer.chromeargoptions.userdatadir.md | 11 +++++++ new-docs/puppeteer.devicesmap.md | 11 +++++++ new-docs/puppeteer.frame.click.md | 4 +-- new-docs/puppeteer.keydefinition.code.md | 11 ------- new-docs/puppeteer.keydefinition.key.md | 11 ------- new-docs/puppeteer.keydefinition.keycode.md | 11 ------- new-docs/puppeteer.keydefinition.location.md | 11 ------- new-docs/puppeteer.keydefinition.md | 33 ------------------- new-docs/puppeteer.keydefinition.shiftkey.md | 11 ------- .../puppeteer.keydefinition.shiftkeycode.md | 11 ------- new-docs/puppeteer.keydefinition.shifttext.md | 11 ------- new-docs/puppeteer.keydefinition.text.md | 11 ------- new-docs/puppeteer.keydefinitions.md | 11 ------- new-docs/puppeteer.keyinput.md | 2 ++ new-docs/puppeteer.launchoptions.dumpio.md | 11 +++++++ new-docs/puppeteer.launchoptions.env.md | 11 +++++++ .../puppeteer.launchoptions.executablepath.md | 11 +++++++ .../puppeteer.launchoptions.handlesighup.md | 11 +++++++ .../puppeteer.launchoptions.handlesigint.md | 11 +++++++ .../puppeteer.launchoptions.handlesigterm.md | 11 +++++++ ...ppeteer.launchoptions.ignoredefaultargs.md | 11 +++++++ new-docs/puppeteer.launchoptions.md | 28 ++++++++++++++++ new-docs/puppeteer.launchoptions.pipe.md | 11 +++++++ new-docs/puppeteer.launchoptions.timeout.md | 11 +++++++ new-docs/puppeteer.md | 17 +++++++--- new-docs/puppeteer.mouse._button.md | 11 ------- new-docs/puppeteer.mouse._client.md | 11 ------- new-docs/puppeteer.mouse._keyboard.md | 11 ------- new-docs/puppeteer.mouse._x.md | 11 ------- new-docs/puppeteer.mouse._y.md | 11 ------- new-docs/puppeteer.mouse.click.md | 2 +- new-docs/puppeteer.mouse.down.md | 2 +- new-docs/puppeteer.mouse.md | 10 ------ new-docs/puppeteer.mouse.up.md | 2 +- ...uttoninput.md => puppeteer.mousebutton.md} | 7 ++-- new-docs/puppeteer.mouseoptions.button.md | 11 +++++++ new-docs/puppeteer.mouseoptions.clickcount.md | 11 +++++++ new-docs/puppeteer.mouseoptions.md | 20 +++++++++++ new-docs/puppeteer.page.click.md | 4 +-- new-docs/puppeteer.platform.md | 13 ++++++++ new-docs/puppeteer.product.md | 13 ++++++++ new-docs/puppeteer.productlauncher.connect.md | 22 +++++++++++++ .../puppeteer.productlauncher.defaultargs.md | 22 +++++++++++++ ...uppeteer.productlauncher.executablepath.md | 11 +++++++ new-docs/puppeteer.productlauncher.launch.md | 22 +++++++++++++ new-docs/puppeteer.productlauncher.md | 29 ++++++++++++++++ new-docs/puppeteer.productlauncher.product.md | 11 +++++++ new-docs/puppeteer.puppeteer.connect.md | 2 +- new-docs/puppeteer.puppeteer.defaultargs.md | 2 +- new-docs/puppeteer.puppeteer.launch.md | 2 +- new-docs/puppeteer.puppeteer.md | 4 +-- new-docs/puppeteer.touchscreen._client.md | 11 ------- new-docs/puppeteer.touchscreen._keyboard.md | 11 ------- new-docs/puppeteer.touchscreen.md | 7 ---- new-docs/puppeteer.tracing.start.md | 2 +- .../puppeteer.tracingoptions.categories.md | 11 +++++++ new-docs/puppeteer.tracingoptions.md | 21 ++++++++++++ new-docs/puppeteer.tracingoptions.path.md | 11 +++++++ .../puppeteer.tracingoptions.screenshots.md | 11 +++++++ src/api-docs-entry.ts | 3 ++ src/common/DOMWorld.ts | 4 +-- src/common/FrameManager.ts | 4 +-- src/common/Input.ts | 31 ++++++++++------- src/common/Page.ts | 4 +-- src/common/Puppeteer.ts | 19 +++++------ src/common/Target.ts | 3 ++ src/common/Tracing.ts | 7 +++- src/common/USKeyboardLayout.ts | 12 +++++++ src/common/WebWorker.ts | 11 +++++-- src/node/BrowserFetcher.ts | 14 ++++++-- src/node/LaunchOptions.ts | 13 ++++++++ src/node/Launcher.ts | 17 ++++++++-- 93 files changed, 734 insertions(+), 289 deletions(-) create mode 100644 new-docs/puppeteer.browserfetcherrevisioninfo.executablepath.md create mode 100644 new-docs/puppeteer.browserfetcherrevisioninfo.folderpath.md create mode 100644 new-docs/puppeteer.browserfetcherrevisioninfo.local.md create mode 100644 new-docs/puppeteer.browserfetcherrevisioninfo.md create mode 100644 new-docs/puppeteer.browserfetcherrevisioninfo.product.md create mode 100644 new-docs/puppeteer.browserfetcherrevisioninfo.revision.md create mode 100644 new-docs/puppeteer.browserfetcherrevisioninfo.url.md create mode 100644 new-docs/puppeteer.browseroptions.defaultviewport.md create mode 100644 new-docs/puppeteer.browseroptions.ignorehttpserrors.md create mode 100644 new-docs/puppeteer.browseroptions.md create mode 100644 new-docs/puppeteer.browseroptions.slowmo.md create mode 100644 new-docs/puppeteer.chromeargoptions.args.md create mode 100644 new-docs/puppeteer.chromeargoptions.devtools.md create mode 100644 new-docs/puppeteer.chromeargoptions.headless.md create mode 100644 new-docs/puppeteer.chromeargoptions.md create mode 100644 new-docs/puppeteer.chromeargoptions.userdatadir.md create mode 100644 new-docs/puppeteer.devicesmap.md delete mode 100644 new-docs/puppeteer.keydefinition.code.md delete mode 100644 new-docs/puppeteer.keydefinition.key.md delete mode 100644 new-docs/puppeteer.keydefinition.keycode.md delete mode 100644 new-docs/puppeteer.keydefinition.location.md delete mode 100644 new-docs/puppeteer.keydefinition.md delete mode 100644 new-docs/puppeteer.keydefinition.shiftkey.md delete mode 100644 new-docs/puppeteer.keydefinition.shiftkeycode.md delete mode 100644 new-docs/puppeteer.keydefinition.shifttext.md delete mode 100644 new-docs/puppeteer.keydefinition.text.md delete mode 100644 new-docs/puppeteer.keydefinitions.md create mode 100644 new-docs/puppeteer.launchoptions.dumpio.md create mode 100644 new-docs/puppeteer.launchoptions.env.md create mode 100644 new-docs/puppeteer.launchoptions.executablepath.md create mode 100644 new-docs/puppeteer.launchoptions.handlesighup.md create mode 100644 new-docs/puppeteer.launchoptions.handlesigint.md create mode 100644 new-docs/puppeteer.launchoptions.handlesigterm.md create mode 100644 new-docs/puppeteer.launchoptions.ignoredefaultargs.md create mode 100644 new-docs/puppeteer.launchoptions.md create mode 100644 new-docs/puppeteer.launchoptions.pipe.md create mode 100644 new-docs/puppeteer.launchoptions.timeout.md delete mode 100644 new-docs/puppeteer.mouse._button.md delete mode 100644 new-docs/puppeteer.mouse._client.md delete mode 100644 new-docs/puppeteer.mouse._keyboard.md delete mode 100644 new-docs/puppeteer.mouse._x.md delete mode 100644 new-docs/puppeteer.mouse._y.md rename new-docs/{puppeteer.mousebuttoninput.md => puppeteer.mousebutton.md} (55%) create mode 100644 new-docs/puppeteer.mouseoptions.button.md create mode 100644 new-docs/puppeteer.mouseoptions.clickcount.md create mode 100644 new-docs/puppeteer.mouseoptions.md create mode 100644 new-docs/puppeteer.platform.md create mode 100644 new-docs/puppeteer.product.md create mode 100644 new-docs/puppeteer.productlauncher.connect.md create mode 100644 new-docs/puppeteer.productlauncher.defaultargs.md create mode 100644 new-docs/puppeteer.productlauncher.executablepath.md create mode 100644 new-docs/puppeteer.productlauncher.launch.md create mode 100644 new-docs/puppeteer.productlauncher.md create mode 100644 new-docs/puppeteer.productlauncher.product.md delete mode 100644 new-docs/puppeteer.touchscreen._client.md delete mode 100644 new-docs/puppeteer.touchscreen._keyboard.md create mode 100644 new-docs/puppeteer.tracingoptions.categories.md create mode 100644 new-docs/puppeteer.tracingoptions.md create mode 100644 new-docs/puppeteer.tracingoptions.path.md create mode 100644 new-docs/puppeteer.tracingoptions.screenshots.md diff --git a/api-extractor.json b/api-extractor.json index 1242d4a5de6fd..8cc8240aa41e6 100644 --- a/api-extractor.json +++ b/api-extractor.json @@ -27,6 +27,9 @@ }, "extractorMessageReporting": { + "ae-internal-missing-underscore": { + "logLevel": "none" + }, "default": { "logLevel": "warning" } diff --git a/new-docs/puppeteer.browserfetcher.download.md b/new-docs/puppeteer.browserfetcher.download.md index 15679730e6d64..81725d09ddff9 100644 --- a/new-docs/puppeteer.browserfetcher.download.md +++ b/new-docs/puppeteer.browserfetcher.download.md @@ -21,7 +21,7 @@ download(revision: string, progressCallback?: (x: number, y: number) => void): P Returns: -Promise<BrowserFetcherRevisionInfo> +Promise<[BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md)> A promise with revision information when the revision is downloaded and extracted. diff --git a/new-docs/puppeteer.browserfetcher.platform.md b/new-docs/puppeteer.browserfetcher.platform.md index 92303f46888af..84e37a79101c2 100644 --- a/new-docs/puppeteer.browserfetcher.platform.md +++ b/new-docs/puppeteer.browserfetcher.platform.md @@ -11,7 +11,7 @@ platform(): Platform; ``` Returns: -Platform +[Platform](./puppeteer.platform.md) Returns the current `Platform`. diff --git a/new-docs/puppeteer.browserfetcher.product.md b/new-docs/puppeteer.browserfetcher.product.md index 861c9b7864dcf..4066dfce915b0 100644 --- a/new-docs/puppeteer.browserfetcher.product.md +++ b/new-docs/puppeteer.browserfetcher.product.md @@ -11,7 +11,7 @@ product(): Product; ``` Returns: -Product +[Product](./puppeteer.product.md) Returns the current `Product`. diff --git a/new-docs/puppeteer.browserfetcher.revisioninfo.md b/new-docs/puppeteer.browserfetcher.revisioninfo.md index c72e30ffa3e49..88d4ecadf18d8 100644 --- a/new-docs/puppeteer.browserfetcher.revisioninfo.md +++ b/new-docs/puppeteer.browserfetcher.revisioninfo.md @@ -18,7 +18,7 @@ revisionInfo(revision: string): BrowserFetcherRevisionInfo; Returns: -BrowserFetcherRevisionInfo +[BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) The revision info for the given revision. diff --git a/new-docs/puppeteer.browserfetcheroptions.md b/new-docs/puppeteer.browserfetcheroptions.md index 71205e55d95ef..58d14dd54b39d 100644 --- a/new-docs/puppeteer.browserfetcheroptions.md +++ b/new-docs/puppeteer.browserfetcheroptions.md @@ -4,6 +4,7 @@ ## BrowserFetcherOptions interface + Signature: ```typescript @@ -16,6 +17,6 @@ export interface BrowserFetcherOptions | --- | --- | --- | | [host](./puppeteer.browserfetcheroptions.host.md) | string | | | [path](./puppeteer.browserfetcheroptions.path.md) | string | | -| [platform](./puppeteer.browserfetcheroptions.platform.md) | Platform | | +| [platform](./puppeteer.browserfetcheroptions.platform.md) | [Platform](./puppeteer.platform.md) | | | [product](./puppeteer.browserfetcheroptions.product.md) | string | | diff --git a/new-docs/puppeteer.browserfetcherrevisioninfo.executablepath.md b/new-docs/puppeteer.browserfetcherrevisioninfo.executablepath.md new file mode 100644 index 0000000000000..ef45fac9adaf0 --- /dev/null +++ b/new-docs/puppeteer.browserfetcherrevisioninfo.executablepath.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) > [executablePath](./puppeteer.browserfetcherrevisioninfo.executablepath.md) + +## BrowserFetcherRevisionInfo.executablePath property + +Signature: + +```typescript +executablePath: string; +``` diff --git a/new-docs/puppeteer.browserfetcherrevisioninfo.folderpath.md b/new-docs/puppeteer.browserfetcherrevisioninfo.folderpath.md new file mode 100644 index 0000000000000..c4ab7a5174672 --- /dev/null +++ b/new-docs/puppeteer.browserfetcherrevisioninfo.folderpath.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) > [folderPath](./puppeteer.browserfetcherrevisioninfo.folderpath.md) + +## BrowserFetcherRevisionInfo.folderPath property + +Signature: + +```typescript +folderPath: string; +``` diff --git a/new-docs/puppeteer.browserfetcherrevisioninfo.local.md b/new-docs/puppeteer.browserfetcherrevisioninfo.local.md new file mode 100644 index 0000000000000..eed4b9cb20f54 --- /dev/null +++ b/new-docs/puppeteer.browserfetcherrevisioninfo.local.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) > [local](./puppeteer.browserfetcherrevisioninfo.local.md) + +## BrowserFetcherRevisionInfo.local property + +Signature: + +```typescript +local: boolean; +``` diff --git a/new-docs/puppeteer.browserfetcherrevisioninfo.md b/new-docs/puppeteer.browserfetcherrevisioninfo.md new file mode 100644 index 0000000000000..d17fc3dfecd2f --- /dev/null +++ b/new-docs/puppeteer.browserfetcherrevisioninfo.md @@ -0,0 +1,24 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) + +## BrowserFetcherRevisionInfo interface + + +Signature: + +```typescript +export interface BrowserFetcherRevisionInfo +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [executablePath](./puppeteer.browserfetcherrevisioninfo.executablepath.md) | string | | +| [folderPath](./puppeteer.browserfetcherrevisioninfo.folderpath.md) | string | | +| [local](./puppeteer.browserfetcherrevisioninfo.local.md) | boolean | | +| [product](./puppeteer.browserfetcherrevisioninfo.product.md) | string | | +| [revision](./puppeteer.browserfetcherrevisioninfo.revision.md) | string | | +| [url](./puppeteer.browserfetcherrevisioninfo.url.md) | string | | + diff --git a/new-docs/puppeteer.browserfetcherrevisioninfo.product.md b/new-docs/puppeteer.browserfetcherrevisioninfo.product.md new file mode 100644 index 0000000000000..eb32e35bf97c3 --- /dev/null +++ b/new-docs/puppeteer.browserfetcherrevisioninfo.product.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) > [product](./puppeteer.browserfetcherrevisioninfo.product.md) + +## BrowserFetcherRevisionInfo.product property + +Signature: + +```typescript +product: string; +``` diff --git a/new-docs/puppeteer.browserfetcherrevisioninfo.revision.md b/new-docs/puppeteer.browserfetcherrevisioninfo.revision.md new file mode 100644 index 0000000000000..9fa0d1d57ccf6 --- /dev/null +++ b/new-docs/puppeteer.browserfetcherrevisioninfo.revision.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) > [revision](./puppeteer.browserfetcherrevisioninfo.revision.md) + +## BrowserFetcherRevisionInfo.revision property + +Signature: + +```typescript +revision: string; +``` diff --git a/new-docs/puppeteer.browserfetcherrevisioninfo.url.md b/new-docs/puppeteer.browserfetcherrevisioninfo.url.md new file mode 100644 index 0000000000000..aced0bfccfbec --- /dev/null +++ b/new-docs/puppeteer.browserfetcherrevisioninfo.url.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) > [url](./puppeteer.browserfetcherrevisioninfo.url.md) + +## BrowserFetcherRevisionInfo.url property + +Signature: + +```typescript +url: string; +``` diff --git a/new-docs/puppeteer.browseroptions.defaultviewport.md b/new-docs/puppeteer.browseroptions.defaultviewport.md new file mode 100644 index 0000000000000..5cb4035c05ff6 --- /dev/null +++ b/new-docs/puppeteer.browseroptions.defaultviewport.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserOptions](./puppeteer.browseroptions.md) > [defaultViewport](./puppeteer.browseroptions.defaultviewport.md) + +## BrowserOptions.defaultViewport property + +Signature: + +```typescript +defaultViewport?: Viewport; +``` diff --git a/new-docs/puppeteer.browseroptions.ignorehttpserrors.md b/new-docs/puppeteer.browseroptions.ignorehttpserrors.md new file mode 100644 index 0000000000000..a1951ddedc9c1 --- /dev/null +++ b/new-docs/puppeteer.browseroptions.ignorehttpserrors.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserOptions](./puppeteer.browseroptions.md) > [ignoreHTTPSErrors](./puppeteer.browseroptions.ignorehttpserrors.md) + +## BrowserOptions.ignoreHTTPSErrors property + +Signature: + +```typescript +ignoreHTTPSErrors?: boolean; +``` diff --git a/new-docs/puppeteer.browseroptions.md b/new-docs/puppeteer.browseroptions.md new file mode 100644 index 0000000000000..3decd6b943566 --- /dev/null +++ b/new-docs/puppeteer.browseroptions.md @@ -0,0 +1,22 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserOptions](./puppeteer.browseroptions.md) + +## BrowserOptions interface + +Generic browser options that can be passed when launching any browser. + +Signature: + +```typescript +export interface BrowserOptions +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [defaultViewport](./puppeteer.browseroptions.defaultviewport.md) | Viewport | | +| [ignoreHTTPSErrors](./puppeteer.browseroptions.ignorehttpserrors.md) | boolean | | +| [slowMo](./puppeteer.browseroptions.slowmo.md) | number | | + diff --git a/new-docs/puppeteer.browseroptions.slowmo.md b/new-docs/puppeteer.browseroptions.slowmo.md new file mode 100644 index 0000000000000..27a83884afac7 --- /dev/null +++ b/new-docs/puppeteer.browseroptions.slowmo.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [BrowserOptions](./puppeteer.browseroptions.md) > [slowMo](./puppeteer.browseroptions.slowmo.md) + +## BrowserOptions.slowMo property + +Signature: + +```typescript +slowMo?: number; +``` diff --git a/new-docs/puppeteer.chromeargoptions.args.md b/new-docs/puppeteer.chromeargoptions.args.md new file mode 100644 index 0000000000000..5ae5f7706d127 --- /dev/null +++ b/new-docs/puppeteer.chromeargoptions.args.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ChromeArgOptions](./puppeteer.chromeargoptions.md) > [args](./puppeteer.chromeargoptions.args.md) + +## ChromeArgOptions.args property + +Signature: + +```typescript +args?: string[]; +``` diff --git a/new-docs/puppeteer.chromeargoptions.devtools.md b/new-docs/puppeteer.chromeargoptions.devtools.md new file mode 100644 index 0000000000000..b1cc7c89194dd --- /dev/null +++ b/new-docs/puppeteer.chromeargoptions.devtools.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ChromeArgOptions](./puppeteer.chromeargoptions.md) > [devtools](./puppeteer.chromeargoptions.devtools.md) + +## ChromeArgOptions.devtools property + +Signature: + +```typescript +devtools?: boolean; +``` diff --git a/new-docs/puppeteer.chromeargoptions.headless.md b/new-docs/puppeteer.chromeargoptions.headless.md new file mode 100644 index 0000000000000..8636f6e67aa07 --- /dev/null +++ b/new-docs/puppeteer.chromeargoptions.headless.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ChromeArgOptions](./puppeteer.chromeargoptions.md) > [headless](./puppeteer.chromeargoptions.headless.md) + +## ChromeArgOptions.headless property + +Signature: + +```typescript +headless?: boolean; +``` diff --git a/new-docs/puppeteer.chromeargoptions.md b/new-docs/puppeteer.chromeargoptions.md new file mode 100644 index 0000000000000..27e52fd0fa1ad --- /dev/null +++ b/new-docs/puppeteer.chromeargoptions.md @@ -0,0 +1,23 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ChromeArgOptions](./puppeteer.chromeargoptions.md) + +## ChromeArgOptions interface + +Launcher options that only apply to Chrome. + +Signature: + +```typescript +export interface ChromeArgOptions +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [args](./puppeteer.chromeargoptions.args.md) | string\[\] | | +| [devtools](./puppeteer.chromeargoptions.devtools.md) | boolean | | +| [headless](./puppeteer.chromeargoptions.headless.md) | boolean | | +| [userDataDir](./puppeteer.chromeargoptions.userdatadir.md) | string | | + diff --git a/new-docs/puppeteer.chromeargoptions.userdatadir.md b/new-docs/puppeteer.chromeargoptions.userdatadir.md new file mode 100644 index 0000000000000..8d5469e240ee9 --- /dev/null +++ b/new-docs/puppeteer.chromeargoptions.userdatadir.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ChromeArgOptions](./puppeteer.chromeargoptions.md) > [userDataDir](./puppeteer.chromeargoptions.userdatadir.md) + +## ChromeArgOptions.userDataDir property + +Signature: + +```typescript +userDataDir?: string; +``` diff --git a/new-docs/puppeteer.devicesmap.md b/new-docs/puppeteer.devicesmap.md new file mode 100644 index 0000000000000..e0b069cc82c61 --- /dev/null +++ b/new-docs/puppeteer.devicesmap.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [devicesMap](./puppeteer.devicesmap.md) + +## devicesMap variable + +Signature: + +```typescript +devicesMap: DevicesMap +``` diff --git a/new-docs/puppeteer.frame.click.md b/new-docs/puppeteer.frame.click.md index 10632d573b61f..a6a205e5b266a 100644 --- a/new-docs/puppeteer.frame.click.md +++ b/new-docs/puppeteer.frame.click.md @@ -9,7 +9,7 @@ ```typescript click(selector: string, options?: { delay?: number; - button?: MouseButtonInput; + button?: MouseButton; clickCount?: number; }): Promise; ``` @@ -19,7 +19,7 @@ click(selector: string, options?: { | Parameter | Type | Description | | --- | --- | --- | | selector | string | | -| options | { delay?: number; button?: [MouseButtonInput](./puppeteer.mousebuttoninput.md); clickCount?: number; } | | +| options | { delay?: number; button?: [MouseButton](./puppeteer.mousebutton.md); clickCount?: number; } | | Returns: diff --git a/new-docs/puppeteer.keydefinition.code.md b/new-docs/puppeteer.keydefinition.code.md deleted file mode 100644 index 3f5ee83f3f63f..0000000000000 --- a/new-docs/puppeteer.keydefinition.code.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) > [code](./puppeteer.keydefinition.code.md) - -## KeyDefinition.code property - -Signature: - -```typescript -code?: string; -``` diff --git a/new-docs/puppeteer.keydefinition.key.md b/new-docs/puppeteer.keydefinition.key.md deleted file mode 100644 index f83d30beee22d..0000000000000 --- a/new-docs/puppeteer.keydefinition.key.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) > [key](./puppeteer.keydefinition.key.md) - -## KeyDefinition.key property - -Signature: - -```typescript -key?: string; -``` diff --git a/new-docs/puppeteer.keydefinition.keycode.md b/new-docs/puppeteer.keydefinition.keycode.md deleted file mode 100644 index ce43b45192f03..0000000000000 --- a/new-docs/puppeteer.keydefinition.keycode.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) > [keyCode](./puppeteer.keydefinition.keycode.md) - -## KeyDefinition.keyCode property - -Signature: - -```typescript -keyCode?: number; -``` diff --git a/new-docs/puppeteer.keydefinition.location.md b/new-docs/puppeteer.keydefinition.location.md deleted file mode 100644 index 0f0936265bf3b..0000000000000 --- a/new-docs/puppeteer.keydefinition.location.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) > [location](./puppeteer.keydefinition.location.md) - -## KeyDefinition.location property - -Signature: - -```typescript -location?: number; -``` diff --git a/new-docs/puppeteer.keydefinition.md b/new-docs/puppeteer.keydefinition.md deleted file mode 100644 index 2219ec3b0af1f..0000000000000 --- a/new-docs/puppeteer.keydefinition.md +++ /dev/null @@ -1,33 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) - -## KeyDefinition interface - -Copyright 2017 Google Inc. All rights reserved. - -Licensed under the Apache License, Version 2.0 (the 'License'); you may not use this file except in compliance with the License. You may obtain a copy of the License at - -http://www.apache.org/licenses/LICENSE-2.0 - -Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. - -Signature: - -```typescript -export interface KeyDefinition -``` - -## Properties - -| Property | Type | Description | -| --- | --- | --- | -| [code](./puppeteer.keydefinition.code.md) | string | | -| [key](./puppeteer.keydefinition.key.md) | string | | -| [keyCode](./puppeteer.keydefinition.keycode.md) | number | | -| [location](./puppeteer.keydefinition.location.md) | number | | -| [shiftKey](./puppeteer.keydefinition.shiftkey.md) | string | | -| [shiftKeyCode](./puppeteer.keydefinition.shiftkeycode.md) | number | | -| [shiftText](./puppeteer.keydefinition.shifttext.md) | string | | -| [text](./puppeteer.keydefinition.text.md) | string | | - diff --git a/new-docs/puppeteer.keydefinition.shiftkey.md b/new-docs/puppeteer.keydefinition.shiftkey.md deleted file mode 100644 index 5fb41b7e96efc..0000000000000 --- a/new-docs/puppeteer.keydefinition.shiftkey.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) > [shiftKey](./puppeteer.keydefinition.shiftkey.md) - -## KeyDefinition.shiftKey property - -Signature: - -```typescript -shiftKey?: string; -``` diff --git a/new-docs/puppeteer.keydefinition.shiftkeycode.md b/new-docs/puppeteer.keydefinition.shiftkeycode.md deleted file mode 100644 index fedf0de3bbae8..0000000000000 --- a/new-docs/puppeteer.keydefinition.shiftkeycode.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) > [shiftKeyCode](./puppeteer.keydefinition.shiftkeycode.md) - -## KeyDefinition.shiftKeyCode property - -Signature: - -```typescript -shiftKeyCode?: number; -``` diff --git a/new-docs/puppeteer.keydefinition.shifttext.md b/new-docs/puppeteer.keydefinition.shifttext.md deleted file mode 100644 index 1a3d6c30676c6..0000000000000 --- a/new-docs/puppeteer.keydefinition.shifttext.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) > [shiftText](./puppeteer.keydefinition.shifttext.md) - -## KeyDefinition.shiftText property - -Signature: - -```typescript -shiftText?: string; -``` diff --git a/new-docs/puppeteer.keydefinition.text.md b/new-docs/puppeteer.keydefinition.text.md deleted file mode 100644 index b98af18f456fb..0000000000000 --- a/new-docs/puppeteer.keydefinition.text.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [KeyDefinition](./puppeteer.keydefinition.md) > [text](./puppeteer.keydefinition.text.md) - -## KeyDefinition.text property - -Signature: - -```typescript -text?: string; -``` diff --git a/new-docs/puppeteer.keydefinitions.md b/new-docs/puppeteer.keydefinitions.md deleted file mode 100644 index 601076fbe815b..0000000000000 --- a/new-docs/puppeteer.keydefinitions.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [keyDefinitions](./puppeteer.keydefinitions.md) - -## keyDefinitions variable - -Signature: - -```typescript -keyDefinitions: Readonly> -``` diff --git a/new-docs/puppeteer.keyinput.md b/new-docs/puppeteer.keyinput.md index 0ff88697c55c8..428dfc5865db4 100644 --- a/new-docs/puppeteer.keyinput.md +++ b/new-docs/puppeteer.keyinput.md @@ -4,6 +4,8 @@ ## KeyInput type +All the valid keys that can be passed to functions that take user input, such as [keyboard.press](./puppeteer.keyboard.press.md) + Signature: ```typescript diff --git a/new-docs/puppeteer.launchoptions.dumpio.md b/new-docs/puppeteer.launchoptions.dumpio.md new file mode 100644 index 0000000000000..5440814228748 --- /dev/null +++ b/new-docs/puppeteer.launchoptions.dumpio.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [dumpio](./puppeteer.launchoptions.dumpio.md) + +## LaunchOptions.dumpio property + +Signature: + +```typescript +dumpio?: boolean; +``` diff --git a/new-docs/puppeteer.launchoptions.env.md b/new-docs/puppeteer.launchoptions.env.md new file mode 100644 index 0000000000000..ae14781a3fe89 --- /dev/null +++ b/new-docs/puppeteer.launchoptions.env.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [env](./puppeteer.launchoptions.env.md) + +## LaunchOptions.env property + +Signature: + +```typescript +env?: Record; +``` diff --git a/new-docs/puppeteer.launchoptions.executablepath.md b/new-docs/puppeteer.launchoptions.executablepath.md new file mode 100644 index 0000000000000..62c61a57a9a34 --- /dev/null +++ b/new-docs/puppeteer.launchoptions.executablepath.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [executablePath](./puppeteer.launchoptions.executablepath.md) + +## LaunchOptions.executablePath property + +Signature: + +```typescript +executablePath?: string; +``` diff --git a/new-docs/puppeteer.launchoptions.handlesighup.md b/new-docs/puppeteer.launchoptions.handlesighup.md new file mode 100644 index 0000000000000..92c0427cc1aa0 --- /dev/null +++ b/new-docs/puppeteer.launchoptions.handlesighup.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [handleSIGHUP](./puppeteer.launchoptions.handlesighup.md) + +## LaunchOptions.handleSIGHUP property + +Signature: + +```typescript +handleSIGHUP?: boolean; +``` diff --git a/new-docs/puppeteer.launchoptions.handlesigint.md b/new-docs/puppeteer.launchoptions.handlesigint.md new file mode 100644 index 0000000000000..d6521475bccbd --- /dev/null +++ b/new-docs/puppeteer.launchoptions.handlesigint.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [handleSIGINT](./puppeteer.launchoptions.handlesigint.md) + +## LaunchOptions.handleSIGINT property + +Signature: + +```typescript +handleSIGINT?: boolean; +``` diff --git a/new-docs/puppeteer.launchoptions.handlesigterm.md b/new-docs/puppeteer.launchoptions.handlesigterm.md new file mode 100644 index 0000000000000..a8c7083e5fb5f --- /dev/null +++ b/new-docs/puppeteer.launchoptions.handlesigterm.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [handleSIGTERM](./puppeteer.launchoptions.handlesigterm.md) + +## LaunchOptions.handleSIGTERM property + +Signature: + +```typescript +handleSIGTERM?: boolean; +``` diff --git a/new-docs/puppeteer.launchoptions.ignoredefaultargs.md b/new-docs/puppeteer.launchoptions.ignoredefaultargs.md new file mode 100644 index 0000000000000..4ebdfed2104ab --- /dev/null +++ b/new-docs/puppeteer.launchoptions.ignoredefaultargs.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [ignoreDefaultArgs](./puppeteer.launchoptions.ignoredefaultargs.md) + +## LaunchOptions.ignoreDefaultArgs property + +Signature: + +```typescript +ignoreDefaultArgs?: boolean | string[]; +``` diff --git a/new-docs/puppeteer.launchoptions.md b/new-docs/puppeteer.launchoptions.md new file mode 100644 index 0000000000000..3cef90e7227c3 --- /dev/null +++ b/new-docs/puppeteer.launchoptions.md @@ -0,0 +1,28 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) + +## LaunchOptions interface + +Generic launch options that can be passed when launching any browser. + +Signature: + +```typescript +export interface LaunchOptions +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [dumpio](./puppeteer.launchoptions.dumpio.md) | boolean | | +| [env](./puppeteer.launchoptions.env.md) | Record<string, string \| undefined> | | +| [executablePath](./puppeteer.launchoptions.executablepath.md) | string | | +| [handleSIGHUP](./puppeteer.launchoptions.handlesighup.md) | boolean | | +| [handleSIGINT](./puppeteer.launchoptions.handlesigint.md) | boolean | | +| [handleSIGTERM](./puppeteer.launchoptions.handlesigterm.md) | boolean | | +| [ignoreDefaultArgs](./puppeteer.launchoptions.ignoredefaultargs.md) | boolean \| string\[\] | | +| [pipe](./puppeteer.launchoptions.pipe.md) | boolean | | +| [timeout](./puppeteer.launchoptions.timeout.md) | number | | + diff --git a/new-docs/puppeteer.launchoptions.pipe.md b/new-docs/puppeteer.launchoptions.pipe.md new file mode 100644 index 0000000000000..36167d158bb75 --- /dev/null +++ b/new-docs/puppeteer.launchoptions.pipe.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [pipe](./puppeteer.launchoptions.pipe.md) + +## LaunchOptions.pipe property + +Signature: + +```typescript +pipe?: boolean; +``` diff --git a/new-docs/puppeteer.launchoptions.timeout.md b/new-docs/puppeteer.launchoptions.timeout.md new file mode 100644 index 0000000000000..bbba4d7a277dc --- /dev/null +++ b/new-docs/puppeteer.launchoptions.timeout.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [LaunchOptions](./puppeteer.launchoptions.md) > [timeout](./puppeteer.launchoptions.timeout.md) + +## LaunchOptions.timeout property + +Signature: + +```typescript +timeout?: number; +``` diff --git a/new-docs/puppeteer.md b/new-docs/puppeteer.md index 9e0f572d7618a..77d6622a10a90 100644 --- a/new-docs/puppeteer.md +++ b/new-docs/puppeteer.md @@ -50,6 +50,9 @@ | [BoundingBox](./puppeteer.boundingbox.md) | | | [BoxModel](./puppeteer.boxmodel.md) | | | [BrowserFetcherOptions](./puppeteer.browserfetcheroptions.md) | | +| [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) | | +| [BrowserOptions](./puppeteer.browseroptions.md) | Generic browser options that can be passed when launching any browser. | +| [ChromeArgOptions](./puppeteer.chromeargoptions.md) | Launcher options that only apply to Chrome. | | [ClickOptions](./puppeteer.clickoptions.md) | | | [ConsoleMessageLocation](./puppeteer.consolemessagelocation.md) | | | [CoverageEntry](./puppeteer.coverageentry.md) | The CoverageEntry class represents one entry of the coverage report. | @@ -57,12 +60,15 @@ | [GeolocationOptions](./puppeteer.geolocationoptions.md) | | | [JSCoverageOptions](./puppeteer.jscoverageoptions.md) | Set of configurable options for JS coverage. | | [JSONObject](./puppeteer.jsonobject.md) | | -| [KeyDefinition](./puppeteer.keydefinition.md) | Copyright 2017 Google Inc. All rights reserved.Licensed under the Apache License, Version 2.0 (the 'License'); you may not use this file except in compliance with the License. You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. | +| [LaunchOptions](./puppeteer.launchoptions.md) | Generic launch options that can be passed when launching any browser. | | [Metrics](./puppeteer.metrics.md) | | +| [MouseOptions](./puppeteer.mouseoptions.md) | | | [PressOptions](./puppeteer.pressoptions.md) | | +| [ProductLauncher](./puppeteer.productlauncher.md) | Describes a launcher - a class that is able to create and launch a browser instance. | | [RemoteAddress](./puppeteer.remoteaddress.md) | | | [SerializedAXNode](./puppeteer.serializedaxnode.md) | Represents a Node and the properties of it that are relevant to Accessibility. | | [SnapshotOptions](./puppeteer.snapshotoptions.md) | | +| [TracingOptions](./puppeteer.tracingoptions.md) | | | [WaitForOptions](./puppeteer.waitforoptions.md) | | | [WaitForTargetOptions](./puppeteer.waitfortargetoptions.md) | | | [WaitTimeoutOptions](./puppeteer.waittimeoutoptions.md) | | @@ -71,8 +77,8 @@ | Variable | Description | | --- | --- | +| [devicesMap](./puppeteer.devicesmap.md) | | | [EVALUATION\_SCRIPT\_URL](./puppeteer.evaluation_script_url.md) | | -| [keyDefinitions](./puppeteer.keydefinitions.md) | | | [puppeteerErrors](./puppeteer.puppeteererrors.md) | | ## Type Aliases @@ -80,12 +86,15 @@ | Type Alias | Description | | --- | --- | | [ConsoleMessageType](./puppeteer.consolemessagetype.md) | The supported types for console messages. | +| [DevicesMap](./puppeteer.devicesmap.md) | | | [EvaluateFn](./puppeteer.evaluatefn.md) | | | [EvaluateFnReturnType](./puppeteer.evaluatefnreturntype.md) | | | [EvaluateHandleFn](./puppeteer.evaluatehandlefn.md) | | | [JSONArray](./puppeteer.jsonarray.md) | | -| [KeyInput](./puppeteer.keyinput.md) | | -| [MouseButtonInput](./puppeteer.mousebuttoninput.md) | | +| [KeyInput](./puppeteer.keyinput.md) | All the valid keys that can be passed to functions that take user input, such as [keyboard.press](./puppeteer.keyboard.press.md) | +| [MouseButton](./puppeteer.mousebutton.md) | | +| [Platform](./puppeteer.platform.md) | Supported platforms. | +| [Product](./puppeteer.product.md) | Supported products. | | [PuppeteerErrors](./puppeteer.puppeteererrors.md) | | | [Serializable](./puppeteer.serializable.md) | | | [SerializableOrJSHandle](./puppeteer.serializableorjshandle.md) | | diff --git a/new-docs/puppeteer.mouse._button.md b/new-docs/puppeteer.mouse._button.md deleted file mode 100644 index eec43f862cc31..0000000000000 --- a/new-docs/puppeteer.mouse._button.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [Mouse](./puppeteer.mouse.md) > [\_button](./puppeteer.mouse._button.md) - -## Mouse.\_button property - -Signature: - -```typescript -_button: MouseButton; -``` diff --git a/new-docs/puppeteer.mouse._client.md b/new-docs/puppeteer.mouse._client.md deleted file mode 100644 index 7c4de7315fe6a..0000000000000 --- a/new-docs/puppeteer.mouse._client.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [Mouse](./puppeteer.mouse.md) > [\_client](./puppeteer.mouse._client.md) - -## Mouse.\_client property - -Signature: - -```typescript -_client: CDPSession; -``` diff --git a/new-docs/puppeteer.mouse._keyboard.md b/new-docs/puppeteer.mouse._keyboard.md deleted file mode 100644 index db7b2e2b5e7e2..0000000000000 --- a/new-docs/puppeteer.mouse._keyboard.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [Mouse](./puppeteer.mouse.md) > [\_keyboard](./puppeteer.mouse._keyboard.md) - -## Mouse.\_keyboard property - -Signature: - -```typescript -_keyboard: Keyboard; -``` diff --git a/new-docs/puppeteer.mouse._x.md b/new-docs/puppeteer.mouse._x.md deleted file mode 100644 index cfedc193f9991..0000000000000 --- a/new-docs/puppeteer.mouse._x.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [Mouse](./puppeteer.mouse.md) > [\_x](./puppeteer.mouse._x.md) - -## Mouse.\_x property - -Signature: - -```typescript -_x: number; -``` diff --git a/new-docs/puppeteer.mouse._y.md b/new-docs/puppeteer.mouse._y.md deleted file mode 100644 index a6200285366b1..0000000000000 --- a/new-docs/puppeteer.mouse._y.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [Mouse](./puppeteer.mouse.md) > [\_y](./puppeteer.mouse._y.md) - -## Mouse.\_y property - -Signature: - -```typescript -_y: number; -``` diff --git a/new-docs/puppeteer.mouse.click.md b/new-docs/puppeteer.mouse.click.md index 4fa9645f800a6..adc356baf500f 100644 --- a/new-docs/puppeteer.mouse.click.md +++ b/new-docs/puppeteer.mouse.click.md @@ -20,7 +20,7 @@ click(x: number, y: number, options?: MouseOptions & { | --- | --- | --- | | x | number | Horizontal position of the mouse. | | y | number | Vertical position of the mouse. | -| options | MouseOptions & { delay?: number; } | Optional MouseOptions. | +| options | [MouseOptions](./puppeteer.mouseoptions.md) & { delay?: number; } | Optional MouseOptions. | Returns: diff --git a/new-docs/puppeteer.mouse.down.md b/new-docs/puppeteer.mouse.down.md index b4c0f4641eb1f..ac3b6a6317bbe 100644 --- a/new-docs/puppeteer.mouse.down.md +++ b/new-docs/puppeteer.mouse.down.md @@ -16,7 +16,7 @@ down(options?: MouseOptions): Promise; | Parameter | Type | Description | | --- | --- | --- | -| options | MouseOptions | Optional MouseOptions. | +| options | [MouseOptions](./puppeteer.mouseoptions.md) | Optional MouseOptions. | Returns: diff --git a/new-docs/puppeteer.mouse.md b/new-docs/puppeteer.mouse.md index a3ecd2b305138..8a5044cab0017 100644 --- a/new-docs/puppeteer.mouse.md +++ b/new-docs/puppeteer.mouse.md @@ -73,16 +73,6 @@ await browser.defaultBrowserContext().overridePermissions( ``` -## Properties - -| Property | Modifiers | Type | Description | -| --- | --- | --- | --- | -| [\_button](./puppeteer.mouse._button.md) | | MouseButton | | -| [\_client](./puppeteer.mouse._client.md) | | [CDPSession](./puppeteer.cdpsession.md) | | -| [\_keyboard](./puppeteer.mouse._keyboard.md) | | [Keyboard](./puppeteer.keyboard.md) | | -| [\_x](./puppeteer.mouse._x.md) | | number | | -| [\_y](./puppeteer.mouse._y.md) | | number | | - ## Methods | Method | Modifiers | Description | diff --git a/new-docs/puppeteer.mouse.up.md b/new-docs/puppeteer.mouse.up.md index d8a4071fdf90f..b85abd625192a 100644 --- a/new-docs/puppeteer.mouse.up.md +++ b/new-docs/puppeteer.mouse.up.md @@ -16,7 +16,7 @@ up(options?: MouseOptions): Promise; | Parameter | Type | Description | | --- | --- | --- | -| options | MouseOptions | Optional MouseOptions. | +| options | [MouseOptions](./puppeteer.mouseoptions.md) | Optional MouseOptions. | Returns: diff --git a/new-docs/puppeteer.mousebuttoninput.md b/new-docs/puppeteer.mousebutton.md similarity index 55% rename from new-docs/puppeteer.mousebuttoninput.md rename to new-docs/puppeteer.mousebutton.md index af8eb1803e646..e9f29aca333d8 100644 --- a/new-docs/puppeteer.mousebuttoninput.md +++ b/new-docs/puppeteer.mousebutton.md @@ -1,11 +1,12 @@ -[Home](./index.md) > [puppeteer](./puppeteer.md) > [MouseButtonInput](./puppeteer.mousebuttoninput.md) +[Home](./index.md) > [puppeteer](./puppeteer.md) > [MouseButton](./puppeteer.mousebutton.md) + +## MouseButton type -## MouseButtonInput type Signature: ```typescript -export declare type MouseButtonInput = Exclude; +export declare type MouseButton = 'left' | 'right' | 'middle'; ``` diff --git a/new-docs/puppeteer.mouseoptions.button.md b/new-docs/puppeteer.mouseoptions.button.md new file mode 100644 index 0000000000000..ba9dfec83498f --- /dev/null +++ b/new-docs/puppeteer.mouseoptions.button.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [MouseOptions](./puppeteer.mouseoptions.md) > [button](./puppeteer.mouseoptions.button.md) + +## MouseOptions.button property + +Signature: + +```typescript +button?: MouseButton; +``` diff --git a/new-docs/puppeteer.mouseoptions.clickcount.md b/new-docs/puppeteer.mouseoptions.clickcount.md new file mode 100644 index 0000000000000..799e1b299a00e --- /dev/null +++ b/new-docs/puppeteer.mouseoptions.clickcount.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [MouseOptions](./puppeteer.mouseoptions.md) > [clickCount](./puppeteer.mouseoptions.clickcount.md) + +## MouseOptions.clickCount property + +Signature: + +```typescript +clickCount?: number; +``` diff --git a/new-docs/puppeteer.mouseoptions.md b/new-docs/puppeteer.mouseoptions.md new file mode 100644 index 0000000000000..897c185af1a66 --- /dev/null +++ b/new-docs/puppeteer.mouseoptions.md @@ -0,0 +1,20 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [MouseOptions](./puppeteer.mouseoptions.md) + +## MouseOptions interface + + +Signature: + +```typescript +export interface MouseOptions +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [button](./puppeteer.mouseoptions.button.md) | [MouseButton](./puppeteer.mousebutton.md) | | +| [clickCount](./puppeteer.mouseoptions.clickcount.md) | number | | + diff --git a/new-docs/puppeteer.page.click.md b/new-docs/puppeteer.page.click.md index 62317e8f84204..3366641dd27ed 100644 --- a/new-docs/puppeteer.page.click.md +++ b/new-docs/puppeteer.page.click.md @@ -9,7 +9,7 @@ ```typescript click(selector: string, options?: { delay?: number; - button?: MouseButtonInput; + button?: MouseButton; clickCount?: number; }): Promise; ``` @@ -19,7 +19,7 @@ click(selector: string, options?: { | Parameter | Type | Description | | --- | --- | --- | | selector | string | | -| options | { delay?: number; button?: [MouseButtonInput](./puppeteer.mousebuttoninput.md); clickCount?: number; } | | +| options | { delay?: number; button?: [MouseButton](./puppeteer.mousebutton.md); clickCount?: number; } | | Returns: diff --git a/new-docs/puppeteer.platform.md b/new-docs/puppeteer.platform.md new file mode 100644 index 0000000000000..03e8b72dbd427 --- /dev/null +++ b/new-docs/puppeteer.platform.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [Platform](./puppeteer.platform.md) + +## Platform type + +Supported platforms. + +Signature: + +```typescript +export declare type Platform = 'linux' | 'mac' | 'win32' | 'win64'; +``` diff --git a/new-docs/puppeteer.product.md b/new-docs/puppeteer.product.md new file mode 100644 index 0000000000000..1d7e0c025b71d --- /dev/null +++ b/new-docs/puppeteer.product.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [Product](./puppeteer.product.md) + +## Product type + +Supported products. + +Signature: + +```typescript +export declare type Product = 'chrome' | 'firefox'; +``` diff --git a/new-docs/puppeteer.productlauncher.connect.md b/new-docs/puppeteer.productlauncher.connect.md new file mode 100644 index 0000000000000..6837409efe93a --- /dev/null +++ b/new-docs/puppeteer.productlauncher.connect.md @@ -0,0 +1,22 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ProductLauncher](./puppeteer.productlauncher.md) > [connect](./puppeteer.productlauncher.connect.md) + +## ProductLauncher.connect() method + +Signature: + +```typescript +connect(object: any): any; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| object | any | | + +Returns: + +any + diff --git a/new-docs/puppeteer.productlauncher.defaultargs.md b/new-docs/puppeteer.productlauncher.defaultargs.md new file mode 100644 index 0000000000000..be1009e3b63ac --- /dev/null +++ b/new-docs/puppeteer.productlauncher.defaultargs.md @@ -0,0 +1,22 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ProductLauncher](./puppeteer.productlauncher.md) > [defaultArgs](./puppeteer.productlauncher.defaultargs.md) + +## ProductLauncher.defaultArgs() method + +Signature: + +```typescript +defaultArgs(object: any): any; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| object | any | | + +Returns: + +any + diff --git a/new-docs/puppeteer.productlauncher.executablepath.md b/new-docs/puppeteer.productlauncher.executablepath.md new file mode 100644 index 0000000000000..ac30111cc356e --- /dev/null +++ b/new-docs/puppeteer.productlauncher.executablepath.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ProductLauncher](./puppeteer.productlauncher.md) > [executablePath](./puppeteer.productlauncher.executablepath.md) + +## ProductLauncher.executablePath property + +Signature: + +```typescript +executablePath: () => string; +``` diff --git a/new-docs/puppeteer.productlauncher.launch.md b/new-docs/puppeteer.productlauncher.launch.md new file mode 100644 index 0000000000000..cfe35879a0ea7 --- /dev/null +++ b/new-docs/puppeteer.productlauncher.launch.md @@ -0,0 +1,22 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ProductLauncher](./puppeteer.productlauncher.md) > [launch](./puppeteer.productlauncher.launch.md) + +## ProductLauncher.launch() method + +Signature: + +```typescript +launch(object: any): any; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| object | any | | + +Returns: + +any + diff --git a/new-docs/puppeteer.productlauncher.md b/new-docs/puppeteer.productlauncher.md new file mode 100644 index 0000000000000..4f3dc6fa3c3b8 --- /dev/null +++ b/new-docs/puppeteer.productlauncher.md @@ -0,0 +1,29 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ProductLauncher](./puppeteer.productlauncher.md) + +## ProductLauncher interface + +Describes a launcher - a class that is able to create and launch a browser instance. + +Signature: + +```typescript +export interface ProductLauncher +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [executablePath](./puppeteer.productlauncher.executablepath.md) | () => string | | +| [product](./puppeteer.productlauncher.product.md) | string | | + +## Methods + +| Method | Description | +| --- | --- | +| [connect(object)](./puppeteer.productlauncher.connect.md) | | +| [defaultArgs(object)](./puppeteer.productlauncher.defaultargs.md) | | +| [launch(object)](./puppeteer.productlauncher.launch.md) | | + diff --git a/new-docs/puppeteer.productlauncher.product.md b/new-docs/puppeteer.productlauncher.product.md new file mode 100644 index 0000000000000..6d906bad253c4 --- /dev/null +++ b/new-docs/puppeteer.productlauncher.product.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [ProductLauncher](./puppeteer.productlauncher.md) > [product](./puppeteer.productlauncher.product.md) + +## ProductLauncher.product property + +Signature: + +```typescript +product: string; +``` diff --git a/new-docs/puppeteer.puppeteer.connect.md b/new-docs/puppeteer.puppeteer.connect.md index 6431e3848f958..7e99b6081c049 100644 --- a/new-docs/puppeteer.puppeteer.connect.md +++ b/new-docs/puppeteer.puppeteer.connect.md @@ -21,7 +21,7 @@ connect(options: BrowserOptions & { | Parameter | Type | Description | | --- | --- | --- | -| options | BrowserOptions & { browserWSEndpoint?: string; browserURL?: string; transport?: ConnectionTransport; product?: string; } | Set of configurable options to set on the browser. | +| options | [BrowserOptions](./puppeteer.browseroptions.md) & { browserWSEndpoint?: string; browserURL?: string; transport?: ConnectionTransport; product?: string; } | Set of configurable options to set on the browser. | Returns: diff --git a/new-docs/puppeteer.puppeteer.defaultargs.md b/new-docs/puppeteer.puppeteer.defaultargs.md index f7e8cc269dfb9..007d602a25c5a 100644 --- a/new-docs/puppeteer.puppeteer.defaultargs.md +++ b/new-docs/puppeteer.puppeteer.defaultargs.md @@ -14,7 +14,7 @@ defaultArgs(options?: ChromeArgOptions): string[]; | Parameter | Type | Description | | --- | --- | --- | -| options | ChromeArgOptions | Set of configurable options to set on the browser. | +| options | [ChromeArgOptions](./puppeteer.chromeargoptions.md) | Set of configurable options to set on the browser. | Returns: diff --git a/new-docs/puppeteer.puppeteer.launch.md b/new-docs/puppeteer.puppeteer.launch.md index 604cca0bc6afa..e68a4004afa10 100644 --- a/new-docs/puppeteer.puppeteer.launch.md +++ b/new-docs/puppeteer.puppeteer.launch.md @@ -19,7 +19,7 @@ launch(options?: LaunchOptions & ChromeArgOptions & BrowserOptions & { | Parameter | Type | Description | | --- | --- | --- | -| options | LaunchOptions & ChromeArgOptions & BrowserOptions & { product?: string; extraPrefsFirefox?: {}; } | Set of configurable options to set on the browser. | +| options | [LaunchOptions](./puppeteer.launchoptions.md) & [ChromeArgOptions](./puppeteer.chromeargoptions.md) & [BrowserOptions](./puppeteer.browseroptions.md) & { product?: string; extraPrefsFirefox?: {}; } | Set of configurable options to set on the browser. | Returns: diff --git a/new-docs/puppeteer.puppeteer.md b/new-docs/puppeteer.puppeteer.md index e96e126c0bb3d..eb0adb5cc61a2 100644 --- a/new-docs/puppeteer.puppeteer.md +++ b/new-docs/puppeteer.puppeteer.md @@ -40,9 +40,9 @@ const puppeteer = require('puppeteer'); | [\_\_productName](./puppeteer.puppeteer.__productname.md) | | string | | | [\_changedProduct](./puppeteer.puppeteer._changedproduct.md) | | boolean | | | [\_isPuppeteerCore](./puppeteer.puppeteer._ispuppeteercore.md) | | boolean | | -| [\_lazyLauncher](./puppeteer.puppeteer._lazylauncher.md) | | ProductLauncher | | +| [\_lazyLauncher](./puppeteer.puppeteer._lazylauncher.md) | | [ProductLauncher](./puppeteer.productlauncher.md) | | | [\_preferredRevision](./puppeteer.puppeteer._preferredrevision.md) | | string | | -| [devices](./puppeteer.puppeteer.devices.md) | | DevicesMap | | +| [devices](./puppeteer.puppeteer.devices.md) | | [DevicesMap](./puppeteer.devicesmap.md) | | | [errors](./puppeteer.puppeteer.errors.md) | | [PuppeteerErrors](./puppeteer.puppeteererrors.md) | | | [product](./puppeteer.puppeteer.product.md) | | string | | diff --git a/new-docs/puppeteer.touchscreen._client.md b/new-docs/puppeteer.touchscreen._client.md deleted file mode 100644 index c0e1f1ca845e2..0000000000000 --- a/new-docs/puppeteer.touchscreen._client.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [Touchscreen](./puppeteer.touchscreen.md) > [\_client](./puppeteer.touchscreen._client.md) - -## Touchscreen.\_client property - -Signature: - -```typescript -_client: CDPSession; -``` diff --git a/new-docs/puppeteer.touchscreen._keyboard.md b/new-docs/puppeteer.touchscreen._keyboard.md deleted file mode 100644 index b40e94d320df6..0000000000000 --- a/new-docs/puppeteer.touchscreen._keyboard.md +++ /dev/null @@ -1,11 +0,0 @@ - - -[Home](./index.md) > [puppeteer](./puppeteer.md) > [Touchscreen](./puppeteer.touchscreen.md) > [\_keyboard](./puppeteer.touchscreen._keyboard.md) - -## Touchscreen.\_keyboard property - -Signature: - -```typescript -_keyboard: Keyboard; -``` diff --git a/new-docs/puppeteer.touchscreen.md b/new-docs/puppeteer.touchscreen.md index e1f7d85208304..5a079e2b7930b 100644 --- a/new-docs/puppeteer.touchscreen.md +++ b/new-docs/puppeteer.touchscreen.md @@ -16,13 +16,6 @@ export declare class Touchscreen The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `Touchscreen` class. -## Properties - -| Property | Modifiers | Type | Description | -| --- | --- | --- | --- | -| [\_client](./puppeteer.touchscreen._client.md) | | [CDPSession](./puppeteer.cdpsession.md) | | -| [\_keyboard](./puppeteer.touchscreen._keyboard.md) | | [Keyboard](./puppeteer.keyboard.md) | | - ## Methods | Method | Modifiers | Description | diff --git a/new-docs/puppeteer.tracing.start.md b/new-docs/puppeteer.tracing.start.md index 5765163397440..bc8a0b7e00fe9 100644 --- a/new-docs/puppeteer.tracing.start.md +++ b/new-docs/puppeteer.tracing.start.md @@ -16,7 +16,7 @@ start(options?: TracingOptions): Promise; | Parameter | Type | Description | | --- | --- | --- | -| options | TracingOptions | Optional TracingOptions. | +| options | [TracingOptions](./puppeteer.tracingoptions.md) | Optional TracingOptions. | Returns: diff --git a/new-docs/puppeteer.tracingoptions.categories.md b/new-docs/puppeteer.tracingoptions.categories.md new file mode 100644 index 0000000000000..1e86ea4729c59 --- /dev/null +++ b/new-docs/puppeteer.tracingoptions.categories.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [TracingOptions](./puppeteer.tracingoptions.md) > [categories](./puppeteer.tracingoptions.categories.md) + +## TracingOptions.categories property + +Signature: + +```typescript +categories?: string[]; +``` diff --git a/new-docs/puppeteer.tracingoptions.md b/new-docs/puppeteer.tracingoptions.md new file mode 100644 index 0000000000000..07bd1e046076f --- /dev/null +++ b/new-docs/puppeteer.tracingoptions.md @@ -0,0 +1,21 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [TracingOptions](./puppeteer.tracingoptions.md) + +## TracingOptions interface + + +Signature: + +```typescript +export interface TracingOptions +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [categories](./puppeteer.tracingoptions.categories.md) | string\[\] | | +| [path](./puppeteer.tracingoptions.path.md) | string | | +| [screenshots](./puppeteer.tracingoptions.screenshots.md) | boolean | | + diff --git a/new-docs/puppeteer.tracingoptions.path.md b/new-docs/puppeteer.tracingoptions.path.md new file mode 100644 index 0000000000000..be6b909018252 --- /dev/null +++ b/new-docs/puppeteer.tracingoptions.path.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [TracingOptions](./puppeteer.tracingoptions.md) > [path](./puppeteer.tracingoptions.path.md) + +## TracingOptions.path property + +Signature: + +```typescript +path?: string; +``` diff --git a/new-docs/puppeteer.tracingoptions.screenshots.md b/new-docs/puppeteer.tracingoptions.screenshots.md new file mode 100644 index 0000000000000..39a0f913f62d3 --- /dev/null +++ b/new-docs/puppeteer.tracingoptions.screenshots.md @@ -0,0 +1,11 @@ + + +[Home](./index.md) > [puppeteer](./puppeteer.md) > [TracingOptions](./puppeteer.tracingoptions.md) > [screenshots](./puppeteer.tracingoptions.screenshots.md) + +## TracingOptions.screenshots property + +Signature: + +```typescript +screenshots?: boolean; +``` diff --git a/src/api-docs-entry.ts b/src/api-docs-entry.ts index 4a04e31cfd683..f49087640e501 100644 --- a/src/api-docs-entry.ts +++ b/src/api-docs-entry.ts @@ -31,6 +31,7 @@ export * from './node/BrowserFetcher'; export * from './common/Connection'; export * from './common/ConsoleMessage'; export * from './common/Coverage'; +export * from './common/DeviceDescriptors'; export * from './common/Dialog'; export * from './common/JSHandle'; export * from './common/ExecutionContext'; @@ -40,6 +41,8 @@ export * from './common/FrameManager'; export * from './common/Input'; export * from './common/Page'; export * from './common/Puppeteer'; +export * from './node/LaunchOptions'; +export * from './node/Launcher'; export * from './common/HTTPRequest'; export * from './common/HTTPResponse'; export * from './common/SecurityDetails'; diff --git a/src/common/DOMWorld.ts b/src/common/DOMWorld.ts index ed7ee4b420f6a..5885f75560bbe 100644 --- a/src/common/DOMWorld.ts +++ b/src/common/DOMWorld.ts @@ -21,7 +21,7 @@ import { TimeoutError } from './Errors'; import { JSHandle, ElementHandle } from './JSHandle'; import { ExecutionContext } from './ExecutionContext'; import { TimeoutSettings } from './TimeoutSettings'; -import { MouseButtonInput } from './Input'; +import { MouseButton } from './Input'; import { FrameManager, Frame } from './FrameManager'; import { getQueryHandlerAndSelector, QueryHandler } from './QueryHandler'; import { @@ -404,7 +404,7 @@ export class DOMWorld { async click( selector: string, - options: { delay?: number; button?: MouseButtonInput; clickCount?: number } + options: { delay?: number; button?: MouseButton; clickCount?: number } ): Promise { const handle = await this.$(selector); assert(handle, 'No node found for selector: ' + selector); diff --git a/src/common/FrameManager.ts b/src/common/FrameManager.ts index 4ac5704449ead..ea193f6421436 100644 --- a/src/common/FrameManager.ts +++ b/src/common/FrameManager.ts @@ -25,7 +25,7 @@ import { NetworkManager } from './NetworkManager'; import { TimeoutSettings } from './TimeoutSettings'; import { CDPSession } from './Connection'; import { JSHandle, ElementHandle } from './JSHandle'; -import { MouseButtonInput } from './Input'; +import { MouseButton } from './Input'; import { Page } from './Page'; import { HTTPResponse } from './HTTPResponse'; import Protocol from '../protocol'; @@ -532,7 +532,7 @@ export class Frame { selector: string, options: { delay?: number; - button?: MouseButtonInput; + button?: MouseButton; clickCount?: number; } = {} ): Promise { diff --git a/src/common/Input.ts b/src/common/Input.ts index 4dae85a39b6df..b395170a71b0e 100644 --- a/src/common/Input.ts +++ b/src/common/Input.ts @@ -33,7 +33,7 @@ type KeyDescription = Required< * {@link Keyboard.up}, and {@link Keyboard.sendCharacter} * to manually fire events as if they were generated from a real keyboard. * - * On MacOS, keyboard shortcuts like `⌘ A` -> Select All do not work. + * On MacOS, keyboard shortcuts like `⌘ A` -\> Select All do not work. * See {@link https://github.com/puppeteer/puppeteer/issues/1313 | #1313}. * * @example @@ -275,11 +275,16 @@ export class Keyboard { } } -type MouseButton = 'none' | 'left' | 'right' | 'middle'; -export type MouseButtonInput = Exclude; +/** + * @public + */ +export type MouseButton = 'left' | 'right' | 'middle'; -interface MouseOptions { - button?: MouseButtonInput; +/** + * @public + */ +export interface MouseOptions { + button?: MouseButton; clickCount?: number; } @@ -341,11 +346,12 @@ interface MouseOptions { * @public */ export class Mouse { - _client: CDPSession; - _keyboard: Keyboard; - _x = 0; - _y = 0; - _button: MouseButton = 'none'; + private _client: CDPSession; + private _keyboard: Keyboard; + private _x = 0; + private _y = 0; + private _button: MouseButton | 'none' = 'none'; + /** * @internal */ @@ -444,10 +450,11 @@ export class Mouse { /** * The Touchscreen class exposes touchscreen events. + * @public */ export class Touchscreen { - _client: CDPSession; - _keyboard: Keyboard; + private _client: CDPSession; + private _keyboard: Keyboard; /** * @internal diff --git a/src/common/Page.ts b/src/common/Page.ts index de9f90175cb43..4eb2bcb94c348 100644 --- a/src/common/Page.ts +++ b/src/common/Page.ts @@ -23,7 +23,7 @@ import { Connection, CDPSession } from './Connection'; import { Dialog } from './Dialog'; import { EmulationManager } from './EmulationManager'; import { Frame, FrameManager } from './FrameManager'; -import { Keyboard, Mouse, Touchscreen, MouseButtonInput } from './Input'; +import { Keyboard, Mouse, Touchscreen, MouseButton } from './Input'; import { Tracing } from './Tracing'; import { assert } from './assert'; import { helper, debugError } from './helper'; @@ -1485,7 +1485,7 @@ export class Page extends EventEmitter { selector: string, options: { delay?: number; - button?: MouseButtonInput; + button?: MouseButton; clickCount?: number; } = {} ): Promise { diff --git a/src/common/Puppeteer.ts b/src/common/Puppeteer.ts index b43beb973975d..e4dc0e5322a69 100644 --- a/src/common/Puppeteer.ts +++ b/src/common/Puppeteer.ts @@ -23,8 +23,7 @@ import { ProductLauncher } from '../node/Launcher'; import { BrowserFetcher, BrowserFetcherOptions } from '../node/BrowserFetcher'; import { puppeteerErrors, PuppeteerErrors } from './Errors'; import { ConnectionTransport } from './ConnectionTransport'; -import { devicesMap } from './DeviceDescriptors'; -import { DevicesMap } from './DeviceDescriptors'; +import { devicesMap, DevicesMap } from './DeviceDescriptors'; import { Browser } from './Browser'; import { registerCustomQueryHandler, @@ -137,18 +136,16 @@ export class Puppeteer { /** * @internal */ + get _productName(): string { + return this.__productName; + } + + // don't need any TSDoc here - because the getter is internal the setter is too. set _productName(name: string) { if (this.__productName !== name) this._changedProduct = true; this.__productName = name; } - /** - * @internal - */ - get _productName(): string { - return this.__productName; - } - /** * @remarks * @@ -254,7 +251,7 @@ export class Puppeteer { /** * - * @param options Set of configurable options to set on the browser. + * @param options - Set of configurable options to set on the browser. * @returns The default flags that Chromium will be launched with. */ defaultArgs(options: ChromeArgOptions = {}): string[] { @@ -263,7 +260,7 @@ export class Puppeteer { /** * - * @param options Set of configurable options to specify the settings + * @param options - Set of configurable options to specify the settings * of the BrowserFetcher. * @returns A new BrowserFetcher instance. */ diff --git a/src/common/Target.ts b/src/common/Target.ts index 5a80e801494ba..1a280a2b6b526 100644 --- a/src/common/Target.ts +++ b/src/common/Target.ts @@ -22,6 +22,9 @@ import { Browser, BrowserContext } from './Browser'; import { Viewport } from './PuppeteerViewport'; import Protocol from '../protocol'; +/** + * @public + */ export class Target { private _targetInfo: Protocol.Target.TargetInfo; private _browserContext: BrowserContext; diff --git a/src/common/Tracing.ts b/src/common/Tracing.ts index 673310dd1dfeb..15b0b14dd4f0f 100644 --- a/src/common/Tracing.ts +++ b/src/common/Tracing.ts @@ -17,7 +17,10 @@ import { assert } from './assert'; import { helper } from './helper'; import { CDPSession } from './Connection'; -interface TracingOptions { +/** + * @public + */ +export interface TracingOptions { path?: string; screenshots?: boolean; categories?: string[]; @@ -35,6 +38,8 @@ interface TracingOptions { * await page.goto('https://www.google.com'); * await page.tracing.stop(); * ``` + * + * @public */ export class Tracing { _client: CDPSession; diff --git a/src/common/USKeyboardLayout.ts b/src/common/USKeyboardLayout.ts index 69da035557646..feb3a1f7f1bc7 100644 --- a/src/common/USKeyboardLayout.ts +++ b/src/common/USKeyboardLayout.ts @@ -14,6 +14,9 @@ * limitations under the License. */ +/** + * @internal + */ export interface KeyDefinition { keyCode?: number; shiftKeyCode?: number; @@ -25,6 +28,12 @@ export interface KeyDefinition { location?: number; } +/** + * All the valid keys that can be passed to functions that take user input, such + * as {@link Keyboard.press | keyboard.press } + * + * @public + */ export type KeyInput = | '0' | '1' @@ -282,6 +291,9 @@ export type KeyInput = | 'VolumeDown' | 'VolumeUp'; +/** + * @internal + */ export const keyDefinitions: Readonly> = { '0': { keyCode: 48, key: '0', code: 'Digit0' }, '1': { keyCode: 49, key: '1', code: 'Digit1' }, diff --git a/src/common/WebWorker.ts b/src/common/WebWorker.ts index dacdd4ab159cd..c74e14899f372 100644 --- a/src/common/WebWorker.ts +++ b/src/common/WebWorker.ts @@ -21,11 +21,18 @@ import { CDPSession } from './Connection'; import Protocol from '../protocol'; import { EvaluateHandleFn, SerializableOrJSHandle } from './EvalTypes'; +/** + * @internal + */ type ConsoleAPICalledCallback = ( eventType: string, handles: JSHandle[], trace: Protocol.Runtime.StackTrace ) => void; + +/** + * @internal + */ type ExceptionThrownCallback = ( details: Protocol.Runtime.ExceptionDetails ) => void; @@ -124,8 +131,8 @@ export class WebWorker extends EventEmitter { * non-serializable value, then `worker.evaluate` resolves to `undefined`. * DevTools Protocol also supports transferring some additional values that * are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`, and - * bigint literals. Shortcut for `await - * worker.executionContext()).evaluate(pageFunction, ...args)`. + * bigint literals. + * Shortcut for `await worker.executionContext()).evaluate(pageFunction, ...args)`. * * @param pageFunction - Function to be evaluated in the worker context. * @param args - Arguments to pass to `pageFunction`. diff --git a/src/node/BrowserFetcher.ts b/src/node/BrowserFetcher.ts index 1d729222e3f20..f76cc4c2f35f3 100644 --- a/src/node/BrowserFetcher.ts +++ b/src/node/BrowserFetcher.ts @@ -62,12 +62,14 @@ const browserConfig = { /** * Supported platforms. + * @public */ -type Platform = 'linux' | 'mac' | 'win32' | 'win64'; +export type Platform = 'linux' | 'mac' | 'win32' | 'win64'; /** * Supported products. + * @public */ -type Product = 'chrome' | 'firefox'; +export type Product = 'chrome' | 'firefox'; function archiveName( product: Product, @@ -128,6 +130,9 @@ function existsAsync(filePath: string): Promise { }); } +/** + * @public + */ export interface BrowserFetcherOptions { platform?: Platform; product?: string; @@ -135,7 +140,10 @@ export interface BrowserFetcherOptions { host?: string; } -interface BrowserFetcherRevisionInfo { +/** + * @public + */ +export interface BrowserFetcherRevisionInfo { folderPath: string; executablePath: string; url: string; diff --git a/src/node/LaunchOptions.ts b/src/node/LaunchOptions.ts index 81548c9c26ed0..487020ec27158 100644 --- a/src/node/LaunchOptions.ts +++ b/src/node/LaunchOptions.ts @@ -16,6 +16,11 @@ import { Viewport } from '../common/PuppeteerViewport'; +/** + * Launcher options that only apply to Chrome. + * + * @public + */ export interface ChromeArgOptions { headless?: boolean; args?: string[]; @@ -23,6 +28,10 @@ export interface ChromeArgOptions { devtools?: boolean; } +/** + * Generic launch options that can be passed when launching any browser. + * @public + */ export interface LaunchOptions { executablePath?: string; ignoreDefaultArgs?: boolean | string[]; @@ -35,6 +44,10 @@ export interface LaunchOptions { pipe?: boolean; } +/** + * Generic browser options that can be passed when launching any browser. + * @public + */ export interface BrowserOptions { ignoreHTTPSErrors?: boolean; defaultViewport?: Viewport; diff --git a/src/node/Launcher.ts b/src/node/Launcher.ts index 804117e71e679..eb165f19e8ee8 100644 --- a/src/node/Launcher.ts +++ b/src/node/Launcher.ts @@ -39,6 +39,10 @@ import { BrowserOptions, } from './LaunchOptions'; +/** + * Describes a launcher - a class that is able to create and launch a browser instance. + * @public + */ export interface ProductLauncher { launch(object); connect(object); @@ -47,6 +51,9 @@ export interface ProductLauncher { product: string; } +/** + * @internal + */ class ChromeLauncher implements ProductLauncher { _projectRoot: string; _preferredRevision: string; @@ -267,6 +274,9 @@ class ChromeLauncher implements ProductLauncher { } } +/** + * @internal + */ class FirefoxLauncher implements ProductLauncher { _projectRoot: string; _preferredRevision: string; @@ -766,7 +776,10 @@ function resolveExecutablePath( return { executablePath: revisionInfo.executablePath, missingText }; } -function Launcher( +/** + * @internal + */ +export default function Launcher( projectRoot: string, preferredRevision: string, isPuppeteerCore: boolean, @@ -803,5 +816,3 @@ function Launcher( ); } } - -export default Launcher; From 88bbe56aca7658b516fb7f0dbaff1eae1bab0f87 Mon Sep 17 00:00:00 2001 From: Jack Franklin Date: Thu, 2 Jul 2020 11:58:57 +0100 Subject: [PATCH 2/2] satisfy doclint --- utils/doclint/check_public_api/index.js | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/utils/doclint/check_public_api/index.js b/utils/doclint/check_public_api/index.js index 45021b1993bb1..2cb02224d58fa 100644 --- a/utils/doclint/check_public_api/index.js +++ b/utils/doclint/check_public_api/index.js @@ -724,6 +724,27 @@ function compareDocumentations(actual, expected) { expectedName: 'JSCoverageOptions', }, ], + [ + 'Method Mouse.click() options.button', + { + actualName: '"left"|"right"|"middle"', + expectedName: 'MouseButton', + }, + ], + [ + 'Method Frame.click() options.button', + { + actualName: '"left"|"right"|"middle"', + expectedName: 'MouseButton', + }, + ], + [ + 'Method Page.click() options.button', + { + actualName: '"left"|"right"|"middle"', + expectedName: 'MouseButton', + }, + ], ]); const expectedForSource = expectedNamingMismatches.get(source);