puppeteer/website/versioned_docs/version-22.6.5/api/puppeteer.screenshotoptions.md
release-please[bot] e0932e5cce
chore: release main (#12274)
🤖 I have created a release *beep* *boop*
---


<details><summary>browsers: 2.2.2</summary>

##
[2.2.2](https://github.com/puppeteer/puppeteer/compare/browsers-v2.2.1...browsers-v2.2.2)
(2024-04-15)


### Bug Fixes

* remove NetworkServiceInProcess2 set by default
([#12261](https://github.com/puppeteer/puppeteer/issues/12261))
([ff4f70f](ff4f70f4ae)),
closes [#12257](https://github.com/puppeteer/puppeteer/issues/12257)
</details>

<details><summary>puppeteer: 22.6.5</summary>

##
[22.6.5](https://github.com/puppeteer/puppeteer/compare/puppeteer-v22.6.4...puppeteer-v22.6.5)
(2024-04-15)


### Miscellaneous Chores

* **puppeteer:** Synchronize puppeteer versions


### Dependencies

* The following workspace dependencies were updated
  * dependencies
    * puppeteer-core bumped from 22.6.4 to 22.6.5
    * @puppeteer/browsers bumped from 2.2.1 to 2.2.2
</details>

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

##
[22.6.5](https://github.com/puppeteer/puppeteer/compare/puppeteer-core-v22.6.4...puppeteer-core-v22.6.5)
(2024-04-15)


### Bug Fixes

* remove NetworkServiceInProcess2 set by default
([#12261](https://github.com/puppeteer/puppeteer/issues/12261))
([ff4f70f](ff4f70f4ae)),
closes [#12257](https://github.com/puppeteer/puppeteer/issues/12257)
* use setImmediate to reduce flakiness when processing events
([#12264](https://github.com/puppeteer/puppeteer/issues/12264))
([73403b3](73403b323e))


### Dependencies

* The following workspace dependencies were updated
  * dependencies
    * @puppeteer/browsers bumped from 2.2.1 to 2.2.2
</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>
2024-04-15 07:06:55 +00:00

237 lines
2.3 KiB
Markdown

---
sidebar_label: ScreenshotOptions
---
# ScreenshotOptions interface
#### Signature:
```typescript
export interface ScreenshotOptions
```
## Properties
<table><thead><tr><th>
Property
</th><th>
Modifiers
</th><th>
Type
</th><th>
Description
</th><th>
Default
</th></tr></thead>
<tbody><tr><td>
<span id="capturebeyondviewport">captureBeyondViewport</span>
</td><td>
`optional`
</td><td>
boolean
</td><td>
Capture the screenshot beyond the viewport.
</td><td>
`false` if there is no `clip`. `true` otherwise.
</td></tr>
<tr><td>
<span id="clip">clip</span>
</td><td>
`optional`
</td><td>
[ScreenshotClip](./puppeteer.screenshotclip.md)
</td><td>
Specifies the region of the page/element to clip.
</td><td>
</td></tr>
<tr><td>
<span id="encoding">encoding</span>
</td><td>
`optional`
</td><td>
'base64' \| 'binary'
</td><td>
Encoding of the image.
</td><td>
`'binary'`
</td></tr>
<tr><td>
<span id="fromsurface">fromSurface</span>
</td><td>
`optional`
</td><td>
boolean
</td><td>
Capture the screenshot from the surface, rather than the view.
</td><td>
`true`
</td></tr>
<tr><td>
<span id="fullpage">fullPage</span>
</td><td>
`optional`
</td><td>
boolean
</td><td>
When `true`, takes a screenshot of the full page.
</td><td>
`false`
</td></tr>
<tr><td>
<span id="omitbackground">omitBackground</span>
</td><td>
`optional`
</td><td>
boolean
</td><td>
Hides default white background and allows capturing screenshots with transparency.
</td><td>
`false`
</td></tr>
<tr><td>
<span id="optimizeforspeed">optimizeForSpeed</span>
</td><td>
`optional`
</td><td>
boolean
</td><td>
</td><td>
`false`
</td></tr>
<tr><td>
<span id="path">path</span>
</td><td>
`optional`
</td><td>
string
</td><td>
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.
</td><td>
</td></tr>
<tr><td>
<span id="quality">quality</span>
</td><td>
`optional`
</td><td>
number
</td><td>
Quality of the image, between 0-100. Not applicable to `png` images.
</td><td>
</td></tr>
<tr><td>
<span id="type">type</span>
</td><td>
`optional`
</td><td>
'png' \| 'jpeg' \| 'webp'
</td><td>
</td><td>
`'png'`
</td></tr>
</tbody></table>