Chrome无头打印PDF是否存在page.emulateMedia('screen')的等价实现？

Chrome 命令行无头模式执行--print-to-pdf导出PDF时，默认会自动切换到print媒体类型加载对应CSS样式，与浏览器普通打印的默认行为一致。要强制使用屏幕端的样式规则完成PDF渲染，可通过以下方法实现：

核心实现参数 #

Chrome 118及以上版本原生提供了媒体类型指定参数，直接在命令行中追加即可实现和Puppeteer里page.emulateMedia('screen')完全一致的渲染效果：

• 必加配置参数：--print-to-css-media-type=screen
  完整命令示例如下：

chrome --headless=new --disable-gpu --print-to-pdf=output.pdf --print-to-css-media-type=screen https://target-website.com

常见注意事项 #

• 版本兼容：上述媒体类型参数仅在Chrome 118及以上版本原生支持，更早版本的Chrome没有对应的命令行开关，无法通过纯命令行完成配置。这类场景下需要通过Chrome DevTools Protocol 调用Emulation.setEmulatedMedia接口指定媒体类型为screen后，再触发打印流程，实现逻辑和Puppeteer的内置emulateMedia方法完全一致。
• 无头模式兼容：如果使用Chrome已废弃的旧版无头模式（即直接传入--headless而非--headless=new），部分版本会静默忽略上述媒体类型参数，需切换到新的无头实现才能让配置正常生效。
• 导出效果优化：启用屏幕媒体类型后，可按需追加以下参数进一步匹配真实屏幕端的导出效果：
  • --no-pdf-header-footer 移除PDF默认生成的网址、日期、页码类页眉页脚
  • --virtual-time-budget=10000 预留10秒的虚拟时间预算，等待页面动态资源、异步样式完全加载完成，避免导出的PDF出现样式缺失、内容错位的问题

内容的提问来源于stack exchange，提问作者Madamadam