github/puppeteer
0
0
Fork 0
mirror of https://github.com/puppeteer/puppeteer synced 2024-06-14 14:02:48 +00:00
Code Issues Packages Projects Releases Wiki Activity
e9df6750d2
puppeteer/website/versioned_docs/version-19.5.2/api/puppeteer.page.screenshot.md
release-please[bot] e9df6750d2
chore: release main (#9495) 
🤖 I have created a release *beep* *boop*
---


<details><summary>puppeteer: 19.5.2</summary>

##
[19.5.2](https://github.com/puppeteer/puppeteer/compare/puppeteer-v19.5.1...puppeteer-v19.5.2)
(2023-01-11)


### Miscellaneous Chores

* **puppeteer:** Synchronize puppeteer versions


### Dependencies

* The following workspace dependencies were updated
  * dependencies
    * puppeteer-core bumped from 19.5.1 to 19.5.2
</details>

<details><summary>puppeteer-core: 19.5.2</summary>

##
[19.5.2](https://github.com/puppeteer/puppeteer/compare/puppeteer-core-v19.5.1...puppeteer-core-v19.5.2)
(2023-01-11)


### Bug Fixes

* make sure browser fetcher in launchers uses configuration
([#9493](https://github.com/puppeteer/puppeteer/issues/9493))
([df55439](df554397b5)),
closes [#9470](https://github.com/puppeteer/puppeteer/issues/9470)
</details>

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2023-01-12 08:21:09 +01:00

2.5 KiB
Raw Blame History

sidebar_label
Page.screenshot

Page.screenshot() method

Signature:

class Page {
  screenshot(options?: ScreenshotOptions): Promise<Buffer | string>;
}

Parameters

Parameter Type Description
options ScreenshotOptions (Optional)

Returns:

Promise<Buffer | string>

Promise which resolves to buffer or a base64 string (depending on the value of encoding) with captured screenshot.

Remarks

Options object which might have the following properties:

  • path : The file path to save the image to. The screenshot type will be inferred from file extension. If path is a relative path, then it is resolved relative to current working directory. If no path is provided, the image won't be saved to the disk.

  • type : Specify screenshot type, can be either jpeg or png. Defaults to 'png'.

  • quality : The quality of the image, between 0-100. Not applicable to png images.

  • fullPage : When true, takes a screenshot of the full scrollable page. Defaults to false.

  • clip : An object which specifies clipping region of the page. Should have the following fields:
    - x : x-coordinate of top-left corner of clip area.
    - y : y-coordinate of top-left corner of clip area.
    - width : width of clipping area.
    - height : height of clipping area.

  • omitBackground : Hides default white background and allows capturing screenshots with transparency. Defaults to false.

  • encoding : The encoding of the image, can be either base64 or binary. Defaults to binary.

  • captureBeyondViewport : When true, captures screenshot beyond the viewport. When false, falls back to old behaviour, and cuts the screenshot by the viewport size. Defaults to true.

  • fromSurface : When true, captures screenshot from the surface rather than the view. When false, works only in headful mode and ignores page viewport (but not browser window's bounds). Defaults to true.

NOTE: Screenshots take at least 1/6 second on OS X. See https://crbug.com/741689 for discussion.