int web_find( const char *StepName, <Attributes and Specifications list>, char *searchstring, LAST );
StepName：步骤名称，必选
Attributes and Specifications list：属性列表，可选
expect：定义返回成功的标准，found（默认）-表示找到字符串返回成功，notfound-表示未找到字符串返回成功
Matchcase：是否区分大小写，yes-表示区分大小写，no（默认）-表示不区分大小写
report：定义结果报告的内容，success-只包含成功，failure-只包含失败，always（默认）-包含所有
onfailure=abort：失败则终止脚本运行
RightOf：从指定字符串的右边开始查找
LeftOf：从指定字符串的左边开始查找
searchstring：查找的字符串，格式为："What=stringxyz"，必选
LAST：结束标记，必选
WebTours登录后页面展示的内容：
Welcome, jojo, to the Web Tours reservation pages.
Using the menu to the left, you can search for new flights to book, or review/edit the flights already booked. Don‘t forget to sign off when you‘re done!
1、web_find之expect属性：
Action()
{
web_url("WebTours",
"URL=http://127.0.0.1:1080/WebTours/",
"Resource=0",
"RecContentType=text/html",
"Referer=",
"Snapshot=t34.inf",
"Mode=HTML",
EXTRARES,
"Url=../favicon.ico", "Referer=", ENDITEM,
LAST);
web_submit_form("login.pl",
"Snapshot=t35.inf",
ITEMDATA,
"Name=username", "Value=jojo", ENDITEM,
"Name=password", "Value=bean", ENDITEM,
"Name=login.x", "Value=52", ENDITEM,
"Name=login.y", "Value=11", ENDITEM,
LAST);
web_find("web_find",
//期望返回成功的结果是找到字符串，因当前页面包含要查找的字符串，故返回结果是成功
"expect=found",
//当前页面中查找字符串"jojo"
"What=jojo",
LAST);
web_find("web_find",
//期望返回成功的结果是未找到字符串，因当前页面包含要查找的字符串，故返回结果是失败
"expect=notfound",
//当前页面中查找字符串"jojo"
"What=jojo",
LAST);
return 0;
}
代码执行结果：
Action.c(24): "web_find" successful. 1 occurrence(s) of "jojo" found (RightOf="", LeftOf="") [MsgId: MMSG-27196]
Action.c(24): web_find was successful [MsgId: MMSG-26392]
Action.c(31): Error -27195: "web_find" failed. 1 occurrence(s) of "jojo" found (RightOf="", LeftOf="") [MsgId: MERR-27195]
Action.c(31): web_find highest severity level was "ERROR" [MsgId: MMSG-26391]
2、web_find之Matchcase属性：
Action()
{
web_url("WebTours",
"URL=http://127.0.0.1:1080/WebTours/",
"Resource=0",
"RecContentType=text/html",
"Referer=",
"Snapshot=t34.inf",
"Mode=HTML",
EXTRARES,
"Url=../favicon.ico", "Referer=", ENDITEM,
LAST);
web_submit_form("login.pl",
"Snapshot=t35.inf",
ITEMDATA,
"Name=username", "Value=jojo", ENDITEM,
"Name=password", "Value=bean", ENDITEM,
"Name=login.x", "Value=52", ENDITEM,
"Name=login.y", "Value=11", ENDITEM,
LAST);
web_find("web_find",
//区分大小写，因当前页面不包含JOJO，故返回结果是失败
"Matchcase=yes",
//当前页面中查找字符串"JOJO"
"What=JOJO",
LAST);
web_find("web_find",
//不区分大小写，因当前页面包含jojo，故返回结果是成功
"Matchcase=no",
//当前页面中查找字符串"JOJO"
"What=JOJO",
LAST);
return 0;
}
代码执行结果：
Action.c(24): Continuing after Error -27195: "web_find" failed. 0 occurrence(s) of "JOJO" found (RightOf="", LeftOf="") [MsgId: MERR-27195]
Action.c(24): web_find highest severity level was "continue on error" [MsgId: MMSG-26391]
Action.c(24): Continuing after error in Vuser script.
Action.c(31): "web_find" successful. 1 occurrence(s) of "JOJO" found (RightOf="", LeftOf="") [MsgId: MMSG-27196]
Action.c(31): web_find was successful [MsgId: MMSG-26392]
3、web_find之onfailure属性：
Action()
{
web_url("WebTours",
"URL=http://127.0.0.1:1080/WebTours/",
"Resource=0",
"RecContentType=text/html",
"Referer=",
"Snapshot=t34.inf",
"Mode=HTML",
EXTRARES,
"Url=../favicon.ico", "Referer=", ENDITEM,
LAST);
web_submit_form("login.pl",
"Snapshot=t35.inf",
ITEMDATA,
"Name=username", "Value=jojo", ENDITEM,
"Name=password", "Value=bean", ENDITEM,
"Name=login.x", "Value=52", ENDITEM,
"Name=login.y", "Value=11", ENDITEM,
LAST);
web_find("web_find",
//如果函数返回结果失败，则终止脚本运行，根据运行结果可以发现，第二个web_find没有运行
//注意：Continue on Error 设置了才能看到效果，否则的话，不管是否有该属性都会终止运行
"onfailure=abort",
//当前页面中查找字符串"JOJO"
"What=jojo1",
LAST);
web_find("web_find",
//当前页面中查找字符串"JOJO"
"What=jojo",
LAST);
return 0;
}
代码运行结果：
Action.c(24): Fatal Error -27195: "web_find" failed. 0 occurrence(s) of "jojo1" found (RightOf="", LeftOf="") [MsgId: MERR-27195]
Action.c(24): web_find highest severity level was "FATAL ERROR" [MsgId: MMSG-26391]
Abort was called from an action.
4、web_find之LeftOf、RightOf属性：
Action()
{
web_url("WebTours",
"URL=http://127.0.0.1:1080/WebTours/",
"Resource=0",
"RecContentType=text/html",
"Referer=",
"Snapshot=t34.inf",
"Mode=HTML",
EXTRARES,
"Url=../favicon.ico", "Referer=", ENDITEM,
LAST);
web_submit_form("login.pl",
"Snapshot=t35.inf",
ITEMDATA,
"Name=username", "Value=jojo", ENDITEM,
"Name=password", "Value=bean", ENDITEM,
"Name=login.x", "Value=52", ENDITEM,
"Name=login.y", "Value=11", ENDITEM,
LAST);
web_find("web_find",
//从, to the Web左边查找jojo
"LeftOf=, to the Web",
//从Welcome右边查找jojo
"RightOf=Welcome, ",
"What=jojo",
LAST);
return 0;
}
代码运行结果：
Action.c(24): "web_find" successful. 1 occurrence(s) of "jojo" found (RightOf="Welcome, ", LeftOf=", to the Web") [MsgId: MMSG-27196]
Action.c(24): web_find was successful [MsgId: MMSG-26392]