導(dǎo)航和頁面操作

goto(url: str, **kwargs: Any): 導(dǎo)航到一個(gè)URL。

reload(**kwargs: Any): 重新加載當(dāng)前頁面。

go_back(**kwargs: Any): 導(dǎo)航到會(huì)話歷史記錄中的前一個(gè)頁面。

go_forward(**kwargs: Any): 導(dǎo)航到會(huì)話歷史記錄中的下一個(gè)頁面。

set_default_navigation_timeout(timeout: float): 設(shè)置默認(rèn)的導(dǎo)航超時(shí)時(shí)間（以毫秒為單位）。

set_viewport_size(width: int, height: int): 設(shè)置視口大小。

bring_to_front(): 將頁面帶到前臺(tái)。

close(**kwargs: Any): 關(guān)閉頁面。

context() -> “BrowserContext”: 獲取與此頁面關(guān)聯(lián)的瀏覽器上下文。

is_closed() -> bool: 如果頁面已關(guān)閉，則返回True。

pdf(path: Union[Path, str, None] = None, **kwargs: Any): 將頁面保存為PDF文件。

screenshot(path: Union[Path, str, None] = None, **kwargs: Any): 對(duì)頁面進(jìn)行截圖并保存到指定路徑。

set_content(html: str, **kwargs: Any): 設(shè)置頁面的HTML內(nèi)容。

content() -> str: 獲取頁面的HTML內(nèi)容。

title() -> str: 獲取頁面的標(biāo)題。

title() -> str: 獲取頁面的標(biāo)題。

page.request.get() :get 請(qǐng)求

page.request.post()： post請(qǐng)求

頁面元素定位和交互

click(selector: str, **kwargs: Any): 使用選擇器找到元素并點(diǎn)擊。

fill(selector: str, value: str, **kwargs: Any): 使用選擇器找到表單元素，并填充指定的值。

press(selector: str, key: str, **kwargs: Any): 模擬在指定元素上按下鍵盤鍵。

type(selector: str, text: str, **kwargs: Any): 在指定元素中輸入文本。

check(selector: str, **kwargs: Any): 選中指定的復(fù)選框或單選按鈕。

uncheck(selector: str, **kwargs: Any): 取消選中指定的復(fù)選框或單選按鈕。

select_option(selector: str, value: str, **kwargs: Any): 在指定的下拉列表中選擇一個(gè)選項(xiàng)。

locator(selector: str) -> “Locator”: 獲取一個(gè)Locator對(duì)象，用于通過CSS選擇器、XPath等定位頁面元素。

get_by_test_id(id: str) -> “Locator”: 通過data-testid屬性獲取元素。

get_by_role(role: str) -> “Locator”: 通過role屬性獲取元素。

get_by_label(label: str) -> “Locator”: 通過label屬性獲取元素。

get_by_placeholder(placeholder: str) -> “Locator”: 通過placeholder屬性獲取元素。

get_by_alt_text(alt: str) -> “Locator”: 通過alt屬性獲取元素。

get_by_title(title: str) -> “Locator”: 通過title屬性獲取元素。

get_by_text(text: str) -> “Locator”: 通過文本內(nèi)容獲取元素。

frame(frame_locator: Union[“FrameLocator”, str]) -> “Frame”: 獲取一個(gè)Frame對(duì)象。

frame_locator(selector: str) -> “FrameLocator”: 獲取一個(gè)FrameLocator對(duì)象。

drag_and_drop(source: str, target: str, **kwargs: Any): 拖動(dòng)一個(gè)元素并將其放置到另一個(gè)位置。

frames() -> List[“Frame”]: 獲取所有的Frame對(duì)象。

頁面事件和等待

wait_for_event(event_name: str, **kwargs: Any): 等待一個(gè)事件。

wait_for_function(page_function: str, arg: Any = None, **kwargs: Any): 等待一個(gè)函數(shù)返回True。

wait_for_load_state(state: str = “l(fā)oad”, **kwargs: Any): 等待頁面達(dá)到指定的加載狀態(tài)。

