• Util (常用工具函数）

    Util (常用工具函数）

    提供自动化脚本常用的工具函数， 它通过引入“leanpro.common"中的Util对象获得：

    1. const { Util } = require('leanpro.win');

    它的定义如下：

    1. class Util {
    2.     static delay(milliseconds: number): Promise<void>;
    3.     static launchProcess(exePath: string, ...args: string[]): any;
    4.     static stopProcess(proc: ChildProcess): boolean;
    5.     static takeScreenshot(filePath: string = null, monitor: number = 0): string | void;
    6.     static loadCsvFile(filePath: string): Promise<RowCsv[]>;
    7.     static saveToCsvFile(rows: RowCsv[], filePath: string): boolean;
    8. }
    • delay

    指定延时的毫秒数。因为是异步调用，记住前面需要加上await。例如：

    下面的代码打开计算器应用，等待一秒后，确保它初始化成功后，开始点击操作。

    1. async function run() {
    2.     let calcPath = 'c:/windows/system32/calc.exe';
    3.     await Util.launchProcess(calcPath);
    4.     await Util.delay(1000); //wait for process to initialize
    5.     await model.getButton("Two").click();
    6. }
    8. run();

    • launchProcess启动某个进程。一般用来启动被测应用。上述的例子显示了如何用launchProcess启动计算器应用。

    • stopProcess停止某个进程。将launchProcess返回值传递给proc，可关闭该进程。

    1. async function run() {
    2.     let notepadPath = 'c:/windows/notepad.exe';
    3.     let proc = await Util.launchProcess(notepadPath);
    4.     //do some other operations...
    5.     Util.stopProcess(proc);
    6. }
    8. run();

    注意：有些应用是多进程的。界面端窗体是由主进程打开的。这种情况下停止主进程不会关闭应用程序界面。Windows 10中的计算器应用即这种情况。

    • takeScreenshot截取整个屏幕图片，以png格式保存。
      • filePath是文件路径，应以.png后缀结尾。如果提供了文件名，返回值是空。如果filePath为null, 返回为图片的base64编码。
      • monitor是截取屏幕的编号，0是第一个，1是第二个，缺省为0。
    • loadCsvFile读取CSV文件，返回json对象的数组，每个对象的key是列名，value是数据。例如有下面的内容的data.csv文件：
    1. first_name,last_name,company_name,state,zip
    2. James,Butt,"Benton, John B Jr",LA,70116
    3. Josephine,Darakjy,"Chanay, Jeffrey A Esq",MI,48116
    4. Art,Venere,"Chemel, James L Cpa",NJ,8014

    使用如下代码读取：

    1. (async function() {
    2.     let data = await Util.loadCsvFile('C:\\temp\\data.csv');
    3.     console.log(data);
    4. })();

    会返回如下的json:

    1. [
    2. { "first_name": "James",
    3.   "last_name": "Butt",
    4.   "company_name": "Benton, John B Jr",
    5.   "state": "LA",
    6.   "zip": "70116" },
    7. { "first_name": "Josephine",
    8.   "last_name": "Darakjy",
    9.   "company_name": "Chanay, Jeffrey A Esq",
    10.   "state": "MI",
    11.   "zip": "48116" },
    12. { "first_name": "Art",
    13.   "last_name": "Venere",
    14.   "company_name": "Chemel, James L Cpa",
    15.   "state": "NJ",
    16.   "zip": "8014" } 
    17. ]
    • saveToCsvFile

    在得到json格式的数据后，可以再使用saveToCsvFile(rows, filePath)函数将数据保存为csv文件。

    1.     function saveToCsvFile(rows: RowCsv[], filePath: string): boolean;
    • 参数rows为行数据，它的键为列名，值为单元格中的元素；
    • 参数filePath为保存的路径和文件名；

    举个例子，我们需要将从上一步data.csv文件中读取的数据保存为脚本所在根目录的data_bak.csv文件中，代码如下：

    1. (async function() {
    2.     let data = await Util.loadCsvFile('C:\\temp\\data.csv');
    3.     // console.log(data);
    4.     Util.saveToCsvFile(data, "./data_bak.csv");
    5. })();

    运行结束后可以在根目录下看到新生成的data_bak.csv文件，打开可以看到里面的内容和上一步的data.csv文件内容一致。