web虚拟用户脚本常用函数

1）cookie

web_add_cookie

添加新的cookie或修改已经存在的cookies

web_remove_cookie

删除指定的cookies

web_cleanup_cookies

删除所有被vuser保存的cookies

web_reg_add_cookie

如果找到某些特定文字，则添加到cookies中

在录制web虚拟用户脚本时，vugen会检测发送到浏览器的所有cookie，然后将永久cookie的详细信息直接录制成脚本，使用web_add_cookie将永久cookie保存在vuser脚本中。vugen不保存在录制会话期间所使用的会话cookie，而是在录制时缓存会话cookie，然后停止录制时丢弃

2）检查点

文本检查点

图像检查点

全局检查点

web_find

需要在run-time settings中开启图像与文本检查点功能后，才能对前面请求后返回的页面进行检查

web_image_check("web_image_check",

"Src=http://statics.verycd.com/images/v3/emule.png",

LAST);

html-based

web_image_check

html-based

web_reg_find

web_reg_find("Search=Body",

"SaveCount=count1",

"Text=LoadRunner",

LAST);

html-based

url-based

尽量检查英文关键字

不要开启fail if属性

设置savecount属性

web_global_verification

web_global_verification("Text=HTTP/1.1 500",

"Search=ALL",

LAST);

html-based

url-based

默认找到指定文本时脚本将发生错误，导致vuser失败，可以修改fail if属性为找不到失败

3）关联函数

int web_reg_save_param(const char *ParamName,<list of Attributes>,LAST);

该函数只有当vugen录制选项中关联设置部分“在录制期间启用关联”被选中时才会在脚本中被自动录制，录制模式必须是基于url，或基于html但html-based高级设置中的“仅包含明确url的脚本”选项必须选中

int web_save_param_length(const char* param, LAST);

创建一个名为<Param>_Length"的新参数，并将参数param的长度保存到<Param>_Length中，长度值用十六进制表示

4）动作函数

int web_custom_request(const char *RequestName,<list of Attributes>,[EXTRARES,<list of Resource Attributes>,] LAST);

该函数创建一个http客户请求，它支持http协议中的所有请求方法。默认情况下，只有当其他web请求函数不能被解释应用时，loadrunner才会利用该函数创建请求，且该函数通常会和其他函数配合应用，如先利用web_add_header函数添加http请求信息头，然后再利用该函数发送客户请求等。

int web_image(const char *StepName,<list of Attributes>,[EXTRARES,<list of Resource Attributes>,] LAST);

模拟鼠标在指定图片上的点击动作,仅vugen为基于html的录制模式时有效，必须在前置动作的上下文才可以执行

int web_link(const char *StepName,<list of Attributes>,[EXTRARES,<list of Resource Attributes>,] LAST);

模拟用户点击链接的行为，仅vugen为基于html的录制模式时有效，必须在前置动作的上下文才可以执行

int web_submit_data(const char *StepName,<list of Attributes>,ITEMDATA,<list of data>,[EXTRARES,<list of Resource Attributes>,] LAST);

处理无状态或上下文无关的表单提交，生成表单的get或post请求，这些请求与form自动生成的请求时一样的

只有选择 recording options>Advanced下的“a script containing explicit ULRS only”选项后，vugen才会使用该函数进行录制

int web_submit_form(const char *StepName,<list of Attributes>,<list of Hidden Fields>,ITEMDATA,<list of data>,[EXTRARES,<list of Resource Attributes>,] LAST);

该函数用来提交表单，此函数必须在前一个操作的上下文中执行。基于html的录制模式。

int web_url(const char *Name, const char *url,<list of Attributes>,[EXTRARES,<list of Resource Attributes>,]LAST);

根据url属性加载对应的url，该函数不需要上下文。仅当选择 recording options>Advanced下的“a script containing explicit ULRS only”选项后，vugen才会使用该函数进行录制。可以模拟从ftp服务器上下载文件，它会使ftp服务器执行文件被真实下载时的操作

5）授权函数

int web_set_user(const char *username, const char *password, const char *host:port);

指定web认证服务器的登录用户和密码

int web_set_certificate(const char *CertificateNumber);

int web_set_certificate_ex(const char *option_list, LAST);

指定证书的密钥文件的位置和格式信息

6）其他函数

int web_get_int_property(const int HttpInfoType);

HTTP_INFO_RETURN_CODE返回上一次http响应信息中的状态码

HTTP_INFO_DOWNLOAD_SIZE返回以字节为单位的最后下载信息的大小

HTTP_INFO_DOWNLOAD_TIME返回以毫秒为单位的最后下载信息的时间

int web_concurrent_start([ConcurrentGroupName，]NULL);

标记一个并发组的开始，所有在该组内的函数都将同时被执行，包括在web_concurrent_start中的函数并不会立即执行，只是先被注册为并发函数，只有当并发组被关闭，即遇到web_concurrent_end时才会被同时执行

int web_concurrent_end(reserved);

7）常见问题

迭代次数大于1时，发生错误

8）http协议相关函数

HTTP协议

HEAD设置

Web_add_header

Web_clean_header

点击链接

Web_link(点击文字链接）

Web_image（点击图片链接）

提交表单

web_submit_data

web_submit_form

Web系统设置

cache设置

web_cache_leanup

web_load_cache

cookie设置

web_add_cookie

web_cleanup_cookies

Proxy设置

web_set_proxy

web_set_secure_proxy

LoadRunner框架支持

检查点

web_find

web_image_check

关联

web_create_html_param

web_create_html_param_ex

web_reg_save_param

web_set_max_html_param_len

控制

lr_start_transaction

lr_end_transaction

lr_rendezvous

lr_thinktime