TesterHome

自动化工具 在移动端测试自动化中利用 AnyProxy Mock 数据，测试埋点功能

黑水 · 2018年03月25日 · 最后由 黑水 回复于 2020年05月28日 · 2751 次阅读

本帖使用的示例代码在这里
20180705 更新：发现不需要使用数据库中转数据，所以在 master 分支去掉了 SQLite 和 Sequelize，老代码在 using-SQLite 分支

Mock 数据

以 TesterHome iOS 客户端为例，一个测试点是：在话题列表，很长的标题能不能正确展示。
如果组织分工上移动端团队是分离的，或者功能上这个列表是智能推荐，或者技术上测试环境治理水平不高接口总是不可用，测试和开发同学在测试这点时最常见的选择是通过代理工具将标题改长，观察 App 的展示效果，延后对服务端的依赖。
比如 TesterHome 客户端里，启动后首屏请求
https://testerhome.com/api/v3/topics.json?limit=40&offset=0&type=last_actived
获取话题列表，把 title 改长再返回给客户端：

{
    "topics": [{
        "id": 12390,
        "title": "职业这条不归路上！总监们帮你解惑",
        "replies_count": 21,
        "node_name": "活动沙龙",
        "user": {
            "id": 3903,
            "abilities": {
                "update": false,
            }
        },
        "abilities": {
            "update": false
        }
    }]
}

想在 UI 自动化时也使用这个方式，需要代理工具支持可编程的方式编写规则、和外部交互，比如 AnyProxy 。
替换标题的规则文件如下：

module.exports = {
    *beforeSendResponse(requestDetail, responseDetail) {
        // 这个请求响应 Code 可能是 304
        if ((requestDetail.url.indexOf('https://testerhome.com/api/v3/topics.json?limit=40&offset=0&type=last_actived') === 0) && responseDetail.response.statusCode === 200) {
            let newResponse = responseDetail.response
            let jsonBody = JSON.parse(newResponse.body.toString())
            jsonBody.topics[1].title = '很长很长的标题显示测试' + Date.now()
            newResponse.body = JSON.stringify(jsonBody)
            return {
                response: newResponse
            }
        }
    }
}

如果使用 Appium ，为了方便和 AnProxy 交互，可以选一个 JavaScript 实现的客户端，比如 WebdriverIO 。
在 AnyProxy 的规则文件里声明引用类型的变量，在 WebdriverIO 的用例中给这个变量赋值，这样不同用例使用不同值的时候不需要修改 AnyProxy 规则文件。
于是 AnyProxy 规则文件变成这样：

let testData = {}

module.exports = {
    testData: testData,
    *beforeSendResponse(requestDetail, responseDetail) {
        // 这个请求响应 Code 可能是 304
        if ((requestDetail.url.indexOf('https://testerhome.com/api/v3/topics.json?limit=40&offset=0&type=last_actived') === 0) && responseDetail.response.statusCode === 200) {
            let newResponse = responseDetail.response
            let jsonBody = JSON.parse(newResponse.body.toString())
            if (Object.keys(testData).length !== 0) {
                jsonBody.topics[testData.index].title = testData.title
            }
            newResponse.body = JSON.stringify(jsonBody)
            return {
                response: newResponse
            }
        }
    }
}

WebdriverIO 用例这样写：

const assert = require('assert')
let { testData } = require('../rules') //引入 AnyProxy 规则文件

describe('TesterHome', function () {
    it('修改数据', function () {
        testData.index = 1
        testData.title = '很长很长的标题显示测试' + Date.now()

        // Appium 在建立 session 后就会启动 App，这时候 testData 还没被赋值，所以在赋值后重启 App 重新获取话题列表数据
        browser.closeApp()
        browser.launch()
        browser.pause(3000)

        // 话题列表话题的 Xpath 序号从 1 开始，但 HTTP 响应的 JSON 是从 0 开始
        const listIndex = testData.index + 1
        const locator = `//XCUIElementTypeTable/XCUIElementTypeCell[${listIndex}]/XCUIElementTypeStaticText`
        assert.equal($(locator).getText(), testData.title)
    })
})

完整的测试执行过程是这样的：
1、 获取执行机 IP 。
2、 iOS 使用 Appium(WebDriverAgent)，通过 UI 自动化的方式打开 “设置” 修改代理，Android 通过 ADB 修改代理，比如用这个 AndroidProxySetter 。
3、 启动 WebdriverIO 测试，通过 WebdriverIO 的钩子，在 Appium 建立 session 前启动 AnyProxy 。

// wdio.conf.js

let rules = require('./rules') //引入 AnyProxy 规则文件

// AnyProxy 启动参数
const options = {
    port: 8001,
    rule: rules,
    webInterface: {
        enable: true,
        webPort: 8002,
        wsPort: 8003,
    },
    throttle: 10000,
    forceProxyHttps: true,
    silent: true
}
const proxyServer = new AnyProxy.ProxyServer(options)
proxyServer.on('ready', () => { console.log("anyproxy ready") })
proxyServer.on('error', (e) => { console.log("anyproxy error") })

exports.config = {
    beforeSession: function (config, capabilities, specs) {
        // 启动 AnyProxy
        proxyServer.start()
    }
}

4、 进入测试用例，给需要的、代表测试数据的变量赋值。
5、 重启 App，这时候 App 获取的数据会被 AnyProxy 改为前一步赋予的值。
6、 验证 App 功能是否正确。
7、 通过 WebdriverIO 的钩子，在 Appium 关闭 session 后停止 AnyProxy 。

