自动化测试 / 系统课时
读取与添加 Cookie
读取与添加 Cookie
Selenium 可以直接读取当前浏览上下文可见的 Cookie,也可以向当前站点写入指定 Cookie。本篇用本地 HTTP 页面演示 get_cookie()、get_cookies() 与 add_cookie(),并说明域名、路径和安全属性的边界。
学习目标
- 读取当前页面可见的单个 Cookie 与完整 Cookie 列表。
- 使用
add_cookie()写入指定名称、值和路径的 Cookie。 - 识别域名不匹配、路径错误和安全属性导致的写入或读取问题。
Cookie 操作受当前域名约束
调用 add_cookie() 前,浏览器必须先打开 Cookie 所属的站点。典型顺序是先 driver.get('https://example.test/'),再写入 Cookie;如果当前页还是 about:blank,或者想给另一个无关域名写 Cookie,浏览器会拒绝。
读取时,get_cookie('session_id') 适合查一个确定名称,找不到会返回 None;get_cookies() 返回当前页面上下文可见的 Cookie 列表。做认证复用时,常见流程是打开目标域名、写入认证 Cookie、刷新页面,再验证用户菜单等登录后元素。
完整读取与添加示例
下面示例启动一个只监听本机的临时 HTTP 服务,浏览器先访问 http://127.0.0.1:<PORT>/,再写入并读取 Cookie。端口由操作系统动态分配,实际值每次可能不同。
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from threading import Thread
from selenium import webdriver
class FixtureHandler(BaseHTTPRequestHandler):
def do_GET(self):
body = b'<html><body>cookie fixture</body></html>'
self.send_response(200)
self.send_header('Content-Type', 'text/html; charset=utf-8')
self.send_header('Content-Length', str(len(body)))
self.end_headers()
self.wfile.write(body)
def log_message(self, format, *args):
pass
server = ThreadingHTTPServer(('127.0.0.1', 0), FixtureHandler)
Thread(target=server.serve_forever, daemon=True).start()
driver = webdriver.Chrome()
try:
base_url = f'http://127.0.0.1:{server.server_port}/'
driver.get(base_url)
driver.add_cookie({
'name': 'session_hint',
'value': 'abc123',
'path': '/',
})
one = driver.get_cookie('session_hint')
assert one is not None
all_cookies = driver.get_cookies()
names = sorted(cookie['name'] for cookie in all_cookies)
print(f"cookie={one['name']}:{one['value']}")
print('visible_cookie_names=' + ','.join(names))
finally:
driver.quit()
server.shutdown()
server.server_close()预期输出:
cookie=session_hint:abc123
visible_cookie_names=session_hint这个例子没有由服务器额外下发 Cookie,所以列表中只有 session_hint。在真实站点中,分析工具、负载均衡或应用自身可能写入更多 Cookie,因此断言时通常按名称查找,不要假设列表长度固定为 1。
Cookie 字段怎么选
add_cookie() 至少需要 name 和 value。其他字段按站点策略补充,尤其不要随意填写 domain;省略它通常会让 Cookie 归属当前主机,更适合测试夹具和单域名系统。
| 字段 | 常见取值 | 使用建议 |
|---|---|---|
name |
session_id |
必填,名称应与应用实际读取的 Cookie 一致 |
value |
abc123 |
必填,认证 Cookie 通常来自测试环境登录或专用接口 |
path |
/ |
常见默认范围;只希望对子路径生效时再缩小 |
domain |
.example.test |
可选,必须与当前站点的域范围兼容 |
secure |
True |
只应在 HTTPS 场景使用 |
httpOnly |
True |
限制页面 JavaScript 读取,不影响 WebDriver Cookie API |
expiry |
Unix 秒级时间戳 | 需要明确过期时间时使用 |
sameSite |
Strict、Lax、None |
Selenium 4 Python 接受这三种值 |
如果站点要求 SameSite=None,实际浏览器通常还要求 Cookie 同时带 Secure,因此应在 HTTPS 测试环境验证,而不是在本地 HTTP 夹具上硬套这一组合。
常见失败与验证
添加 Cookie 抛出域名相关异常时,先打印 driver.current_url,确认浏览器确实已经进入目标站点,再检查 domain 是否写得过宽或写成另一个主机。认证复用失败时,再检查 path、expiry、secure 和 sameSite 是否与真实会话一致。
写入成功后不要只相信 add_cookie() 没报错。至少用 get_cookie() 核对名称和值;若目的是恢复登录态,还要执行 driver.refresh() 或重新进入受保护页面,并等待用户菜单、账户名或其他认证后信号出现。这样才能确认 Cookie 不只是“写进浏览器”,而是真的被应用接受。