搭建自己的前端自动化测试脚手架(二)

9

上一篇:搭建自己的前端自动化测试脚手架(一)
By LancerComet at 18:38, 2016.07.17. 欢迎转载,转载时还请保留作者署名。

嗨,欢迎回来!(・∀・)

在这一章我们将安装之前提到的 SeleniumNightwatch 然后并正确配置它俩,让它俩能正常的运 ♂ 作起来,赶紧搞 ♂ 起!

不过首先 ……

  • 首先要安装 Java 7 或更高 ,并且 java 命令可正常执行才能测试噢~~ 最简单的判断方法就是打开自己的终端,输入 java 并回车,看看是不是有 Java 运行。如果有命令不存在之类的提示,请重新安装 Java 运行环境 (・∀・)

  • Node.JS , 而且要确保 npm 命令可用,我想应该其实不用提醒的 ~

开始搭建!

1. 创建项目

我们来找个地方新建一个目录,起名为 "my-test-toolkit",然后在目录内使用终端运行 npm init -y 生成项目配置文件 package.json
npm init

2. 安装工具

然后我们将安装 Selenium 与 Nightwatch。

  • 安装 selenium-standalone:

    • npm install selenium-standalone --save-dev

  • 安装 Nightwatch:

    • npm install nightwatch --save-dev

npm install

还记得吗?上一章提到我们将使用 selenium-standalone 而不是直接手动配置 Selenium 喔!

3. 项目配置

So Easy 不是吗!不过接下来的配置可能要花点功夫,但是也不是很麻烦啦,一步步来还是很容易的~

我们先开始配置 Nightwatch,之前提到这是一款 Test Runner 来着,它负责读取我们的测试脚本,为我们提供 API 来操作浏览器,帮我们控制 Selenium。

