Script 1.8.1

Testrun(对象成员函数)

原型:

Testrun(TestrunName, configFileName, jsScriptFilename, configName)

描述:

新建一个 Testrun 对象,并立即将其执行起来。

参数:

TestrunName:用户自定义的 Testrun 名称。
configFileName: tpf配置参数文件名。为相对路径,tpf文件必须与第三个参数指定的js文件在同一个路径下。
jsScriptFilename: 要执行的 js 文件名,为相对路径,会依次在用户自定义的 scriptPath,环境变量 TCSCRIPTPATH 对应的路径,/此电脑/文档/Scripts/下查到该脚本文件,如果都没有,lastError() 会提示错误。
configName: 指定采用 configFileName 对应文件中的哪一个配置。

返回值:

一个 Testrun 对象
异常:可通过 lastError() 函数获取具体的错误信息。

示例:

配置参数文件 'mte.tpf' 和执行的js 文件 'mtesample.js‘存放在/此电脑/文档/Scripts/下。
配置参数文件 'mte.tpf'如下所示:

Testname qqmusic
deviceSN:'7N2SQL154X038444'
appname:'com.tencent.qqmusic'
username:'14016031'
password:'password001'
End

Testname qq
deviceSN:'KVSGFELFE6AY7LYL'
appname:'com.tencent.mobileqq'
username:'45178763'
password:'password002'
End

执行的js 文件 'mtesample.js‘如下所示:

print ("RUN TEST BEGIN ...");
//获取 mte.tpf 文件中的信息,比如deviceSN,appname等
print("Device SN is: " + Testrun.getContext().get('deviceSN'));
print("APP to be started: " + Testrun.getContext().get('appname'));
print("Username is: " + Testrun.getContext().get('username'));
print("Password is: " + Testrun.getContext().get('password'));
//通过给定的设备序列号进行设备对象获取
var device = Device.searchObject(sigmaConst.DevSerial, Testrun.getContext().get('deviceSN'));
//假设获取到设备对象,就在该设备上运行从 mte.tpf 文件中获取的 appname
if(!device) {
	print(lastError());
} else {
	print("Run app");
	device.runApp(Testrun.getContext().get('appname'));
}
print ("RUN TEST END!");

新建一个 Testrun 对象,并立即将 'mtesample.js‘ 执行起来。

//新建一个 Testrun 对象 testrunObj
//Testrun 名称: 'Hello007' 
//tpf配置文件: 'mte.tpf'
//要执行的js文件名: 'mtesample.js'
//'qqmusic' 表示采用的 'mte.tpf'文件中的'qqmusic'配置
try {
    var testrunObj = new Testrun('Hello007', 'mte.tpf', 'mtesample.js', 'qqmusic');
    testrunObj.stop('Hello007');//停止Testrun 'Hello007'
} catch (e) {
    print("Error:" + e);
    print(lastError());
}
运行结果:
//当执行上面的语句后,如果出现错误,则会打印出相应的错误信息。
//如果正确,则会执行 'mtesample.js‘ 脚本,输出如下内容,并启动app ‘com.tencent.qqmusic’
RUN TEST BEGIN ...
Device SN is: 7N2SQL154X038444
APP to be started: com.tencent.qqmusic
Username is: 14016031
Password is: password001
Run app
RUN TEST END!