指南
每项能力对应一篇指南,都配有可运行的示例。如果你是新手,请从 核心概念 开始,或者直接跳到你需要的任务。
核心概念
- 核心概念:tab 和 browser 对象、异步模型,以及“无 webdriver”在实践中意味着什么。
查找与提取
- 元素查找:用
find()(按属性)和query()(CSS 或 XPath)定位元素。 - DOM 遍历:从一个元素移动到它的子元素、兄弟元素和 shadow root。
- 结构化提取:用模型从页面中提取带类型、经校验的数据。
交互
- 键盘:以拟人化的节奏输入文本、按下按键。
- 鼠标:点击元素或直接操作原始坐标,配合拟人化的移动。
- 文件操作:上传文件、处理下载。
- Iframe:查找并操作 frame 内部的元素。
- 截图与 PDF:截取页面、某个元素,或生成 PDF。
网络
- 网络监控:实时观察请求和响应。
- 请求拦截:拦截、修改或模拟请求。
- 浏览器上下文中的 HTTP 请求:在浏览器会话中调用 API,沿用它的 cookies 和认证。
- HAR 录制:把一次会话录制成 HAR 文件。
管理浏览器
- 标签页:同时打开、关闭并操作多个标签页。
- 浏览器上下文:一个浏览器内相互隔离的会话,每个都有独立的 cookies。
- Cookies 与会话:读取、设置 cookies,并在多次运行间保持它们。
- 浏览器选项:命令行 flag、headless 以及启动配置。
- 浏览器偏好设置:Chromium 内部的偏好设置字典。
- Proxy:让流量经过 proxy,并处理认证。
- 远程连接:接入一个已在运行的浏览器。