wait_for_url(url: str, **kwargs: Any): 等待頁面的URL匹配一個(gè)模式。

wait_for_selector(selector: str, state: Optional[str] = None, **kwargs: Any): 等待指定選擇器匹配到的元素滿足給定狀態(tài)（如可見、可點(diǎn)擊等）。

expect_event(event_name: str, **kwargs: Any): 期待一個(gè)事件。

expect_console_message(message: Union[str, Pattern], **kwargs: Any): 等待一個(gè)控制臺(tái)消息。

expect_download(**kwargs: Any): 等待一個(gè)下載。

expect_file_chooser(**kwargs: Any): 等待一個(gè)文件選擇器。

expect_popup(**kwargs: Any): 等待一個(gè)彈出窗口。

expect_request(url: Union[str, Pattern], **kwargs: Any): 等待一個(gè)請(qǐng)求。

expect_request_finished(url: Union[str, Pattern], **kwargs: Any): 等待一個(gè)請(qǐng)求完成。

expect_response(url: Union[str, Pattern], **kwargs: Any): 等待一個(gè)響應(yīng)。

expect_websocket(**kwargs: Any): 等待一個(gè)WebSocket。

expect_worker(**kwargs: Any): 等待一個(gè)Worker。

JavaScript執(zhí)行和腳本處理

evaluate(page_function: str, arg: Any = None, **kwargs: Any): 在頁面上執(zhí)行一個(gè)JavaScript函數(shù)，并返回結(jié)果。

evaluate_handle(page_function: str, arg: Any = None, **kwargs: Any): 獲取一個(gè)可以在頁面上執(zhí)行JavaScript的句柄。

add_init_script(script: str, **kwargs: Any): 添加一個(gè)在每個(gè)新頁面加載時(shí)運(yùn)行的腳本。

expose_binding(name: str, playwright_binding: Callable[…, Any], **kwargs: Any): 在頁面上公開一個(gè)綁定。

expose_function(name: str, playwright_function: Callable[…, Any], **kwargs: Any): 在頁面上公開一個(gè)函數(shù)。

網(wǎng)絡(luò)請(qǐng)求和攔截處理

route(url: Union[str, Pattern], handler: Callable[[“Route”], Awaitable[None]], **kwargs: Any): 添加一個(gè)路由。

route_from_har(har_entries: List[Dict[str, Any]], **kwargs: Any): 從HAR文件添加路由。

unroute(url: Union[str, Pattern], **kwargs: Any): 移除一個(gè)路由。

unroute_all(**kwargs: Any): 移除所有路由。

set_extra_http_headers(headers: Dict[str, str]): 設(shè)置額外的HTTP頭。

emulate_media(media: Union[None, str, Media]): 模擬媒體類型或顏色方案。

其他操作

add_locator_handler(name: str, handler: Callable[[“Locator”, Dict[str, Any]], “Locator”]): 添加一個(gè)定位器處理器。

add_script_tag(url: Optional[str] = None, content: Optional[str] = None, **kwargs: Any): 在頁面中添加一個(gè)script標(biāo)簽。

add_style_tag(url: Optional[str] = None, content: Optional[str] = None, **kwargs: Any): 在頁面中添加一個(gè)style標(biāo)簽。

pause(): 暫停執(zhí)行，直到用戶手動(dòng)恢復(fù)。

set_default_timeout(timeout: float): 設(shè)置默認(rèn)的超時(shí)時(shí)間（以毫秒為單位）。

事件

page.on(‘load’, Callable()):監(jiān)聽頁面加載事件

page.on(‘domcontentloaded’, Callable()): 監(jiān)聽 DOMContentLoaded 事件

page.on(‘request’, Callable()):監(jiān)聽請(qǐng)求事件

page.on(‘response’, Callable()):監(jiān)聽響應(yīng)事件

page.on(‘dialog’, Callable()):監(jiān)聽彈窗事件

page.on(‘pageerror’, Callable(error)):監(jiān)聽頁面錯(cuò)誤事件