本文介绍在 selenium（java + chrome）中通过配置 chrome 偏好设置，精准控制网页文字大小（而非页面整体缩放），适用于 sauce labs 等云测试平台，有效解决 document.body.style.zoom 导致的全局缩放误用问题。
本文介绍在 selenium（java + chrome）中通过配置 chrome 偏好设置，精准控制网页文字大小（而非页面整体缩放），适用于 sauce labs 等云测试平台，有效解决 document.body.style.zoom 导致的全局缩放误用问题。
在移动端浏览器中，“Zoom text”（仅放大文字）是一项独立于页面缩放的可访问性功能——它仅调整默认字体尺寸（如常规字体、等宽字体），不影响布局、图片或元素尺寸。而常见的 JavaScript 方式（如 document.body.style.zoom = '1.5' 或 transform: scale()）实际执行的是 CSS 页面级缩放，会扭曲布局、触发重排，且不符合 WCAG 可访问性要求，也无法被屏幕阅读器正确识别。
Selenium 本身不提供直接调用浏览器“文字缩放”UI 的 API，但可通过 Chrome 浏览器底层偏好（Preferences）实现等效效果。关键在于设置 Chromium 内核的 WebKit 渲染偏好项：default_font_size（常规字体）和 default_fixed_font_size（等宽字体），单位为像素（px）。
以下是在 Java 中结合 Sauce Labs 远程 WebDriver 的完整配置示例：
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.RemoteWebDriver;
import org.openqa.selenium.chrome.ChromeOptions;
import com.google.common.collect.ImmutableMap;
// 构建 Chrome 配置，启用“大号文字”效果（对应浏览器设置中的 "Large"）
ChromeOptions options = new ChromeOptions();
Map<string object> preferences = ImmutableMap.of(
"webkit", ImmutableMap.of(
"webprefs", ImmutableMap.of(
"default_fixed_font_size", 17, // 等宽字体（如 <code>、<pre class="brush:php;toolbar:false;">）
"default_font_size", 20 // 常规字体（如 <p>、<span>）
)
)
);
options.setExperimentalOption("prefs", preferences);
// 指向 Sauce Labs 的 Remote URL（需替换为实际 sauceUrl 和 capability）
String sauceUrl = "https://your-username:your-access-key@ondemand.us-west-1.saucelabs.com:443/wd/hub";
WebDriver driver = new RemoteWebDriver(sauceUrl, options);</span></p>
✅ 推荐字号参考（基于 Chrome 默认值）：
- Medium（默认）：default_font_size = 16, default_fixed_font_size = 13
- Large：default_font_size = 20, default_fixed_font_size = 17
- Very Large：default_font_size = 24, default_fixed_font_size = 20
⚠️ 注意事项：
- 此配置仅对 Chrome/Chromium 有效（Firefox 需使用 layout.css.devPixelsPerPx，Safari 不支持远程配置）；
- 必须在初始化 RemoteWebDriver 之前 设置 prefs，运行时无法动态修改；
- Sauce Labs 支持 Chrome 实验性选项，但需确保所用 Chrome 版本 ≥ 90（推荐 ≥ 115）；
- 若需验证效果，可在会话中访问 chrome://prefs-internals/（仅限本地调试；Sauce Labs 环境不可访问，建议通过 DOM 文字渲染对比或截图比对确认）；
- 该方式真正模拟系统级文字缩放，不影响 window.devicePixelRatio、CSS 媒体查询或响应式断点，是自动化可访问性测试的可靠方案。
总结而言，绕过 JavaScript 的视觉欺骗，转而通过浏览器内核偏好精准调控字体渲染，才是 Selenium 中实现合规“文字缩放”的正确路径。
