Kantu——内置命令介绍（一）

内置命令介绍

• open：打开一个页面，Target填写的是需要打开的网页的链接

    {
      "Command": "open",
      "Target": 
      "Value": ""
    }

• click：点击某个元素，Target填写的是需要点击的元素的Xpath或者selector

    // Xpath，直接将Xpath填写进去就可以
    {
      "Command": "click",
      "Target": "//*[@id='ProfileHeader']/div/div[2]/div/div[2]/div[3]/button",
      "Value": ""
    }
    // selector，前面要加css=，后面直接填写对应的selector
    {
      "Command": "click",
      "Target": "css=#root > div > div > div > div.ant-col-12._1zpgA > h1",
      "Value": ""
    }

• clickAndWait：点击某个元素并且等待，一般是打开新的链接的时候用到，会等待新的链接的页面load完，再继续执行后面的命令。Target填写的是想要点击的元素对应的Xpath或者selector。

 {
      "Command": "clickAndWait",
      "Target": "/html/body/a",
      "Value": ""
    }

• store：赋值给变量，Target填写的是需要赋值给变量的值，Value填写的是变量名。
  下面的意思是让index=0

    {
      "Command": "store",
      "Target": "0",
      "Value": "index"
    }

• echo：将值输出到Logs中，用于打印出对应的值，方便调试代码，Target填写的是需要打印出来的内容（可以是值，也可以是变量）

    {
      "Command": "echo",
      "Target": "执行到这里证明已经成功了",
      "Value": ""
    }

• pause：暂停相应的时间，再执行下一条命令，Target填写的是暂停的时间（单位是毫秒）

    {
      "Command": "pause",
      "Target": "1000",
      "Value": ""
    }

• type：向input填写内容，Target填写的是填写位置的Xpath或者selector，Value填写的是需要填写的值。
  下面表示在target中指定的位置中填写‘测试’该词。

    {
      "Command": "type",
      "Target": "//*[@id=‘lst-ib‘]",
      "Value": "测试"
    }

• storeText：获取页面上的文字并同时赋值给一个变量，Target中填写的是需要获取内容的元素的Xpath或者selector，Value填写的是需要赋值的变量名称。
  下面的意思是指，获取Target对应的元素的值，并赋值给变量btnName

    {
      "Command": "storeText",
      "Target": "/html/body/div[1]/div/div/ul/li[4]/a",
      "Value": "btnName"
    }

• select：用于选择下拉框里面的选项，Target是想要选择的下拉框元素对应的Xpath或者selector，Value填写的是想要选择的选项，格式是：‘label=‘ + 选项。
  下拉框如下图所示，下面命令的意思是，自动选择下拉框的Saab选项
  image.png

    {
      "Command": "select",
      "Target": "//*[@id='editor']/select",
      "Value": "label=Saab"
    }

注意：这个命令只对下图的这种结构的下拉框才起作用（有select标签和option标签），对由div写的下拉框不起作用。 image.png

• selectAndWait：用法跟select一样。
  区别在于：如果您的页面正在重新加载，当您从下拉列表中选择标签时，您需要使用“selectAndWait”命令。它将选择指定的标签，然后等待页面成功加载。

    {
      "Command": "selectAndWait",
      "Target": "//*[@id='wrapper']/select",
      "Value": "label=Saab"
    }

注意的是：如果你的页面已经加载完了，再用"selectAndWait"的话，会报错。所以要确定页面还没加载完，才能用这个它。

• selectFrame：当你的页面包含iframe，而你又想对iframe中的元素执行一些操作。这个时候就可以用selectFrame命令选择对应的iframe，然后再对里面的元素进行操作。

// 它的参数有
1.relative=top：回到顶部框架(=外部所有帧)
2.index=0,1,2,3,...：进入第n帧。（从零开始）
3.也可为目标列提供iframe元素的名称或id属性

// 具体例子
// 1 的例子，选中顶部框架（最外面那层，第0层）
    {
      "Command": "selectFrame",
      "Target": "relative=top",
      "Value": ""
    }
// 2 的例子，选中第一层的iframe
    {
      "Command": "selectFrame",
      "Target": "index=1",
      "Value": ""
    }
// 3 的例子，选中名称为test的iframe
    {
      "Command": "selectFrame",
      "Target": "name=test",
      "Value": ""
    }

