SeleniumBase 视觉回归测试实战:用 Case Plan 复现 check_window 布局变更检测(python.org Donate 按钮移除示例)
SeleniumBase 视觉回归测试实战用 Case Plan 复现 check_window 布局变更检测python.org Donate 按钮移除示例【免费下载链接】SeleniumBaseAPIs for browser automation, testing, and bypassing bot-detection. Includes CDP Mode: A stealthy configuration for chromium that passes every bot detection test.项目地址: https://gitcode.com/GitHub_Trending/se/SeleniumBase导读本文以 SeleniumBase 仓库中 examples/visual_testing/case_plans/test_layout_fail.VisualLayout_FixtureTests.test_python_home_change.md 这份 Case Plan 为骨架完整讲解self.check_window()驱动的视觉回归测试如何工作。你将掌握Case Plan 与测试代码的对应关系、baselineTrue基线建立、remove_element()修改页面 DOM、level3严格比对模式以及失败时side_by_side.html对比报告的生成原理。读完即可独立复现移除元素导致视觉回归失败的完整流程并理解底层源码实现。一、Case Plan 是什么一段测试计划的 Markdown 表格在深入视觉测试细节之前先认识这份文档本身。SeleniumBase 的Case Plans测试用例计划是一种基于 Markdown 表格的测试管理方式可以直接在代码托管平台上渲染展示。其完整机制记录在 help_docs/case_plans.md 中每个 Case Plan 以测试文件.py::测试类::测试方法的格式作为标题行正文是一张# | Step Description | Expected Result三列表格#为步骤序号-为分隔行单个 Case Plan 存放在测试文件所在目录的case_plans/文件夹中多个 Case Plan 可通过sbase caseplans图形界面汇总生成case_summary.md摘要文件仓库中已有实例examples/case_summary.md。本文主角这份 Case Plan 原文如下它精确描述了test_layout_fail.py中VisualLayout_FixtureTests::test_python_home_change这个测试的两步行为| # | Step Description | Expected Result | | - | ---------------- | --------------- | | 1 | Open https://python.org/.Callcheck_window()withbaselineTrue. | | | 2 | Remove theDonatebutton usingremove_element(SELECTOR).Callcheck_window()withlevel3. | The test fails because theDonatebutton was removed.Aside_by_side.htmlfile appears in the specificlatest_logs/folder of the test. |Markdown 表格书写有严格约定表头分隔行必须由|、-、空格按正确位置排列步骤内需要换行时使用br /空步骤在两个竖线之间留空格| |。这些约定同样记录在 help_docs/case_plans.md 中是生成可渲染 Case Plan 的前提。二、Case Plan 对应的测试源码Fixture 风格与类风格两种写法该 Case Plan 对应的真实测试位于 examples/visual_testing/test_layout_fail.py。该文件同时示范了 SeleniumBase 两种主流语法格式Visual Layout Testing with different Syntax Formats from seleniumbase import BaseCase BaseCase.main(__name__, __file__) class VisualLayout_FixtureTests: def test_python_home_change(self, sb): sb.goto(https://python.org/) print(\nCreating baseline in visual_baseline folder.) sb.check_window(namepython_home, baselineTrue) # Remove the Donate button sb.remove_element(a.donate-button) print((This test should fail)) # due to missing button sb.check_window(namepython_home, level3) class VisualLayoutFailureTests(BaseCase): def test_xkcd_logo_change(self): self.goto(https://xkcd.com/554/) print(\nCreating baseline in visual_baseline folder.) self.check_window(namexkcd_554, baselineTrue) # Change height: (83 - 110) , Change width: (185 - 120) self.set_attribute([altxkcd.com logo], height, 110) self.set_attribute([altxkcd.com logo], width, 120) print((This test should fail)) # due to a resized logo self.check_window(namexkcd_554, level3)两种写法对同一套 API 的调用完全一致Fixture 风格VisualLayout_FixtureTests类不继承BaseCase方法签名接收sb参数通过 pytest fixture 注入 SeleniumBase 实例。文件顶部的BaseCase.main(__name__, __file__)让脚本既可以直接运行也可被 pytest 收集。类风格VisualLayoutFailureTests继承BaseCase使用self.前缀调用同名方法。同文件的test_xkcd_logo_change还演示了用set_attribute()篡改 logo 尺寸的另一种回归触发方式与remove_element()殊途同归。三、建立视觉基线check_window(baselineTrue) 做了什么第 1 步sb.check_window(namepython_home, baselineTrue)的作用是为名为 python_home 的窗口建立视觉基线。首次以某个唯一name调用check_window()时SeleniumBase 会自动创建基线文件夹seleniumbase/fixtures/base_case.py 中的方法 docstring 明确了基线目录的生成逻辑基线文件夹以测试名 name 参数命名同一个测试可以存放多个不同name的基线文件夹保存在visual_baseline/目录下存储目录常量VisualBaseline.STORAGE_FOLDER visual_baseline定义于 seleniumbase/fixtures/constants.py目录初始化由 seleniumbase/core/visual_helper.py 的visual_baseline_folder_setup()完成多线程场景下并发创建由except Exception容错。基线文件夹建立后会生成 5 个文件详见 examples/visual_testing/ReadMe.md文件内容page_url.txt当前窗口的 URLbaseline.png基线截图PNGtags_level1.txt页面 HTML 标签tags_level2.txtHTML 标签 属性名tags_level3.txtHTML 标签 属性名/属性值关键设计点视觉回归比对的不是像素而是 HTML 标签与属性的结构。因此页面纯文本变化不会触发失败而 DOM 结构、属性名或属性值的改变才会被检出。这正是文本变更不影响视觉比对一说的来源。四、制造变更remove_element() 如何删除 Donate 按钮第 2 步先用sb.remove_element(a.donate-button)移除 python.org 首页的 Donate 按钮再执行sb.check_window(namepython_home, level3)触发严格比对。remove_element()的实现位于 seleniumbase/fixtures/base_case.py其底层并非 Selenium 点击操作而是通过 JavaScript 直接操作 DOM先等待body可见再以timeout0.5短暂等待目标元素出现将传入选择器统一转换为 CSS 选择器convert_to_css_selector普通 CSS 选择器走document.querySelector()parentElement.removeChild()移除首个匹配元素含:contains(的 jQuery 风格选择器则退化为jQuery(...).remove()或元素级删除删除前会对选择器做re.escape转义与引号处理保证特殊字符安全。与之配套的remove_elements()seleniumbase/fixtures/base_case.py则用querySelectorAll遍历删除全部匹配元素。此外文件还演示了set_attribute()修改元素属性来制造差异说明变更页面的手段是开放的——只要改变 DOM 结构或属性即可。五、触发失败check_window(level3) 的比对机制check_window()的完整签名seleniumbase/fixtures/base_case.pydef check_window( self, namedefault, level0, baselineFalse, check_domainTrue, full_diffFalse, ):调用前方法会先执行wait_for_ready_state_complete()并等待body可见确保页面稳定若处于 Demo Mode 还会输出警告Demo Mode 的 HTML 改动可能干扰比对。随后参数被规整为 0/1/2/3 四个合法值非法值直接抛异常。level 严格度体系同时记录于 seleniumbase/fixtures/base_case.py 与 examples/visual_testing/ReadMe.mdlevel比对内容行为level0仅干跑与基线比对并打印差异但不失败level1HTML 标签对照tags_level1.txtlevel2标签 属性名对照tags_level1.txt与tags_level2.txtlevel3标签 属性名/值对照全部三个tags_level*.txt最严格注意 level 的累积语义level2实际同时比对 level1 与 level2level3则三层全比。基线建立baselineTrue时 level 参数不参与比对仅用于后续运行。两个重要防线域名校验当前页面域名与基线 URL 域名不一致时抛出 Page Domain Mismatch Failure可通过check_domainFalse关闭。同测试内自比对在同一个测试中对同一name多次调用check_window()时第一次传baselineTrue即可将当次页面快照作为基线与后续版本对比——这正是本 Case Plan 的核心用法。另外full_diffTrue可让报错输出列出全部差异元素默认False只显示第一个差异元素。六、失败产物side_by_side.html 与 latest_logs 目录按 Case Plan 的预期结果level3比对必然失败Donate 按钮已被移除此时测试在该测试专属的latest_logs/目录下生成side_by_side.html对比报告。报告生成链路清晰可查文件名常量SideBySide.HTML_FILE side_by_side.html定义于 seleniumbase/fixtures/constants.pyHTML 由 seleniumbase/core/visual_helper.py 的get_sbs_html()拼装包含 baseline 与失败截图并排对比的表格结构get_sbs_table_row()生成左右两列img写入逻辑在 seleniumbase/fixtures/base_case.py将 HTML 写入test_logpath即该测试的latest_logs/目录同时基线 PNG 与最新截图latest.png也会被拷贝到该目录方便人工核对基线是否需要重置。典型的level3失败输出来自 examples/visual_testing/ReadMe.md对应 python.org 场景形如AssertionError: First differing element 33: [a, [[class, [donate-button]], [href, /psf/donations/]]] [div, [[class, [options-bar]]]] ... *** Exception: Level 3 Visual Diff Failure: * HTML tag attribute values dont match the baseline!AssertionError中的First differing element精确指出是第 33 个结构元素——基线中是a.donate-button锚点当前页面中该位置已变成div.options-bar。这是结构比对而非像素比对最直观的验证差异来自 DOM 节点缺失导致的序列错位。七、运行与基线维护运行测试在 examples/visual_testing 目录下执行pytest test_layout_fail.py --htmlreport.html--htmlreport.html会同时生成 pytest HTML 报告。注意VisualLayout_FixtureTests依赖 pytest fixture 注入sb因此必须经 pytest 运行文件顶部的BaseCase.main(__name__, __file__)也支持直接python test_layout_fail.py方式执行。重置视觉基线当被测网站发生预期的布局改版时需要重置基线以避免误报。在命令行追加参数即可pytest test_layout_fail.py --visual_baseline只要带--visual_baseline运行check_window()就不会失败——它会重建视觉基线而非与旧基线比对。这是官网文档与源码 docstring 共同确认的官方用法。适用边界check_window()对动态内容网站效果有限动态内容会改变页面布局与结构导致误报。对这类站点建议改用常规功能测试或在比对前先清除动态元素例如用ad_block()移除广告等动态内容再执行比对。八、延伸把 Case Plan 纳入团队流程回到 Case Plan 本身它是 SeleniumBase 测试管理的一部分创建运行sbase caseplans实现在 seleniumbase/console_scripts/sb_caseplans.py启动图形界面选择需要 Case Plan 的测试一键为缺失者生成带默认表格的样板文件支持-k、-m、指定文件或目录等与 pytest 一致的选择规则汇总通过界面按钮生成case_summary.md摘要汇总所有case_plans/目录下的计划。摘要文件生成于启动 GUI 的目录而单个 Case Plan 生成于测试所在目录的case_plans/下——两者位置不同多测试目录时会出现多个case_plans/文件夹协作价值Case Plan 让视觉回归测试的操作步骤 预期结果以人类可读的 Markdown 表格沉淀在代码库中既可作为测试文档也可作为评审与排期依据。总结从一份两行的 Case Plan 出发本文完整还原了 SeleniumBase 视觉回归测试的闭环check_window(baselineTrue)建立结构化基线 →remove_element()以 JS 修改 DOM →check_window(level3)做最严格的结构比对 → 失败时在latest_logs/生成side_by_side.html并输出差异元素定位。整个过程的核心设计是用 HTML 标签与属性替代像素截图做对比配合level严格度分级、--visual_baseline基线重置与 Case Plan 文档化机制为网页布局回归提供了一套可审计、可复现、低误报的自动化方案。【免费下载链接】SeleniumBaseAPIs for browser automation, testing, and bypassing bot-detection. Includes CDP Mode: A stealthy configuration for chromium that passes every bot detection test.项目地址: https://gitcode.com/GitHub_Trending/se/SeleniumBase创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

