跳转到主要内容

导航

简介​

Playwright 可以导航到 URL 并处理由页面交互引起的导航。

基本导航​

最简单的导航形式是打开 URL

# Navigate the page
page.goto("https://example.com")

上面的代码加载页面并等待网页触发 load 事件。当整个页面加载完成时，包括所有依赖资源，如样式表、脚本、iframe 和图像，就会触发 load 事件。

注意

如果页面在 `load` 之前进行了客户端重定向，page.goto() 将等待重定向页面触发 `load` 事件。

页面何时加载完成？​

现代页面在 `load` 事件触发后会执行大量活动。它们在 `load` 事件触发后会延迟获取数据、填充 UI、加载昂贵的资源、脚本和样式。无法判断页面何时 `加载完成`，这取决于页面、框架等。那么，何时可以开始与之交互呢？

在 Playwright 中，您可以随时与页面交互。它将自动等待目标元素变为可操作的。

# Navigate and click element
# Click will auto-wait for the element
page.goto("https://example.com")
page.get_by_text("example domain").click()

对于上述情况，Playwright 将等待文本变得可见，等待该元素的其余可操作性检查通过，然后点击它。

Playwright 的操作速度非常快——它一看到按钮，就会点击它。通常情况下，您无需担心所有资源是否已加载等问题。

水合​

在某个时刻，您会遇到 Playwright 执行某个操作，但似乎什么也没有发生的情况。或者您在输入字段中输入了一些文本，然后它会消失。这背后最可能的原因是页面水合不良。

当页面水合时，首先，页面的静态版本被发送到浏览器。然后，动态部分被发送，页面变得“实时”。作为一名非常快速的用户，Playwright 在看到页面时就会开始与之交互。如果页面上的按钮已启用，但尚未添加侦听器，Playwright 将执行其工作，但点击不会有任何效果。

验证您的页面是否存在不良水合问题的一种简单方法是打开 Chrome DevTools，在“网络”面板中选择“慢速 3G”网络模拟，然后重新加载页面。一旦您看到感兴趣的元素，请与它交互。您会发现按钮点击将被忽略，输入的文本将被随后的页面加载代码重置。解决此问题的正确方法是确保所有交互式控件在水合完成后（即页面完全正常运行后）才被启用。

等待导航​

点击一个元素可能会触发多次导航。在这些情况下，建议显式地 page.wait_for_url() 到一个特定的 URL。

page.get_by_text("Click me").click()
page.wait_for_url("**/login")

Playwright 将在页面中显示新文档的过程分为导航和加载。

导航开始通过更改页面 URL 或与页面交互（例如，点击链接）。导航意图可能会被取消，例如，在遇到未解析的 DNS 地址或转换为文件下载时。

当响应头被解析并且会话历史记录更新后，导航被提交。只有在导航成功（已提交）后，页面才开始加载文档。

加载包括通过网络获取剩余的响应体、解析、执行脚本和触发加载事件