自动化测试 / 系统课时

读取与添加 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。端口由操作系统动态分配,实际值每次可能不同。

python
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()

预期输出:

text
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 不只是“写进浏览器”,而是真的被应用接受。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取与添加 Cookie

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通