注意：这个命令也适用于其他的框架。

• selectWindow：该插件只针对当前的浏览器tab有效，如果想要操作浏览器不同tab的内容，就要先切换到对应的浏览器tab，然后再进行操作。
  而这命令就是用于浏览器选项卡之间切换。

// 它的参数写法
1.tab=x：x是指选项卡的编号(例如:0、1、2、…)，选项卡=0是主窗口， Tab=1，右边第一个选项卡，Tab=2，指右边第二个，以此类推~
2.tab=closeallother：关闭所有打开的标签，除了当前的标签。
3.tab=open：打开一个新的选项卡，并加载带有给定URL的网站。
4.title=y：y是指选项卡的标题。

// 具体例子
// 1 的例子，切换到浏览器
    {
      "Command": "selectWindow",
      "Target": "tab=1",
      "Value": ""
    }
// 2 的例子，关闭除了当前的tab的其他tab
    {
      "Command": "selectWindow",
      "Target": "tab=closeallother",
      "Value": ""
    }
// 3  的网页
    {
      "Command": "selectWindow",
      "Target": "tab=open",
      "Value": 
    }
// 4 的例子，选中第一层的iframe
    {
      "Command": "selectFrame",
      "Target": "index=1",
      "Value": ""
    }

注意：该命令比较过时，“selectTab”将更合适。我们继续使用旧的术语是为了向后兼容。

• storeAttribute：该命令用于将指定元素的属性值存储到给定的变量中。
  Target填写的是内容由三个部分组成，想要获取的某个属性所在的元素的Xpath或者selector + 符号@ + 想要获取的属性名。
  下面的意思是将指定元素获取到的href的值存储到给变量test

// Xpath
    {
      "Command": "storeAttribute",
      "Target": "/html/body/article/div/a@href",
      "Value": "test"
    }
// selector，前面要加css=，后面直接填写对应的selector
 {
      "Command": "storeAttribute",
      "Target": "css=body > article > div > a@href",
      "Value": "test"
    }

• storeChecked：该命令将识别复选框或单选按钮的状态，并将值“true”或“false”存储在一个变量中。如果选中元素，它将在变量中存储“true”，如果未选中或未选中元素，将存储“false”。稍后你可以使用该值，例如if或gotoIf命令。
  下面例子的意思是，获取Target对应的元素的状态，并赋值给testCheck

// Target填写的是想要识别的复选框或单选按钮的状态的元素的Xpath或者selector
    {
      "Command": "storeChecked",
      "Target": "/html/body/form/label[2]/input",
      "Value": "testCheck"
    }

• storeTitle：用于获取当前网页的title，并且赋值给一个变量。Value填的是想要赋值的变量的名称。

// 将当前网页的title赋值给变量testTitle
    {
      "Command": "storeTitle",
      "Target": "",
      "Value": "testTitle"
    }

• storeValue：用于将一个元素的值存储到一个变量中以供将来使用。
  下面的意思是：将Target对应的输入框元素里面的值，赋值给变量inputValue

// Target中填写的是需要获取内容的元素的Xpath或者selector，Value填写的是需要赋值的变量。
    {
      "Command": "storeValue",
      "Target": "/html/body/div/input",
      "Value": "inputValue"
    }

注意，该命令只能从输入框、选择框、复选框、radiobutton或textareas中抓取信息。其他的文本抓取，用使用storeText命令。

• verifyChecked：Target中填写的是需要获取内容的元素的Xpath或者selector，该命令用来判断目标复选框或单选按钮是否被选中，如果选中，则无异常反应，如果没有被选中，则会在logs中输出错误。如下图所示：
  image.png

用法：你可以使用内置宏!LastCommandOK来查看判断结果，结合使用if或gotoIf就可以在一定的条件下，执行对应的命令。

// 下面命令意思是：判断Target对应的checkbox或者radio是否选中，并把判断结果echo到logs中
//（如果选中为true，没有选中为false）如果Target中的元素没有被选中，echo命令依然会继续执行
    {    
      "Command": "verifyChecked",
      "Target": "/html/body/form/label[2]/input",
      "Value": ""
    },
    {
      "Command": "echo",
      "Target": "${!LastCommandOK}",
      "Value": ""
    }

