Page.screenshot() method
Signature:screenshot(options?: ScreenshotOptions): Promise<Buffer | string>;
Parameters
Parameter | Type | Description |
---|---|---|
options | ScreenshotOptions | (Optional) |
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. Ifpath
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 eitherjpeg
orpng
. Defaults to 'png'.quality
: The quality of the image, between 0-100. Not applicable topng
images.fullPage
: When true, takes a screenshot of the full scrollable page. Defaults tofalse
.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 tofalse
.encoding
: The encoding of the image, can be either base64 or binary. Defaults tobinary
.captureBeyondViewport
: When true, captures screenshot beyond the viewport. When false, falls back to old behaviour, and cuts the screenshot by the viewport size. Defaults totrue
.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 totrue
.
NOTE: Screenshots take at least 1/6 second on OS X. See https://crbug.com/741689 for discussion.