Playwright 网络与输入 API
本附录列出网络请求、键盘、鼠标和触控相关的 API。
Request 类
| 方法 | 说明 |
|---|---|
request.url() | 请求 URL |
request.method() | 请求方法（GET/POST 等） |
request.headers() | 请求头 |
request.postData() | POST 请求的 body 数据 |
request.postDataJSON() | POST 请求的 JSON body |
request.postDataBuffer() | POST 请求的 Buffer body |
request.isNavigationRequest() | 是否为导航请求 |
request.frame() | 发起请求的 Frame |
request.redirectedFrom() | 重定向来源 Request |
request.redirectedTo() | 重定向目标 Request |
request.failure() | 请求失败信息（无失败则返回 null） |
request.timing() | 请求时间信息 |
Response 类
| 方法 | 说明 |
|---|---|
response.url() | 响应 URL |
response.status() | HTTP 状态码 |
response.statusText() | 状态文本 |
response.headers() | 响应头 |
response.body() | 响应 body（Buffer） |
response.text() | 响应 body（文本） |
response.json() | 响应 body（JSON） |
response.ok() | 状态码是否在 200-299 范围 |
response.request() | 对应的 Request 对象 |
response.frame() | 发起请求的 Frame |
Route 类
| 方法 | 说明 |
|---|---|
route.abort(errorCode?) | 阻止请求 |
route.continue(options?) | 修改后继续请求 |
route.fulfill(options?) | 返回自定义响应 |
route.fetch(options?) | 实际发送请求并获取响应 |
route.request() | 获取对应的 Request |
WebSocket 类
| 方法/事件 | 说明 |
|---|---|
webSocket.url() | WebSocket URL |
webSocket.isClosed() | 是否已关闭 |
webSocket.on('framereceived', handler) | 接收帧事件 |
webSocket.on('framesent', handler) | 发送帧事件 |
webSocket.on('close', handler) | 关闭事件 |
APIRequestContext 类
| 方法 | 说明 |
|---|---|
request.get(url, options?) | 发送 GET 请求 |
request.post(url, options?) | 发送 POST 请求 |
request.put(url, options?) | 发送 PUT 请求 |
request.patch(url, options?) | 发送 PATCH 请求 |
request.delete(url, options?) | 发送 DELETE 请求 |
request.head(url, options?) | 发送 HEAD 请求 |
request.fetch(urlOrRequest, options?) | 发送请求（通用） |
request.storageState(options?) | 获取存储状态 |
request.dispose() | 释放资源 |
APIResponse 类
| 方法 | 说明 |
|---|---|
response.status() | HTTP 状态码 |
response.statusText() | 状态文本 |
response.headers() | 响应头 |
response.body() | body（Buffer） |
response.text() | body（文本） |
response.json() | body（JSON） |
response.ok() | 状态码是否在 200-299 |
response.url() | 响应的最终 URL |
response.dispose() | 释放资源 |
Keyboard 类
| 方法 | 说明 |
|---|---|
keyboard.press(key) | 按下并释放按键 |
keyboard.down(key) | 按下按键不释放 |
keyboard.up(key) | 释放按键 |
keyboard.type(text, options?) | 逐字符输入 |
keyboard.insertText(text) | 直接插入文本 |
Mouse 类
| 方法 | 说明 |
|---|---|
mouse.click(x, y, options?) | 坐标点击 |
mouse.dblclick(x, y, options?) | 坐标双击 |
mouse.move(x, y, options?) | 移动鼠标到坐标 |
mouse.down(options?) | 按下鼠标按钮 |
mouse.up(options?) | 释放鼠标按钮 |
mouse.wheel(deltaX, deltaY) | 滚动滚轮 |
Touchscreen 类
| 方法 | 说明 |
|---|---|
touchscreen.tap(x, y) | 触控点击 |