Playwright Python浏览器启动方式选择及窗口最大化问题咨询

1. 两种启动方式的适用场景 #

• 方式一（测试框架注入Page）
  这是Playwright搭配测试框架（比如pytest-playwright）的标准写法，Page对象由测试框架自动注入管理。适合自动化测试场景：

  • 不用手动处理浏览器、页面的启动与销毁，框架会在测试用例前后自动完成资源清理
  • 能直接复用测试框架的特性，比如并行测试、生成测试报告、失败自动截图等
  • 可以专注编写测试逻辑，不用操心底层的浏览器生命周期管理

• 方式二（手动控制Playwright实例）
  这种是直接调用Playwright核心API手动管控浏览器实例，适合通用自动化脚本场景（比如爬虫、自动化办公、自定义工具）：

  • 完全掌控浏览器的启动参数（比如指定浏览器类型、是否无头、自定义启动参数）
  • 灵活创建多浏览器实例、多页面，适配复杂的自动化流程
  • 适合不需要集成测试框架的独立脚本，自由度更高

2. 解决--start-maximized不生效的问题 #

--start-maximized参数失效通常是浏览器兼容性问题，或是Playwright的默认viewport设置覆盖了该参数。可以用以下更可靠的方式实现窗口最大化：

方法一：使用Playwright原生maximize()方法 #

创建页面后直接调用页面的最大化API（Playwright 1.10及以上版本支持）：

with sync_playwright() as p:
  browser = p.chromium.launch(headless=False)
  page = browser.new_page()
  page.maximize()  # 直接调用最大化方法
  page.goto("https://my-url.com")

方法二：禁用默认viewport配合启动参数 #

创建页面时设置viewport=None，让浏览器使用系统默认窗口，再结合--start-maximized参数：

with sync_playwright() as p:
  browser = p.chromium.launch(headless=False, args=["--start-maximized"])
  page = browser.new_page(viewport=None)  # 禁用默认viewport
  page.goto("https://my-url.com")

方法三：手动设置屏幕分辨率 #

如果需要精准控制窗口大小，可直接设置viewport为当前屏幕的分辨率：

with sync_playwright() as p:
  browser = p.chromium.launch(headless=False)
  page = browser.new_page()
  # 示例设置为1920x1080，可根据实际屏幕调整
  page.set_viewport_size({"width": 1920, "height": 1080})
  page.goto("https://my-url.com")

注意：必须确保浏览器在headless=False的非无头模式下运行，无头模式下窗口大小设置不会生效。

内容的提问来源于stack exchange，提问作者Ram