naotang的测试成长空间，记录工作中的问题，学习中的心得。个人网站：www.naotang.com

『原创』Loadrunner关于页面检查的几个函数详解

上一篇 / 下一篇 2008-09-24 10:05:21 / 个人分类：测试工具

q-dyG,V1Z ]0环境：
-s%M|.TH)a1X0Loadrunner版本：8.051Testing软件测试网s,S5rI.Q-J;U
自建一个test.html文件：
B4RLJ6kT0<html>
<head>
gyquM SU8Ur7v W0<meta name="google1" content="google2"/>
<title>google3</title></head>
<body>
{_%~ cW^0google4:<input type="text" name="google5" />
9w1DE%qf{0<input type="submit" value="google6"/><br>
U2_ w]A,OY(F C0<a href="http://www.google.com/calendar/render?hl=zh-CN&tab=wc" class=gb2>google7</a><br>51Testing软件测试网 I2df @1U#Z
<img src=http://www.google.cn/intl/zh-CN/images/logo_cn.gif width=200 height=88 border=0 alt="google8" title="Google9">
<img src=http://www.google.cn/intl/zh-CN/images/logo_cn.gif width=200 height=88 border=0 alt="google8" title="Google9">51Testing软件测试网*rQ9B;XB"y
</body>
6vd1]#d_K^e0</html>
U6y;^Y/FD^F+`0
[ VoKd"ge)]'`0一、web_image_check

bJ*l vbj0语法：
int web_image_check(const char*CheckName,<List of Attributes>,<"Alt=alt"|| "Src=src">, LAST );

}5|P!GU d0参数：51Testing软件测试网sLZu{ @

W9og.O'S;I01、CheckName：Check名称。
!l#YcC%y!NgX2K02、List of Attributes：
支持的属性有：Frame（在多Frame的情况下，定义要查找Frame的范围）。
7xd^)o4B4}*~sD0支持的选项有：51Testing软件测试网#M3Gy"sb0^&~9N
Expect：检查通过的条件，默认为Found
p)AK~WR$?%s$B0Matchcase：是否区分大小写，默认为no
Repeat：找到第一个符合条件字符串后，是否还继续搜索，默认为yes
Report：什么情况下（success、failure、always）显示检查结果，默认always
Onfailure：失败（expect的值决定）的情况下，是否继续，默认为Continue on Error。
L1AJBx:~@Y Y1v4JO03、Alt：图片的ALT标记。51Testing软件测试网4iT^ IkKs
4、Src：图片的SRC标记。51Testing软件测试网{)JMiq%M;w

说明：51Testing软件测试网3K8m0b"r A*S

