WebdriverIO核心概念：Browser对象详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00713/article/details/148418524

WebdriverIO核心概念：Browser对象详解

webdriverio Next-gen browser and mobile automation test framework for Node.js 项目地址: https://gitcode.com/gh_mirrors/we/webdriverio

前言

WebdriverIO作为现代Web自动化测试框架，其核心对象Browser承担着与浏览器交互的重要职责。本文将深入剖析Browser对象的特性、方法和使用场景，帮助开发者更好地掌握WebdriverIO的核心机制。

Browser对象概述

Browser对象是WebdriverIO中最重要的实例对象，它代表着一个浏览器会话实例。通过这个对象，开发者可以控制浏览器或移动设备的各种行为。

创建方式

Browser对象的创建方式取决于使用模式：

测试运行器模式：通过全局变量browser或driver访问
独立模式：通过remote方法返回

核心属性解析

Browser对象包含多个重要属性，下面分类介绍：

会话相关属性

| 属性名 | 类型 | 描述 | |-------|------|------| | sessionId | String | 远程服务器分配的会话ID | | capabilities | Object | 远程服务器分配的实际能力集 | | requestedCapabilities | Object | 请求的能力集 |

环境标识属性

| 属性名 | 类型 | 描述 | |-------|------|------| | isW3C | Boolean | 是否为W3C标准会话 | | isChrome | Boolean | 是否为Chrome实例 | | isFirefox | Boolean | 是否为Firefox实例 | | isBidi | Boolean | 是否使用Bidi协议 |

移动设备相关属性

| 属性名 | 类型 | 描述 | |-------|------|------| | isMobile | Boolean | 是否为移动会话 | | isIOS | Boolean | 是否为iOS会话 | | isAndroid | Boolean | 是否为Android会话 | | isNativeContext | Boolean | 是否处于原生应用上下文 | | mobileContext | String | 当前上下文类型 |

核心方法详解

自定义命令方法

addCommand - 添加自定义命令
- 参数：
  - commandName: 命令名称
  - fn: 命令函数
  - attachToElement: 是否附加到元素对象
overwriteCommand - 覆盖原生命令
- 参数同上
- 需谨慎使用，可能影响框架原有行为
addLocatorStrategy - 添加自定义选择器策略
- 参数：
  - strategyName: 策略名称
  - fn: 策略函数

移动设备标志使用技巧

在实际测试中，经常需要针对不同设备类型编写特定逻辑。WebdriverIO提供了便捷的移动设备标志：

// 检查设备类型
if (browser.isMobile) {
    // 移动设备特有逻辑
    if (browser.isIOS) {
        // iOS特有逻辑
    } else if (browser.isAndroid) {
        // Android特有逻辑
    }
}

实际应用示例

跨平台选择器处理

class LoginPage {
    get username() {
        const androidSelector = 'android=new UiSelector().text("Username")'
        const iosSelector = 'ios=UIATarget.localTarget().frontMostApp().mainWindow().textFields()[0]'
        return $(browser.isAndroid ? androidSelector : iosSelector)
    }
}

平台特定测试用例

describe('跨平台测试套件', () => {
    it('通用测试用例', () => { /*...*/ })
    
    if (browser.isIOS) {
        it('iOS专属测试', () => { /*...*/ })
    }
})

事件系统详解

Browser对象继承自Node.js的EventEmitter，提供了丰富的事件机制：

核心事件类型

命令相关事件
- command: 发送WebDriver命令时触发
- result: 收到命令结果时触发
Bidi协议事件
- bidiCommand: 发送Bidi命令时触发
- bidiResult: 收到Bidi结果时触发
请求生命周期事件
- request.start: 请求开始时触发
- request.end: 请求结束时触发
- request.retry: 请求重试时触发
- request.performance: 请求性能数据可用时触发

事件监听示例

// 监听命令执行
browser.on('command', (cmd) => {
    console.log(`执行命令: ${cmd.command}`)
})

// 监听请求性能
browser.on('request.performance', (perf) => {
    if (perf.durationMillisecond > 1000) {
        console.warn('慢请求警告:', perf)
    }
})