一. 配置 Nightwatch

  1. 首先,在项目根目录建立文件 "nightwatch.json",这个文件用来存放 Nightwatch 的配置信息。创建完毕之后,在文件内写入以下内容:

    {
         "src_folders": ["tests"],
         "output_folder": "reports",
         "custom_commands_path": "",
         "custom_assertions_path": "",
         "page_objects_path": "",
         "globals_path": "",
    
         "selenium": {
           "start_process": true,
           "server_path": "",
           "log_path": "",
           "host": "127.0.0.1",
           "port": 4444,
           "cli_args": {
             "webdriver.chrome.driver": ""
           }
         },
    
         "test_settings": {
           "default": {
             "launch_url": "http://localhost",
             "selenium_port": 4444,
             "selenium_host": "localhost",
             "silent": true,
             "screenshots": {
               "enabled": false,
               "path": ""
             },
             "desiredCapabilities": {
               "browserName": "firefox",
               "javascriptEnabled": true,
               "acceptSslCerts": true
             }
           },
    
           "chrome" : {
             "desiredCapabilities": {
               "browserName": "chrome",
               "javascriptEnabled": true,
               "acceptSslCerts": true
             }
           }
         }
    }
    

    nightwatch.json 的文件名是 不可以 修改的,因为 Nightwatch 每次启动的时候都是从它读取配置喔!这里的配置项很多,不过先不管它,我们接着创建文件。如果您希望查看 Nightwatch 的详细配置,请点 这里

  2. 接着在项目根目录下创建文件 "nightwatch.conf.js" ,同样此文件名也是不可以修改的,因为 Nightwatch 每次启动也会从它这里读取配置喔~ (´・_・`)
    创建完毕后,打开文件,并写入如下内容:

    const path = require('path')
    
    module.exports = (function (settings) {
          return settings;
    })(require('./nightwatch.json'))
    
    /*
     *  Nightwatch 会从 nightwatch.json 中读取配置。
     *  不过如果存在 nightwatch.conf.js,将会变为首先从后者中读取配置。
     *  nightwatch.conf.js 存在的意义是使用 JavaScript 动态生成配置信息。
     *  如果配置信息是不需要代码修改的,直接使用 nightwatch.json 就可以啦。
     */
  3. 再次在项目根目录建立文件 "startup.js",然后在文件内部写入:

    require('nightwatch/bin/runner.js')

    这个文件就是我们测试的入口文件,以后我们要执行测试就要运行这个文件,命令为 node ./startup。入口文件的名字是可以按照喜好更改的,只要运行它就好啦。不过每次输入 node ./startup 太麻烦了,所以我们将这条命令写入 npm scripts 中 ~~~ 打开 "package.json",在 JSON 对象中建立 "script" 属性,并写入内容:

    {
        ...
        "scripts": {
            "start": "node ./startup.js"
        },
        ...
    }

以后每次运行测试只要在项目根目录中执行 npm start 就好了!(・∀・)
Nightwatch 的配置暂时告一段落(其实马上就会回来………),接下来我们来处理 Selenium.

二. 配置 Selenium

Selenium 是自动化测试环境,它提供了测试服务器、启动浏览器、网页自动操作等功能,同时暴露 API 给 Nightwatch 供我们使用。

我们接下来将要告诉 Nightwatch 我们的 Selenium 安装在哪里,启动浏览器的 Driver 程序在哪里,然后建立 Selenium 的安装脚本与手工启动脚本,以便不时之需 ~~

Driver 是让 Selenium 打开系统上已安装的浏览器的程序。

  • 1. 建立 Selenium 的配置信息。
    在项目根目录下建立文件夹 "build",并在其中创建文件 "selenium-conf.js",并写入如下信息:

    const process = require('process')
    
    module.exports = {
        // Selenium 的版本配置信息。请在下方链接查询最新版本。升级版本只需修改版本号即可。
        // https://selenium-release.storage.googleapis.com/index.html
        selenium: {
            version: '2.53.1',
            baseURL: 'https://selenium-release.storage.googleapis.com'
        },
    
        // Driver 用来启动系统中安装的浏览器,Selenium 默认使用 Firefox,如果不需要使用其他浏览器,则不需要额外安装 Driver。
        // 在此我们安装 Chrome 的 driver 以便使用 Chrome 进行测试。
        driver: {
            chrome: {
                // Chrome 浏览器启动 Driver,请在下方链接查询最新版本。
                // https://chromedriver.storage.googleapis.com/index.html
                version: '2.22',
                arch: process.arch,
                baseURL: 'https://chromedriver.storage.googleapis.com'
            }
        }
    } 

    本配置信息包含 Selenium 本体配置与 Driver 配置。我们将在稍后动态载入这些配置。
    本文件的目的是为了更好管理 Selenium 的版本。

  • 2. 告诉 Nightwatch,我的 Selenium 与 Driver 在哪里。
    再次打开项目根目录下的 "nightwatch.conf.js" 文件,并这样编辑:

    const seleniumConfig = require('./build/selenium-conf')
    const path = require('path')
    
    module.exports = (function (settings) {
    
        // 告诉 Nightwatch 我的 Selenium 在哪里。
        settings.selenium.server_path = `${path.resolve()}/node_modules/selenium-standalone/.selenium/selenium-server/${seleniumConfig.selenium.version}-server.jar`
    
        // 设置 Chrome Driver, 让 Selenium 有打开 Chrome 浏览器的能力。
        settings.selenium.cli_args['webdriver.chrome.driver'] = `${path.resolve()}/node_modules/selenium-standalone/.selenium/chromedriver/${seleniumConfig.driver.chrome.version}-${seleniumConfig.driver.chrome.arch}-chromedriver`
        
        return settings;
    })(require('./nightwatch.json'))

我们新加了两行配置,它们的作用如注释所示。
同样的,如果您希望查看更多的配置项,请点击 这里

  • 3. 建立 Selenium 安装脚本,一键安装 Selenium。
    还记得上一章我们提过 selenium-standalone 只是用来安装和管理 Selenium 的工具么?所以现在是时候用它来安装 Selenium 了。我们将通过调取 selenium-standalone 的内置方法来实现自动安装。在 "build" 文件夹中建立文件 "selenium-setup.js",并写入如下信息:

    const selenium = require('selenium-standalone')
    const seleniumConfig = require('./selenium-conf.js')
    
    selenium.install({
        version: seleniumConfig.selenium.version,
        baseURL: seleniumConfig.selenium.baseURL,
        drivers: seleniumConfig.driver,
        logger: function (message) { console.log(message) },
        progressCb: function (totalLength, progressLength, chunkLength) {}
    }, function (err) {
        if (err) throw new Error(`Selenium 安装错误: ${err}`)
        console.log('Selenium 安装完成.')
    })

    同样为了方便,我们将安装命令写入 npm scripts 中:

    {
        ...
        "scripts": {
            "start": "node ./startup.js",
            "selenium-setup": "node ./build/selenium-setup.js"
        },
        ...
    }

    然后在项目根目录执行 npm run selenium-setup 安装 Selenium.

    当提示安装完成后,一切就绪!(・∀・)

Selenium 与其 Driver 会安装到 "node_modules/selenium-standalone/.selenium" 中。

  • 4. 想要手工启动 Selenium?
    默认情况下,Selenium 是由 Nightwatch 启动的,不需要手工干预,不过如果想要手工启动当然是可以的啦。

    在 build 文件夹中建立文件 "selenium-start.js",并写入如下信息:

    const selenium = require('selenium-standalone')
    const seleniumConfig = require('./selenium-conf.js')
    
    selenium.start({
        drivers: seleniumConfig.driver
    }, function (err, child) {
        if (err) throw new Error(`Selenium 启动失败: ${err}`)
        console.log(`Selenium 已手工启动,进程 PID: ${child.pid}`)
        console.log('当不再需要运行 Selenium 时可关闭此 PID 进程.')
    })

    然后同样添加启动命令至 npm scripts 中:

    {
        ...
        "scripts": {
            "start": "node ./startup.js",
            "selenium-setup": "node ./build/selenium-setup.js",
            "selenium-start": "node ./build/selenium-start.js"
        },
        ...
    }  

    以后使用命令 npm run selenium-start 就可以手工启动 Selenium 了。

搭建完了!

至此,我们的配置与安装工作已经完成,项目结构应该为:

>
| -- build
|      | -- selenium-conf.js        # Selenium 版本信息配置。
|      | -- selenium-setup.js       # Selenium 安装命令脚本。
|      | -- selenium-start.js       # Selenium 启动命令脚本。
|
| -- nightwatch.conf.js             # Nightwatch 动态配置文件。
| -- nightwatch.json                # Nightwatch 配置文件。
| -- package.json                   # 项目信息配置文件。
| -- startup.js                     # 测试启动入口文件。

“不过我好像看到 "nightwatch.json" 的配置很复杂,而我们确没怎么动它?”
嗯~~ 到目前位置确实没有太多需要改动的,不过还是要注意一个配置项:

  • 请注意 "desiredCapabilities" 下的 "browserName" 项,这是测试时将使用的浏览器,您可以修改为 chromeinternet explorerphantomjs,本文在介绍时只安装了 Chrome 的 Driver,如果您需要使用其他浏览器,要安装相应的 Driver 才可以正常使用。

  • 默认浏览器为 Firefox,如果您使用 Firefox 的话,不需要额外进行 Driver 的配置。

  • 所以,如果您需要使用 Chrome 的话请将 "browserName" 修改为 "chrome" 喔!
    使用 Chrome

Driver 的文档可参考这里
如果您在搭建过程中遇到困难,您可以从 Github 获取在下已经搭建好的 Start Kit.

接下来 ……

接下来就是专心写测试用例了,距离成功越来越近了!不过今天就到这里结束,我们下一章见!⁄(⁄ ⁄•⁄ω⁄•⁄ ⁄)⁄

下一篇:搭建自己的前端自动化测试脚手架(三)

你可能感兴趣的

12 条评论
敲键盘的猫 · 2017年02月13日

我准备在Mac下测试一下chrome,同时也希望git上有个中文版文档……

回复

敲键盘的猫 · 2017年02月13日

致后续看到GitHub上面博主代码的读者:
如果像我一样第一次接触,不会用的话,下载之后解压(git clone解压53%卡住),执行npm install,然后修改build路径下的conf文件,里面的版本号替换为最新版本。之后再执行npm run selenium-setup (友情提示可能要接vpn否则安装失败),这时就会将对应的所有库下载到本项目目录中,不需要再另行下载,而且路径也已经配置好,可放心食用。
再次感谢博主的辛勤劳作

奥对了,github主页上的测试用例没跑起来,大家自己建一个,慢慢摸索吧。

回复

0

请教下,在win10上 启动不了浏览器,会有什么原因导致啊

落未志 · 2017年03月06日
0

@落未志 如果安装的是最新版chrome,检查下你的驱动是不是下好了。因为setup那一步可能会卡住。检查一下应该是有个chrome安装路径的配置,要不然selenium识别不到chrome的位置。

敲键盘的猫 · 2017年03月07日
0

再检查一下你配置的conf文件中,是不是win版的驱动,github里默认配置的可能是mac版的驱动的路径,我最近没用,你看下吧。

敲键盘的猫 · 2017年03月07日
敲键盘的猫 · 2017年02月13日

还有,Mac下java要装jdk,安装包220多兆那个,装完了500兆。我脑抽装了个runtime

回复

深蓝 · 2017年04月20日

请教你一个问题,我有这样的场景
有一个链接列表是动态生成的,需要点击其中一个名为测试的链接
我发现 Nightwatch 的 DOM 筛选能力比较弱,改如何操作?

回复

修行的苦行僧 · 2017年12月05日

你好,我在npm run selenium-setup时候,会报错

Error: Selenium 安装错误: Error: Could not download https://selenium-release.storage.googleapis.com/2.53/selenium-server-standalone-2.53.1.jar: Error: connect ETIMEDOUT 172.217.160.112:443
    at /Users/yangyuxue/Desktop/learnFront/lightwatch/test/build/selenium-setup.js:11:20
    at /Users/yangyuxue/Desktop/learnFront/lightwatch/test/node_modules/selenium-standalone/lib/install.js:110:5
    at /Users/yangyuxue/Desktop/learnFront/lightwatch/test/node_modules/async/dist/async.js:3874:9

回复

0

你好,请问你解决了吗,我也遇到这个问题了

静修丶 · 1月17日
0

去其他地方下载,手动安装放到node_moudles里面了。。后来没选这个框架做方案,就没研究了。但是我就是这么蠢蠢的解决的哈哈

修行的苦行僧 · 1月17日
0

这个要翻墙

雷霆先锋 · 1月18日
载入中...