D7~;FXW9N&{5@$S01、注意勾上Runtime Settings—Internet Protocl—Preferences—Checks：Enable Image and text check
ir8c1W1NyA02、注意该函数放到web_url后面，且Web_url的Mode须为html(此函数仅仅支持基于HTML的脚本)
3、Web_image_check检查指定的图象是否在HTML页面中出现。
4、Alt或者Src两者必须有一个在参数列表中出现。如果两项都通过，那么检查成功。

Dmt s B4z9[Zj0示例：51Testing软件测试网 F N"^pBQ&IV
Loadrunner脚本：
/J[ K7W#\[pg2K1o051Testing软件测试网 w7[\*o]F
……
JIIV2k l%L0@0 web_url("google",
h~3yn;V2r0  "URL=http://127.0.0.1:8000/test.html",
qO+x7`{0  "TargetFrame=",
I?Q.L8vb Rg#Q,L0  "Resource=0",51Testing软件测试网a~4tcg]6q9U
  "RecContentType=text/html",
L:~E@"E9_ Cj,V h0  "Referer=",
2Y@*^ Q;e0U_"Pq)kw;L0  "Snapshot=t1.inf",
b;s"BnXHE'wZ0  "Mode=HTML",
4g8g)Z*n8i0  LAST);

web_image_check("web_image_check",
Hd T4|^)qf?3Y0  "expect=NotFound",51Testing软件测试网|E#Q5HI+G s
  "Alt=Google8",
uLZ$Un4}'j)H{ I0  "matchcase=no",
8`&\-?N+n,VI4ev0  "repeat=no",
  "report=failure",
.u/V@3T;CxB.V%y0  "Onfailure=abort",
  LAST);

web_find("web_find",
E+s&lx5Q%U-RA+B0 "What=Google",51Testing软件测试网2h/Tu9@I5i
LAST);
……51Testing软件测试网MD+cr R!o'wR

l%[(|#r Vw_ }T(Hx0运行结果：51Testing软件测试网x(~9N8]uc\K

8wqsWE+O^0Starting action Action.
Action.c(15): Found resource "http://www.google.cn/intl/zh-CN/images/logo_cn.gif" in HTML "http://127.0.0.1:8000/test.html" [MsgId: MMSG-26659]
&Vc[$uo_"X?0Action.c(15): web_url("google") was successful, 11968 body bytes, 521 header bytes [MsgId: MMSG-26386]51Testing软件测试网?'C&ELP1D
Action.c(35): Fatal Error -27191: "web_image_check" failed (1 occurrence(s) found. Alt="Google8", Src="") [MsgId: MERR-27191]
7g9H&X `T$R!o0Action.c(35): web_image_check highest severity level was "FATAL ERROR" [MsgId: MMSG-26391]
#l&A$|^ `*Rm ?&@0Abort was called from an action.51Testing软件测试网PO"N-eC)\
Ending Vuser...

#VK9i[5Zx#\0解释：
)Q n6G;W S xpr!b]N0
1、 expect=NotFound，由于找到了符合要求的结果，所以为失败
m.g4SY,K0w m02、 repeat=no，实际上有两个符合条件的结果，不过不继续，所以1 occurrence(s) found51Testing软件测试网,h5Hf*]"_YwX
3、 Onfailure=abort，该检查结果为fail，所以abort，后面的文件检查未执行。

二、web_find51Testing软件测试网#`,v[-cKN5b

vr;MR9c)tLUA%n0语法：51Testing软件测试网+z1jm,J(^8i
　int web_find (const char*StepName, <Attributes and Specifications list>,char*searchstring, LAST );

参数：
Gyh'^8c?ny0
`"qh"S7{v)gyP01、StepName：Check名称
2、Attributes and Specifications list：
B r%V+~?kT G0支持的属性有：
w$ri/`1I(l%Y0Expect：定义在什么情况下函数检查成功：找到了指定的搜索标准或者没有找到。例如说，可以检查指定的错误信息是否出现在web页面中。合法的值有2个：found和notfound。默认值是“found”。51Testing软件测试网nG,@ SH*I#e

j3r1J~F0` R A _)E0Matchcase：指定搜索是否区分大小写，默认为no。

Repeat：指定当第一次发现要查找的字符串时，搜索是否继续。当一个web页面中包含多个被查找的字符串时，此参数是非常有用的。合法的值有2个：yes，no。默认值是“yes”。51Testing软件测试网~Y5i q^f4y,P

~3Wj'S)kf t0Report：指定在什么情况下，VuGen在执行日志中显示此函数的检查结果。合法的值有：success，failure，always。默认值是“always”。

Onfailure：此参数决定在函数检查失败后，Vuser是否中断。参数值是abort。如果指定了Onfailure=abort,当函数检查失败时，不论在运行时设置中的error-handling（Runtime Settings—Miscellaneous）是什么，脚本都会中断。如果没有指定Onfailure=abort,那么运行时设置中error-handling将会起作用。

q E(A"@MR$d0支持的特性有：RightOf, LeftOf （不支持7.x及更高版本）。51Testing软件测试网 v:Gk0M,X1eE

!F$m9jIR#^0RightOf：要查找的字符串右边的内容。

LeftOf：要查找的字符串左边的内容。51Testing软件测试网XIjsK&z$i`

@Y2IH| z!cu03、Searchstring：需要查找的字符串，格式为“What=stringxyz”。此搜索不区分大小写。

(N_*XC0j-?#Y04、LAST：属性列表结束符。

说明:51Testing软件测试网^o\&f De

#V7on+K i3f"nD01、注意勾上Runtime Settings—Internet Protocl—Preferences—Checks：Enable Image and text check51Testing软件测试网D,mBl$Iy
2、注意该函数放到web_url后面，且Web_url的Mode须为html
*j"`Bx r'\s$u03、此函数的作用是在HTML页面中查找指定的字符串。
i.aV#tX,x_Z|a04、函数只能在基于HTML录制的脚本中使用。当指定的HTML请求全部完成以后，开始执行搜索过程，比web_reg_find要慢。
1U+n&k1a8FV5`v%v05、web_find函数在C语言的脚本中已经被web_reg_find所替代，web_reg_find运行速度比较快，而且在HTML-based和URL-based的录制方式中都可以使用。
2M?I o8{)u5[06、在C语言脚本中，web_find是向后兼容的。Java和Visual Basic脚本中不支持它。
K6NP5{8KB6?07、WAP和WSP协议不支持。

示例：
!H'R~`od9m0Loadrunner脚本：
}XInY'`0
)[7JN;N6gH/].f"C0……
\5TA1f&j1?`4P0 web_reg_find("Text/IC=google",
J Xt3eT@|*x0 "Search=Body",
J%g-^-j3{PN_0 LAST);

web_url("google",
v2T9M'K enz+Bug0  "URL=http://127.0.0.1:8000/test.html",
O*U:R\3|w0  "TargetFrame=",
sDs.I5Z0  "Resource=0",51Testing软件测试网@8CC.FTp0yi
  "RecContentType=text/html",
  "Referer=",51Testing软件测试网$Q{'R0P~V3k
  "Snapshot=t1.inf",51Testing软件测试网9j.YYd;s
  "Mode=HTML",51Testing软件测试网1AU e'o"ch
  LAST);

web_find("web_find",51Testing软件测试网"A9c(nb_Ku+x
"What=Google",
Qb!mrky6n*n0 LAST);
……
m3dS'rM*rIml.~0
X$~c A mAD~V-t`-i.W9~0运行结果：

#]Gv$|3B)_t0Starting action Action.51Testing软件测试网gCj&qs\
Action.c(7): Registering web_reg_find was successful [MsgId: MMSG-26390]
Action.c(15): Found resource "http://www.google.cn/intl/zh-CN/images/logo_cn.gif" in HTML "http://127.0.0.1:8000/test.html" [MsgId: MMSG-26659]
)Vca G5AP0Action.c(15): Registered web_reg_find successful for "Text=google" (count=14) [MsgId: MMSG-26364]51Testing软件测试网,dP.Ex\'\
Action.c(15): web_url("google") was successful, 11968 body bytes, 521 header bytes [MsgId: MMSG-26386]51Testing软件测试网M`r8w"n:n3nC
Action.c(44): "web_find" successful. 3 occurrence(s) of "Google" found (RightOf="", LeftOf="") [MsgId: MMSG-27196]
&se\f3^0Action.c(44): web_find was successful [MsgId: MMSG-26392]
PB}#e^0ZI(yY0N0Ending action Action.

解释：

可以看出两个函数最后的检索结果不一样，web_reg_find发现了14个，web_find只发现了3个。这是在web_find里再添加一个属性—"matchcase=yes"，运行结果为：
U3m M8E2j,k4X0Action.c(44): Error -27195: "web_find" failed. 0 occurrence(s) of "Google" found (RightOf="", LeftOf="") [MsgId: MERR-27195]
Ju r-q4JDeBT0Action.c(44): web_find highest severity level was "ERROR" [MsgId: MMSG-26391]51Testing软件测试网m)C-Z |"V
web_find只检索“>”、“<”间的内容。

