Skip to content

设备模拟

📱 用 `--device` 模拟手机/平板/桌面。

标志

标志说明
--device设备预设名(如 iphone-15
--list-devices列出全部可用预设

列出预设

bash
snir scan --list-devices

预设覆盖主流真机

预设含 iPhone/iPad 全系、Pixel/Galaxy 主力机型、桌面三档(1080p/1440p/4K)。一个 --device 名同时设置视口、UA、像素比、移动端标记、触摸仿真——比手动调五个参数省事且不易出错。

可用预设(部分)

名称设备
iphone-15-proiPhone 15 Pro
iphone-15iPhone 15
iphone-14-pro-maxiPhone 14 Pro Max
iphone-seiPhone SE (3rd gen)
ipad-pro-12iPad Pro 12.9
ipad-airiPad Air
ipad-miniiPad Mini
pixel-8-proPixel 8 Pro
pixel-8Pixel 8
pixel-7Pixel 7
galaxy-s24Samsung Galaxy S24
galaxy-s23-ultraSamsung Galaxy S23 Ultra
galaxy-tab-s9Samsung Galaxy Tab S9
desktop-1080pDesktop 1080p
desktop-1440pDesktop 1440p
desktop-4kDesktop 4K

示例

bash
# iPhone 视角
snir scan example.com --device iphone-15

# iPad
snir scan example.com --device ipad-pro-12

# 桌面 4K
snir scan example.com --device desktop-4k

预设应用了什么

DevicePreset 包含:

  • 视口宽高
  • User-Agent
  • 设备像素比(scaleFactor)
  • 是否移动端视口
  • 是否触摸

ApplyToOptions 把这些写入 Options.Chrome。一个 --device 预设展开为五项浏览器配置:

--device 预设展开为 CDP Emulation 调用的时序:

自定义视口

不用预设时,可手动设:

bash
snir scan example.com --resolution-x 390 --resolution-y 844 --user-agent "..."

SDK 可用 WithDeviceEmulation(width, height, scaleFactor, isMobile, hasTouch) 精细控制。见 视口与设备

下一步

基于 MIT 许可发布