OpenProject 10.4.1 升级修复指南:时间条目数据恢复与关键 Bug 修复全解析

OpenProject 10.4.1 升级修复指南:时间条目数据恢复与关键 Bug 修复全解析

OpenProject 10.4.1 升级修复指南:时间条目数据恢复与关键 Bug 修复全解析 【免费下载链接】openproject OpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with …

2026/11/18 7:32:59 阅读更多 →
轻量级PHP社区论坛源码:四层解耦与生产级自适应实现

轻量级PHP社区论坛源码:四层解耦与生产级自适应实现

简介:这是一套面向Web开发者与中小型社区项目搭建者的简约型PHP社区论坛源码,聚焦轻量、安全与可扩展性,解决传统论坛臃肿难维护、移动端适配差、后台功能缺失等痛点。资源包为7.04MB的RAR压缩文件,含完整前后端代码、通用后台系统…

2026/11/18 7:33:00 阅读更多 →
TanStack Router 使用 Webpack 集成文件路由:从零配置到自动代码分割

TanStack Router 使用 Webpack 集成文件路由:从零配置到自动代码分割

TanStack Router 使用 Webpack 集成文件路由:从零配置到自动代码分割 【免费下载链接】router 🤖 A client-first, server-capable, fully type-safe router and full-stack framework for the web (React and more). 项目地址: https://gitcode.com/G…

2026/11/18 7:33:00 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/17 8:22:52 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/17 12:46:04 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/17 12:46:04 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/17 11:26:33 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/17 12:46:05 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/17 12:46:05 阅读更多 →

日新闻

周新闻

月新闻