Patchright 原生参考 / YSBROWSER SDK
Patchright 原生 API 参考
本附录对应 SDK 固定依赖 Patchright Python 1.64.2。常用操作的中文说明见页面与定位器。下列各页包含该对象所有公开方法/属性的同步及异步签名，并保留随包提供的英文参数、返回值及示例说明，便于核对每个可选字段。
这些接口通过 Page、Locator、context.raw 等原生对象调用，不是 YSContext 的新增方法。BrowserType/Playwright 的原生启动接口仅作参考；使用本 SDK 管理指纹和代理时从 YSBrowser 启动。原生 APIRequestContext 不能据此假设跟随自定义 Context 代理。
异步 API 的普通工厂和属性仍直接使用；声明为 async def 的操作使用 await，事件等待上下文管理器使用 async with。参数超时通常以毫秒计，详细默认行为见各方法正文。
原生说明保留上游命名和示例（可能使用 playwright 变量名称），本 SDK 返回的对象属于 patchright。上游对于平台、Shadow DOM 等通用行为的说明不扩大本 SDK 的 Windows 支持范围；配套浏览器的差异按中文手册说明使用。
第三方 API 说明源自已安装依赖，版权与许可见 第三方声明。
对象
- APIRequest
- APIRequestContext
- APIResponse
- APIResponseAssertions
- Browser
- BrowserContext
- BrowserType
- CDPSession
- Clock
- ConsoleMessage
- Credentials
- Debugger
- Dialog
- Disposable
- Download
- ElementHandle
- Expect
- FileChooser
- FormData
- Frame
- FrameLocator
- JSHandle
- Keyboard
- Locator
- LocatorAssertions
- Mouse
- Page
- PageAssertions
- Playwright
- Request
- Response
- Route
- Screencast
- Selectors
- Touchscreen
- Tracing
- Video
- WebError
- WebMCP
- WebSocket
- WebSocketRoute
- WebStorage
- Worker
ChromiumBrowserContext 是该版本的 BrowserContext 类型别名，参照 BrowserContext。
原生异常为 patchright.sync_api.Error / TimeoutError（异步入口同名）；TimeoutError 继承 Error。使用 SDK 时同时处理这些原生异常和 SDK 异常。