自动化测试 / 系统课时
删除 Cookie
删除 Cookie
删除 Cookie 常用于验证退出登录、权限失效和测试隔离。本课直接使用 Selenium Python 的 delete_cookie() 与 delete_all_cookies(),并通过读取 Cookie 和刷新页面确认浏览器中的会话状态确实发生变化。
学习目标
- 能按名称删除单个 Cookie,并确认目标 Cookie 已不存在。
- 能清空当前页面关联的全部 Cookie,避免测试用例互相污染。
- 能区分“Cookie 已删除”和“应用已经退出登录”这两个不同的验证层次。
选择单个删除还是全部删除
Selenium 4.x Python 提供 delete_cookie(name) 和 delete_all_cookies()。前者按名称删除当前页面可关联到的同名 Cookie,名称区分大小写;后者删除当前页面关联到的全部 Cookie。它们不会替你清理 localStorage、sessionStorage 或服务端会话记录。
| 目标 | API | 删除后的直接检查 |
|---|---|---|
| 只移除认证 Cookie | driver.delete_cookie("session_id") |
driver.get_cookie("session_id") is None |
| 清理当前站点 Cookie | driver.delete_all_cookies() |
driver.get_cookies() == [] |
| 验证退出登录 | 删除认证 Cookie 后重新发起页面请求 | 登录页、401/403 或未登录元素出现 |
测试隔离时优先使用全部删除;只验证某个 Cookie 对业务的影响时使用单个删除,避免把主题、语言等无关 Cookie 一并清掉。
用脚本验证删除结果
以下示例适用于 Selenium 4.x Python。它先在 Selenium 官方测试页写入两个专用 Cookie,再删除其中一个,最后清空当前页面关联的 Cookie。示例只检查自己创建的 course_ 前缀,避免站点已有 Cookie 干扰输出。
from selenium import webdriver
URL = "https://www.selenium.dev/selenium/web/blank.html"
driver = webdriver.Chrome()
try:
driver.get(URL)
# 使用专用名称,避免与站点自身 Cookie 混淆。
driver.add_cookie({"name": "course_session", "value": "token-123"})
driver.add_cookie({"name": "course_prefs", "value": "compact"})
before = sorted(
c["name"] for c in driver.get_cookies()
if c["name"].startswith("course_")
)
print("before:", before)
driver.delete_cookie("course_session")
print("session deleted:", driver.get_cookie("course_session") is None)
print("prefs remains:", driver.get_cookie("course_prefs") is not None)
driver.delete_all_cookies()
after = [
c["name"] for c in driver.get_cookies()
if c["name"].startswith("course_")
]
print("after delete_all:", after)
finally:
driver.quit()预期输出:
before: ['course_prefs', 'course_session']
session deleted: True
prefs remains: True
after delete_all: []get_cookie() 在找不到指定名称时返回 None,因此它比只观察页面外观更适合做删除动作本身的断言。
验证会话是否真的失效
Cookie 被删掉后,当前页面已经渲染出的内容不会自动回滚。若应用使用 session_id 之类的 Cookie 做认证,应在删除后执行一次 driver.refresh(),或重新访问受保护 URL,让浏览器真正向服务器发起没有该 Cookie 的新请求。
例如原本访问 /account 会显示账户页,删除认证 Cookie 后应再次访问 /account,再检查是否跳转到 /login、出现登录按钮,或收到应用定义的未认证状态。只断言 get_cookie("session_id") is None 只能证明浏览器端 Cookie 消失,不能证明服务端已经拒绝该会话。
避免作用域导致的误判
WebDriver 的 Cookie 操作与当前浏览上下文的文档地址有关。删除前先导航到目标站点,再读取 driver.get_cookies() 确认目标名称确实可见;不要停留在 about:blank 或另一个域名上就判断删除结果。
实际排查可按“导航到目标域名 → get_cookie() 确认存在 → 删除 → 再次读取 → 刷新或访问受保护页面”执行。这样能把 Cookie 作用域问题和应用认证问题分开,失败时也能明确卡在哪一层。