三、web_reg_find

q#i&xJ0Q'k+O0语法： int web_reg_find (const char*attribute_list, LAST);

参数：51Testing软件测试网D:I:~8E"J(d
51Testing软件测试网HQ5d y$jd
1、attribute_list：
W_,v z-Z_+^0通过Name=Value对来传递参数。例如“Text=string”。Text，TextPfx，TextSfx三个必须有一个出现。其他的属性是可选的。

NL"V%S)s i(n0Text：要搜索的字符串，字符串必须非空，以NULL结尾。可以使用text flags自定义搜索字符串。

G7K!mz5\/`'D `2~h0TextPfx：要搜索的字符串的直接前缀。

TextSfx：要搜索的字符串的直接后缀。

`XZY~.x/F#f'p0Search：搜索的范围。可选的值是：Headers(search only the headers) 、Body（search only the Body data）、Noresource (search only the HTML body, excluding headers and resources)、ALL （search body , headers, and resources），默认值是“BODY”。

$N~5RMoS"juWI0SaveCount：保存到参数中的匹配的字符串的个数。使用这个属性，需要指定“SaveCount=param”。检查操作被执行后，param 的值是null结尾的数字类型的值。

Fail：设置函数检查在什么状态下失败。可以是“Found或“NotFound”。默认是“NotFound”。

7~'I.fb'i+@0ID：日志文件中标识此函数的一个字符串。51Testing软件测试网[~lT&Dh

N$n*\6^P"y7}R.]x$B0RelFrameId：相关联的FrameId。注意：此参数在GUI级别的脚本中不受支持。

Q2P E8\Hg(tk,i o02、LAST：属性列表结束的标记符。51Testing软件测试网 h`,ae.q{/O

说明:

Ec:oe}i(E0p01、web_reg_find属于注册函数，注册一个在web页面中搜索文本字符串的请求，在接下来Action（象web_url）类函数中执行搜索。

N|l@5z02、通过查找期望的字符是否存在来验证是否返回了期望的页面。例如，通过查找“Welcome”来检查主页是否完全打开了。也可以查找“Error”检查浏览器是否发生错误。还可以使用此函数注册一个请求来统计特定字符串出现的次数。

]`5O"GAsw4N0如果检查失败，在接下来的Action类的函数中会报告错误。此函数仅仅注册请求，并不执行。函数的返回值只表明注册是否成功，并不表示检查的结果。

3、此函数不仅能够查找text，还能查找到围绕着text的strings。不要同时指定text和前缀后缀。

4、此函数在HTML-based和URL-based的脚本中都可以使用。此函数是在所请求内容到达之前注册搜索请求的，所以当所请求内容一到达后就会执行搜索，产生的脚本比较高效。
&X4E {r$Cr051Testing软件测试网aS`|,J
示例：
x:~0\ xz*x}Z(d0Loadrunner脚本：51Testing软件测试网7jH6i5G"e$~
51Testing软件测试网M0i3Xhd
……
_DP0h E(I\"F0 web_reg_find ("Text/IC=google",
"Search=Body",51Testing软件测试网|)d$o*B._m+t
LAST);

