loadrunner Web_类函数之web_global_verification（）

web_global_verification（）--常用函数

在所有后续请求中搜索文本字符串（全局检查点，对后续的所有请求返回的响应数据搜索文本字符串）。

int web_global_verification（<属性列表>，LAST）;

 

 参数说明：

List of Attributes：

文本：要搜索的文本字符串。此属性必须是非空的，以空字符结尾的字符串。使用格式“Text = string”。您可以使用文本标志进一步自定义搜索。

以下两个属性仅在未指定文本时使用。

TextPfx：要搜索的文本字符串的前缀。使用格式“TextPfx = string”。您可以使用文本标志进一步自定义搜索。

TextSfx：要搜索的文本字符串的后缀。使用格式“TextSfx = string”。您可以使用文本标志进一步自定义搜索。

搜索：在哪里搜索文本。可用的值包括标题，正文，NORESOURCE或全部。默认值为NORESOURCE。此属性是可选的。使用格式“Search = value”。

失败：找不到字符串时的处理选项可用的值为Found（默认值）和NotFound。找到表示当找到文本时发生故障（例如，“错误”）。 NotFound表示在找不到文本时发生故障。使用格式“Fail = value”

ID：用于表示对web_global_verification的特殊调用的标识字符串。例如，它在日志文件和调用web_global_verification_pause中使用。

LAST指示属性列表结束的标记。

 

一般信息 ：

web_global_verification函数注册在所有后续Action函数返回的Web页面中搜索指定的文本字符串的请求。如果任何后续操作函数中发生失败条件，则脚本将失败。这与web_reg_find函数形成对比，web_reg_find函数仅注册下一个Action函数的请求。

要暂停检查，请使用web_global_verification_pause。如果由于对web_global_verification的多次调用而导致多个检查有效，请针对您要暂停的每个检查调用web_global_verification_pause。

web_global_verification函数可用于检测未由HTTP状态代码表示的应用程序级错误。要查找由HTTP状态代码表示的错误，请使用web_get_int_property。

 

您可以搜索正文，标题，HTML代码或页面的整个内容。搜索选项为：

all：整个HTML页面

headers：只有它的头部，而不是body

body：正文，不包括所有标题，但包括所有资源

NORESOURCE：只有html正文，不包括所有标题和资源（默认）

如果您不知道要搜索的确切文本，或者如果文本不一致，则可以使用TextPfx和TextSfx属性来限定文本的开头和结尾。前缀和后缀实际上是文本的边界 - TextSfx是右边界，TextPfx是左边界。使用这些属性时，必须为这两个属性指定非空值，并且不能指定文本属性。

 

当使用TextPfx和TextSfx指定“Fail = Found”（或未指定失败条件），并且多次找到左边界和右边界时，每次匹配都会作为错误发出，直到在“运行”中配置的最大错误数 - 时间设置>首选项>高级选项。后续匹配记录为参考消息。

注意：web_global_verification不适用于WAP脚本。

 

示例：web_global_verification

实施例1

在以下示例中，web_global_verification函数搜索文本字符串“Acme Company”。 如果未找到该字符串，它将失败，并且脚本执行停止。

web_global_verification（“Text/ IC = Acme Company”，

     “Fail =NotFound”，

     “ID =FindAcme”，LAST）;

web_url（“Step”，“URL = ...”，LAST）;

 

带有“FindAcme”ID的日志错误消息为：

错误-27127：找不到web_global_verification（“FindAcme”）的“Text = Acme Company”

 

实施例2

在以下示例中，web_global_verification函数标识函数名称发生变化的以下字符串中的函数名称“函数myfunc：File not found”中的错误。

如果它检测到错误文本，它将失败：（Fail = Found）。

web_global_verification（“TextPfx=功能错误”，“TextSfx =文件未找到”

                                  “Fail = Found”，LAST）;

web_url（“Step”，“URL = ...”，LAST）;