Skip to main content
Version: 24.38.0

Page.screenshot() 方法

🌐 Page.screenshot() method

screenshot(): Promise<string>

捕获此页面的截图。

🌐 Captures a screenshot of this page.

语法

🌐 Signature

class Page {
screenshot(
options: Readonly<ScreenshotOptions> & {
encoding: 'base64';
},
): Promise<string>;
}

参数

🌐 Parameters

范围

🌐 Parameter

类型

🌐 Type

描述

🌐 Description

options

Readonly<ScreenshotOptions> & { encoding: 'base64'; }

配置屏幕截图行为。

🌐 Configures screenshot behavior.

返回:

Promise<string>

附注

🌐 Remarks

BrowserContext 中截取屏幕截图时,以下方法将自动等待屏幕截图完成,以防干扰屏幕截图过程:BrowserContext.newPage()Browser.newPage()Page.close()

🌐 While a screenshot is being taken in a BrowserContext, the following methods will automatically wait for the screenshot to finish to prevent interference with the screenshot process: BrowserContext.newPage(), Browser.newPage(), Page.close().

调用 Page.bringToFront() 不会等待现有的截图操作。

🌐 Calling Page.bringToFront() will not wait for existing screenshot operations.

screenshot(): Promise<Uint8Array>

语法

🌐 Signature

class Page {
screenshot(options?: Readonly<ScreenshotOptions>): Promise<Uint8Array>;
}

参数

🌐 Parameters

范围

🌐 Parameter

类型

🌐 Type

描述

🌐 Description

options

Readonly<ScreenshotOptions>

(可选)

🌐 (Optional)

返回:

Promise<Uint8Array>