s5~ WIF_0 web_url("google",51Testing软件测试网 T8{%j`#m
  "URL=http://127.0.0.1:8000/test.html",
  "TargetFrame=",51Testing软件测试网iPR#Kn9R-U
  "Resource=0",
Iv Z+\%X5_E Th&L;Uk0j&\0  "RecContentType=text/html",51Testing软件测试网7k.EMEj&C
  "Referer=",
F3p2n']1gD\KXp0  "Snapshot=t1.inf",
IU'GB K]6uliOZd0  "Mode= HTTP ",
V*x7A?%Pp%r4WX;X0  LAST);

web_url("google",
]7B2n2WR}mY0  "URL=http://www.baidu.com/",
6E&h#\ e'[ g*\M}8I0  "TargetFrame=",
  "Resource=0",
2O&jDIkAT"@0  "RecContentType=text/html",
[B }1``R-HF2I^0  "Referer=",
8yU*{@g0z2y0  "Snapshot=t1.inf",51Testing软件测试网:HYU^h h
  "Mode=HTTP",
  LAST);
*bkCf2fW8o2R#s0……
/VC D+\]6a0
运行结果：

Starting action Action.
^1d;Y2Mq0Action.c(7): Registering web_reg_find was successful [MsgId: MMSG-26390]
6k(Qu&|.H e0Action.c(12): Registered web_reg_find successful for "Text=google" (count=14) [MsgId: MMSG-26364]
Action.c(12): web_url("google") was successful, 538 body bytes, 295 header bytes [MsgId: MMSG-26386]
Action.c(22): web_url("google") was successful, 1714 body bytes, 372 header bytes [MsgId: MMSG-26386]
{#\1wKN7H"V0Ending action Action.

})j;tfU+ZF^0解释：
1@{ ?;m-a1I0
&gF&oxYJM0由上面的结果可以看出，web_reg_find 只在其之后的一个Action类函数中执行搜索。

四、web_global_verification

语法：51Testing软件测试网6fAqt#CI;|
　int web_global_verification(<List of Attributes>, LAST );

8r(]9]*t6qI.h0参数：
List of Attributes：

Text：此属性是一个非空的，以NULL结尾的字符串，表示要查找的内容。语法是”Text=string”。还可以使用text flags自定义字符串。

TextPfx：没有指定Text的情况下使用此属性。要查找的字符串的前缀。语法是” TextPfx =string”。还可以使用text flags自定义字符串。51Testing软件测试网4k,EHP9jm

%b,PY3O/KTGt0TextSfx：没有指定Text的情况下使用此属性。要查找的字符串的后缀。语法是” TextSfx =string”。还可以使用text flags自定义字符串。51Testing软件测试网&DI-j?m`3h

7QCP%c2eZ0Search：可选项，在哪里查找字符串。可选的值是：Headers，Body，NORESOURCE或All。默认值是NORESOURCE。语法是“Search=value”。

oer*IA0Fail：当字符串找不到时的处理选项：Found （默认值）或NotFound。Found表示当找到对应的字符串时发生了错误（例如“Error”）。NotFound表示当找不到字符串时发生了错误。语法是“Fail=value“。

)}].u-Mx+AQmQ0ID：在日志文件中标识当前函数。51Testing软件测试网r9o%csi'_r