• assertChecked：用法跟verifyChecked一致，用来判断目标复选框或单选按钮是否被选中。Target中填写的是需要获取内容的元素的Xpath或者selector。
  用法：你可以使用内置宏!LastCommandOK来查看判断结果，结合使用if或gotoIf就可以在一定的条件下，执行对应的命令。

// 下面命令意思是：判断Target对应的checkbox或者radio是否选中
// 如果Target中的元素没有被选中，则echo命令不会继续执行
    {    
      "Command": "assertChecked",
      "Target": "/html/body/form/label[2]/input",
      "Value": ""
    },
    {
      "Command": "echo",
      "Target": "${!LastCommandOK}",
      "Value": ""
    }

注意：verifyChecked和assertChecked的区别在于，verifyChecked没有选中会在logs显示错误信息，并且执行接下来的命令，可是assertChecked没有选中，则被视为错误，且不会执行后面的命令。

在logs中显示错误如下图所示：

• verifyElementPresent：检查页面上是否存在元素，如果没有，则记录错误，并在logs中奖错误打印出来。
  用法：你可以使用内置宏!LastCommandOK来查看判断结果，结合使用if或gotoIf就可以在一定的条件下，执行对应的命令。

// Target中填写的是对应元素的Xpath或者selector。
// （如果存在为true，不存在为false）如果Target中的元素不存在，echo命令依然会继续执行
    {
      "Command": "verifyElementPresent",
      "Target": "/html/body/form/label[6]",
      "Value": ""
    },
    {
      "Command": "echo",
      "Target": "${!LastCommandOK}",
      "Value": ""
    }

• assertElementPresent：跟verifyElementPresent的用法一致，区别在于，verifyElementPresent元素不存在，会在logs里出现错误信息，而且后面的echo命令还会继续执行，可是assertElementPresent则不会有错误信息，后面的命令也不会继续执行。

注意：可是实际运用时，当插件找不到对应的元素，插件会停在这个命令，一直找，直到到了插件设置了的每条命令的最大时长，会在logs里报超时的错误。

verifyElementPresent：没有找到对应的元素的logs如下：

assertElementPresent：没有找到对应元素的logs如下：

• verifyText：判断Target填写的对应元素的文字是否跟Value填写的一致。
  image.png

// Target中填写的是对应元素的Xpath或者selector。
    {
      "Command": "verifyText",
      "Target": "//*[@id='s_menus_wrapper']/span[2]",
      "Value": "导航"
    },
    {
      "Command": "echo",
      "Target": "${!LastCommandOK}",
      "Value": ""
    }

• assertText：跟verifyText的用法一致，区别在于，verifyText在没有找到对应的文本时，后面的echo命令还会继续执行，可是assertText在没有找到对应的文本时，后面的命令也不会继续执行。
  verifyText：没有找到对应文本时logs如下，可以看到后面的echo命令还会继续执行
  image.png

assertText：没有找到对应文本时logs如下，后面的echo命令不会继续执行

• verifyTitle：获取网站的标题并检查标题是否跟所提供的文本一致。

// Target中填写的是网页标题要匹配的文本
    {
      "Command": "verifyTitle",
      "Target": "百度一下，你就知道",
      "Value": ""
    },
    {
      "Command": "echo",
      "Target": "${!LastCommandOK}",
      "Value": ""
    }

• assertTitle：用法跟verifyTitle一致，也是获取网站的标题并检查标题是否跟所提供的文本一致。区别在于，verifyTitle匹配失败，后面的命令会继续执行，而assertTitle匹配失败，后面的命令不会继续执行。
• verifyValue：该命令得到Target对应的元素的属性值，并检查它是否等于Value填写的值。这适用于任何具有值属性的元素。
  image.png

// Target中填写的是对应元素的Xpath或者selector。
    {
      "Command": "verifyValue",
      "Target": "//*[@id='su']",
      "Value": "百度一下"
    },
    {
      "Command": "echo",
      "Target": "${!LastCommandOK}",
      "Value": ""
    }

• assertValue：用法和上面的verifyValue一致，都是用来获取Target填写的元素的值，并且判断是否等于Value填写的值。
  区别在于：verifyValue匹配失败后，后面的echo命令依然会执行，而assertValue匹配时候后，后面的echo命令就不会再执行了。

注意：verifyText和verifyValue的区别：

verifyText获取的是html文本值：

而verifyValue获取的是元素的属性值：