Cypress -仅为一次测试设置userAgent

Cypress 是一个前端测试框架，它允许开发者为 web 应用编写集成测试和端到端测试。userAgent 是一个 HTTP 请求头字段，它标识了发起请求的用户代理软件的信息，通常用于识别浏览器类型、版本和操作系统等信息。

基础概念

在 Cypress 中设置 userAgent 可以模拟不同的浏览器环境，这对于测试应用在不同设备和浏览器上的兼容性非常有用。

类型与应用场景

类型：Cypress 允许通过配置或命令行参数设置 userAgent。
应用场景：
- 当你需要测试应用在不同浏览器（如 Chrome、Firefox、Safari）上的表现时。
- 当你需要模拟移动设备上的用户体验时。
- 当你需要验证应用对旧版浏览器的支持情况时。

设置方法

在 Cypress 配置文件中设置

你可以在 cypress.json 或 cypress.config.js 文件中设置 userAgent：

{
  "chromeWebSecurity": false,
  "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.3 Mobile/15E148 Safari/604.1"
}

或者在 cypress.config.js 中：

module.exports = defineConfig({
  chromeWebSecurity: false,
  userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.3 Mobile/15E148 Safari/604.1',
});

在测试文件中动态设置

你也可以在单个测试文件中动态设置 userAgent：

describe('My First Test', () => {
  beforeEach(() => {
    cy.visit('https://example.com', {
      onBeforeLoad(win) {
        Object.defineProperty(win.navigator, 'userAgent', {
          value: 'Mozilla/5.0 (Linux; Android 10) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.105 Mobile Safari/537.36',
        });
      },
    });
  });

  it('Visits the Kitchen Sink', () => {
    cy.contains('type').click();
  });
});