0I~rbM2xw0注：text flags：/IC表示忽略大小写；/BIN表示指定的是二进制数据。

FI']/s/E ?|0说明:51Testing软件测试网~.C@"M2]yP
51Testing软件测试网 S0e5l_dis
web_global_verification属于注册函数，注册一个在web页面中搜索文本字符串的请求，与web_reg_find只在下一个Action函数中执行搜索不同的是，它是在之后所有的Action类函数中执行搜索的。可以搜索页面的body，headers，html代码或者是整个页面。

在检测一些应用程序级别（不通过http状态码来表现）的错误时，web_global_verification是非常有用的。如果要定位通过HTTP状态码表现的错误时，使用web_get_int_property。

查找范围：all：这个HTML页面；Headers：页面的头；body：页面的体，包含所有的资源但不包含头；NORESOURCE（默认选项）：仅仅包含页面的体，把包括头和资源。

如果不知道要查找的精确的文本，或者要查找的多个文本不是完全相同的,可以使用前缀和后缀来表示。这时需要用到TextPfx和TextSfx属性。这2个属性必须同时指定，一旦指定了其中一个，就不能指定Text属性了。51Testing软件测试网^(Ds:L8Z I

注意：web_global_verification在WAP协议下不能运行。

示例：
Loadrunner脚本：
51Testing软件测试网T zC|uD0C
……
1KSC'jRN'y8m0 web_global_verification("Text/IC=google",
1m'c$@7J1]"T~0S{0 "Fail=NotFound",51Testing软件测试网1bl(G+A9_
LAST);

web_url("google",
6L8k;Ke4\t.|"J0  "URL=http://127.0.0.1:8000/test.html",
[;JwY5Jz0  "TargetFrame=",
  "Resource=0",51Testing软件测试网v:DB B(L
  "RecContentType=text/html",51Testing软件测试网 }@]z}*NCT
  "Referer=",51Testing软件测试网7UIL$d ~Hs1I
  "Snapshot=t1.inf",
u&B9X*Nr0  "Mode= HTTP ",
+Wcp8D2T seuf'v0  LAST); 51Testing软件测试网%BfSHY5I

web_url("google",
;U8\6nc7lbea0  "URL=http://www.baidu.com/",51Testing软件测试网~%o[F/t7bd|
  "TargetFrame=",
  "Resource=0",
A o;Q#F3Ld5[;N0  "RecContentType=text/html",
[~Cn`*Y0  "Referer=",51Testing软件测试网A@t&Y6H:Q
  "Snapshot=t1.inf",
2L@l}pA0  "Mode=HTTP",
M#t^3_9W W0  LAST);51Testing软件测试网r[_:A{F!C t
……
"L:We&\,R%Q0
!w6Nt%[|0运行结果：

Starting action Action.
{+y Q;@gL#m0Action.c(7): Registering web_global_verification was successful [MsgId: MMSG-26390]51Testing软件测试网9["E.m&z"hju[
Action.c(11): web_url("google") was successful, 538 body bytes, 295 header bytes [MsgId: MMSG-26386]51Testing软件测试网 kc5m'O,b Hn a
Action.c(21): Error -26366: "Text=google" not found for web_global_verification [MsgId: MERR-26366]
6I.}4z)P"z0Action.c(21): web_url("google") highest severity level was "ERROR", 1714 body bytes, 372 header bytes [MsgId: MMSG-26388]
Fre#r0u7z0Ending action Action.51Testing软件测试网 L9w?h5zZ R y

Eq%x7L},n/J7{0解释：
)[:~FH_3D0由上面的结果可以看出，web_global_verification在其之后所有的Action类函数中执行搜索。
\h${~!O.N9x$BlX051Testing软件测试网4aW2c}2_4cf