1.简介

上一篇已经将 playwright 的元素定位大法基本介绍的差不多了，但是在 Web 的 UI 自动化的测试中，我们通常需要使用一些方法来操作浏览器，今天就跟随学习了解一下。这一篇宏哥主要是介绍一下，在自动化测试的时候，我们常见的一些浏览器操作有哪些，宏哥将会一一介绍和讲解。

2.层级

在介绍浏览器的相关操作之前，宏哥先介绍一下层级，宏哥理解的其实就是操作层级，不对的话，欢迎批评指正。在 Playwright 中，测试层级为：

Broswer->Context->Page

3.浏览器操作

宏哥首先介绍一下浏览器常用的基本操作，然后再通过具体实例给小伙伴或者童鞋们演示一下。既然是浏览器的操作，那首先得将浏览器启动（打开）才能操作，因此首先介绍一下 playwright 如何启动浏览器。

3.1 启动浏览器

浏览器是通过 browser_type.launch（） 创建的。

browser = playwright.chromium.launch(headless=False, args=['--start-maximized'])

上面启动了一个浏览器，开启有头模式，并且通过 args 参数向 chrome 传递开启时窗口最大化。

开启浏览器格式为 playwright.browser_type.launch (...args)，browser_type 为浏览器类型，args 为传递给浏览器的参数，这个可以参考浏览器的官方文档。

忽略https://image.baidu.com/search/down?url=https告警：加入如下参数即可。

'--ignore-certificate-errors'

其他更多详细内容您可以参考官方文档，查看完整的 API 参数列表：BrowserType | Playwright Python

3.2 启动上下文

使用 browser.new_context() 创建 context 对象，context 之间是相互隔离的，可以理解为轻量级的浏览器实例。它不会与其他浏览器上下文共享 cookies/缓存。
如需要不同用户登录同一个网页，不需要创建多个浏览器实例，只需要创建多个 context 即可。

context = browser.new_context(no_viewport=True)

上下文就是浏览器的环境，Page 是页面包含了元素、组件的状态等等，而上下文则包括了会话状态、Cookie、页面信息等。

注意： 我们需要设置 no_viewport=True，否则将默认按照 800*600 创建视口，你会发现，窗口很大，但是网页很小。

3.3 为上下文添加 cookie

使用 add_cookies() 为上下文添加 cookie。

browser_context.add_cookies([cookie_object1, cookie_object2])

参数为字典列表，每个 cookie 字典有如下字段，其中 url 或者域名、path 虽然都是可选的，但必须要有一个。

name 名称

value 值

url 可选

domain 域名

path 路径

expires 浮点数，过期时间，Unix时间（精确到秒）可选

httpOnly 是否为httpOnly，可选

secure 安全模式，可选

sameSite "Strict"|"Lax"|"None" 同站策略，可选

3.4 访问页面

在 context 上新建一个页面对象然后调用 goto 方法即可。

page = context.new_page()
page.goto("https://image.baidu.com/search/down?url=https://www.baidu.com")

3.5 刷新、前进和后退

page.reload()
page.go_back()
page.go_forward()

3.6 浏览器窗口最大化

前边宏哥提到可以通过设置 args 参数 --start-maximized 并且设置 no_viewport=True

from playwright.sync_api import sync_playwright  

with sync_playwright() as p:  
    browser = p.chromium.launch(  
        headless=False,#关闭无头模式  
        args=['--start-maximized']  #设置谷歌浏览器参数  
    )  
    context = browser.new_context(no_viewport=True)  #设置no_viewport参数  
    page = context.new_page()  
    page.goto("https://image.baidu.com/search/down?url=https://www.baidu.com")  
    page.pause()

3.7 指定浏览器窗口的大小

我们可以通过 viewport 指定窗口大小。已知问题：浏览器不会贴合到屏幕左侧。

viewport 可以在 new_context 或者 new_page 方法中设置，都可生效。

from playwright.sync_api import sync_playwright  

with sync_playwright() as p :  
    browser  = p.chromium.launch(  
        headless=False,  
    )  
    context = browser.new_context(  
        viewport={'width': 1920, 'height': 1080},  
    )  
    page = context.new_page()  
    page.goto("https://image.baidu.com/search/down?url=https://www.baidu.com")  
    page.pause()

3.8 退出浏览器

先关闭上下文，再退出浏览器。

关闭上下文时，上下文所属的页面也会一起关闭。

browser_context.close()
browser.close()

3.9 以特定设备布局打开浏览器

from playwright.sync_api import sync_playwright

def run(playwright):
    iphone_13 = playwright.devices['iPhone 13']
    browser = playwright.webkit.launch(headless=False)
    context = browser.new_context(
        **iphone_13,
    )

with sync_playwright() as playwright:
    run(playwright)

4.项目实战

以度娘为例，首先启动浏览器，然后再设置浏览器的大小。查询 “北京宏哥” 后，刷新页面执行回退到百度首页，然后有执行前进进入到搜索 “北京宏哥” 页面，最后退出浏览器。

4.1 代码设计

按照上边的步骤进行代码设计，如下图所示：

4.2 参考代码

# coding=utf-8🔥

# 1.先设置编码，utf-8可支持中英文，如上，一般放在第一行

# 2.注释：包括记录创建时间，创建人，项目名称。
'''
Created on 2023-06-27
@author: 北京-宏哥   QQ交流群：705269076
公众号：北京宏哥
Project: 《《最新出炉》系列初窥篇-Python+Playwright自动化测试-7-浏览器的相关操作
'''

# 3.导入模块
from playwright.sync_api import sync_playwright

with sync_playwright() as p :
    # 1.启动浏览器
    browser  = p.chromium.launch(headless=False)
    # 2.设置浏览器窗口大小
    context = browser.new_context(viewport={'width': 1920, 'height': 1080},)
    page = context.new_page()
    # 3.访问度娘
    page.goto("https://image.baidu.com/search/down?url=https://www.baidu.com")
    # 等待5秒
    page.wait_for_timeout(5000)
    # 4.输入“北京宏哥”，点击“百度一下”
    page.fill("input[name=\"wd\"]", "北京宏哥")
    page.click("text=百度一下")
    # 等待5秒
    page.wait_for_timeout(5000)
    # 5.刷新页面
    page.reload()
    # 等待5秒
    page.wait_for_timeout(5000)
    # 6.浏览器后退
    page.go_back()
    # 等待5秒
    page.wait_for_timeout(5000)
    # 7.浏览器前进
    page.go_forward()
    # 8.浏览器退出
    page.wait_for_timeout(5000)
    context.close()
    browser.close()

4.3 运行代码

1.运行代码，右键 Run'Test'，控制台输出，如下图所示：

2.运行代码后电脑端的浏览器的动作，可以看到查询 “北京宏哥” 后，刷新页面执行回退到百度首页，然后有执行前进进入到搜索 “北京宏哥” 页面。如下图所示：

5.小结

好了，关于浏览器的相关操作非常简单，时间不早了今天就分享到这里，感谢你耐心地阅读！