// wdio.conf.js

exports.config = {
    afterSession: function (config, capabilities, specs) {
        // 停止 AnyProxy
        proxyServer.close()
    }
}

8、 恢复手机为没有使用代理的状态。

测试埋点功能

TesterHome 用了 google-analytics 做统计，启动 App 进入首页会触发一个 GET 请求
https://www.google-analytics.com/collect?v=1&_v=j66&a=18908429&t=pageview&_s=1&dl=https%3A%2F%2Ftesterhome.com%2Ftopics%3Faccess_token%3Dfa09aacd46441b55e6d64d04983798edfc2914d024d62cf2d469ff754193592f&ul=zh-cn&de=UTF-8&dt=%E7%A4%BE%E5%8C%BA%20%C2%B7%20TesterHome&sd=32-bit&sr=414x736&vp=100x56&je=0&_u=ACCAgEQ~&jid=147019750&gjid=698481509&cid=1198303934.1481097811&tid=UA-45014075-1&_gid=666582918.1521891128&z=349772242
URL decode 之后是：
https://www.google-analytics.com/collect?v=1&_v=j66&a=18908429&t=pageview&_s=1&dl=https://testerhome.com/topics?access_token=fa09aacd46441b55e6d64d04983798edfc2914d024d62cf2d469ff754193592f&ul=zh-cn&de=UTF-8&dt=社区 · TesterHome&sd=32-bit&sr=414x736&vp=100x56&je=0&_u=ACCAgEQ~&jid=147019750&gjid=698481509&cid=1198303934.1481097811&tid=UA-45014075-1&_gid=666582918.1521891128&z=349772242

如果使用 AnyProxy ，发现这个请求的时候把这些数据持久化，比如存入本地的 SQLite 数据库，就可以在测试用例中去验证了。
AnyProxy 规则文件如下，这里使用了 Sequelize 这个 Node.js 的 ORM 库。

const querystring = require('querystring')
const fs = require('fs')
const Sequelize = require('sequelize')

// 每次启动 AnyProxy 的时候使用新的 SQLite 数据库
const databaseFile = './database.sqlite'
if (fs.existsSync(databaseFile)) {
    console.log('Removing ' + databaseFile)
    fs.unlinkSync(databaseFile)
  }

// sequelize 配置信息
const sequelize = new Sequelize('mainDB', null, null, {
    host: 'localhost',
    dialect: 'sqlite',
    logging: false,

    pool: {
        max: 15,
        min: 0,
        acquire: 30000,
        idle: 10000
    },

    storage: databaseFile
})

// 建立数据库连接
sequelize.authenticate().then(() => {
    console.log('Database connection has been established successfully.')
}).catch(err => { 
    console.error('Unable to connect to the database:', err)
})

// 定义 Model，表示 www.google-analytics.com/collect 请求中 query string 和表结构的对应关系
const Collect = sequelize.define('collect', {
    id: {
        type: Sequelize.INTEGER,
        primaryKey: true,
        autoIncrement: true
    },
    t: {
        type: Sequelize.STRING
    },
    dt: {
        type: Sequelize.STRING
    }
})

module.exports = {
    *beforeSendRequest(requestDetail) {
        if (requestDetail.url.indexOf('https://www.google-analytics.com/collect') === 0) {
            const collect = querystring.parse(requestDetail.requestOptions.path)
            // 将埋点上报数据存入数据库
            Collect.sync({ force: false }).then(() => {
                return Collect.create(collect).then(() => {
                    return null
                }).catch(error => {
                    console.log('[Database] error' + error)
                })
            })
        }
    }
}

使用 WebdriverIO 时，测试用例如下：

const assert = require('assert')
const { Collect } = require('../database')

describe('TesterHome', function () {
    it('验证埋点', function () {
        const expectDt = '社区 · TesterHome'
        const expectT = 'pageview'

        browser.pause(3000)

        return Promise.all([
            // 查询数据库，取出数据后断言
            Collect.findOne({ where: { dt: expectDt } }).then(collect => {
                assert.equal(collect.t, expectT)
            })
        ])
    })
})

2019.10.10 更新：在每一个自动化测试用例里建立代理规则

「原创声明：保留所有权利，禁止转载」
10 个赞
如果觉得我的文章对您有用，请随意打赏。您的支持将鼓励我继续创作！
打赏支持
共收到 5 条回复 时间 点赞
KIki #1 · 2018年04月17日

www.google-analytics.com 访问有问题，如何解决？

黑水 #2 · 2018年04月17日 Author
对 KIki 回复

自备梯子吧。
如果只是自己试验，TesterHome App 还有 https://ios.bugly.qq.com 的上报可以用

gary.ge #3 · 2018年09月28日

学习了，用 JS 把一套东西都串起来了！小白表示每部分功能只会一门语言的。。学 JS 要学上一段时间了

黑水 在 在每一个自动化测试用例里建立代理规则 中提及了此贴 10月10日 21:58
SimpsonH #5 · 2020年05月27日

大佬，能详细说说怎么在 UI 自动化项目中去调用 anyproxy，看了您的文章，还是有一些地方不明白

黑水 #6 · 2020年05月28日 Author
对 SimpsonH 回复

github 上头的工程有跑跑看吗

需要 登录 后方可回复, 如果你还没有账号请点击这里 注册。