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文件内容一致。