共计 3397 个字符，预计需要花费 9 分钟才能阅读完成。
在自动化测试和爬虫领域，Playwright 是一个强大的浏览器自动化库，而 page.goto(url) 则是最常用的网页导航方法之一。本文将详细解析 page.goto(url) 的用法、参数、返回值及常见问题，并结合实战案例，帮助你彻底掌握 page.goto(url) 的使用。
1. 什么是 page.goto(url)？
page.goto(url) 是 Playwright 提供的 导航方法，用于让浏览器打开指定的 URL，并等待页面加载完成。
基本语法
import asyncio
from playwright.async_api import async_playwright
async def main():
async with async_playwright() as p:
browser = await p.chromium.launch(headless=False) # 运行无头浏览器
page = await browser.new_page()
response = await page.goto("https://example.com") # 打开网页
print(f"页面状态码: {response.status}") # 输出 HTTP 状态码
await browser.close()
asyncio.run(main())
运行结果：
页面状态码: 200
📌 作用：
- 让 Playwright 导航 到
https://example.com。 await page.goto(url)会返回Response对象，可用于获取 HTTP 状态码。- 代码执行到
await page.goto(url)会等待页面加载完成。
2. page.goto(url) 的关键参数
page.goto(url) 支持多个参数，可用于控制导航行为：
await page.goto(url, timeout=30000, wait_until="load", referer="https://google.com")
| 参数 | 说明 | 默认值 |
|---|---|---|
url |
目标网页地址 | 必填 |
timeout |
超时时间（毫秒） | 30000ms (30 秒) |
wait_until |
页面加载状态 | "load" |
referer |
伪造 Referer 头 |
None |
参数详解
2.1 timeout – 设置超时时间
默认情况下，page.goto(url) 的超时时间为 30s，如果网页加载时间超过此时间，会抛出 TimeoutError。
await page.goto("https://example.com", timeout=10000) # 超时 10 秒
📌 适用场景：
- 当目标网站响应慢时，适当调高
timeout。 - 避免脚本无限等待页面加载。
2.2 wait_until – 控制页面加载状态
wait_until 决定 page.goto(url) 何时返回，有四种模式：
"load"（默认）：等到load事件 触发（页面完全加载）。"domcontentloaded"：等到 DOM 加载完成（不等图片、CSS 加载）。"networkidle"：等到 网络连接闲置（即无新请求）。"commit"：只等到 导航开始（最快）。
示例：等待 DOM 结构加载完成
await page.goto("https://example.com", wait_until="domcontentloaded")
📌 适用场景：
- 需要等待完整页面加载时使用
"load"。 - 只需等待 HTML 加载时使用
"domcontentloaded"。 - 需要确保所有请求完成时使用
"networkidle"。
2.3 referer – 伪造请求头
可以通过 referer 伪造来源：
await page.goto("https://example.com", referer="https://google.com")
📌 适用场景：
- 伪造流量来源，模拟不同访问来源的用户行为。
- 访问某些有
Referer限制的网站。
3. page.goto(url) 的返回值
page.goto(url) 返回一个 Response 对象，可用于获取 HTTP 状态码、请求 URL、响应头等信息。
示例：获取 HTTP 响应状态码
response = await page.goto("https://example.com")
print(response.status) # 200
示例：获取响应头
response = await page.goto("https://example.com")
print(response.headers)
📌 常见状态码：
200：请求成功301/302：重定向403：禁止访问404：页面不存在500：服务器错误
4. page.goto(url) 的常见错误
4.1 超时错误 (TimeoutError)
TimeoutError: Navigation timeout of 30000 ms exceeded
解决方案：
- 增加
timeout：await page.goto("https://example.com", timeout=60000) - 使用
try-except捕获异常：try: await page.goto("https://example.com", timeout=5000) except Exception as e: print(f"页面加载超时: {e}")
4.2 导航失败 (page.goto() 返回 None)
有时 page.goto(url) 可能返回 None，表示请求失败，可能原因：
- 目标服务器拒绝请求（403 Forbidden）。
- 网络连接问题。
- 目标网页需要登录。
解决方案：
- 检查
response是否None：response = await page.goto("https://example.com") if response: print("页面加载成功") else: print("页面加载失败")
4.3 目标页面重定向
如果 page.goto(url) 遇到 301/302 重定向，Playwright 会 自动跟随，但如果需要获取最终 URL，可以使用：
response = await page.goto("https://example.com")
print(response.url) # 获取最终跳转的 URL
5. page.goto(url) 的实战案例
案例 1：爬取网页标题
import asyncio
from playwright.async_api import async_playwright
async def get_title(url):
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page()
await page.goto(url, wait_until="domcontentloaded")
title = await page.title() # 获取网页标题
await browser.close()
return title
title = asyncio.run(get_title("https://example.com"))
print(title)
案例 2：检测页面加载状态
async def check_page(url):
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page()
response = await page.goto(url)
if response and response.status == 200:
print(f"{url} 加载成功！")
else:
print(f"{url} 加载失败，状态码：{response.status if response else'None'}")
await browser.close()
asyncio.run(check_page("https://example.com"))
6. 结论
✅ page.goto(url) 是 Playwright 中最常用的网页导航方法。
✅ timeout 控制超时时间，wait_until 控制等待加载状态。
✅ page.goto(url) 返回 Response 对象，可获取 HTTP 状态码、最终 URL、响应头等。
✅ 结合 try-except 处理超时、重定向等异常情况，提高脚本稳定性。
现在，你已经掌握了 page.goto(url) 的全部核心知识，快去试试吧！🚀
