脚本开发-web_custom_request函数详细介绍
by:授客 QQ：1033553122
c语言版本：
int web_custom_request(const char *RequestName, ,
[EXTRARES, ,] LAST );
参数说明：
RequestName step名称，即请求名。
List of Attributes 属性列表
注意：属性名称大小写敏感
EXTRARES 界定参数，表名接下来的参数将是个资源属性列表
LAST 表名列表结束的标记
List of Attributes
URL - 统一资源定位器，通常为请求链接地址
Method - 请求方法：POST、GET
TargetFrame - 包含当前链接或资源的frame的名称
EncType - 提交请求使用的编码类型(type of encoding)。EncType指定“Content-Type”请求头的值，比如“text/html”。web_custom_request不处理未编码的请求体。Body参数指定的请求体会使用指定的编码。因此，如果指定的Enctype如果不匹配请求体，可能会引发服务端错误。通常情况下，按照录制所得，不对Enctype进行编辑。
如果指定了“EncType”，那么它将会覆盖web_add_[auto_]header函数指定的Content-Type。如果“EncType=” （空值），不会生成“Content-Type” 请求头；如果省略了“EncType”时，那么使用web_add_[auto_]header函数指定的。如果既没有指定EncType也没使用web_add_[auto_]header函数设定请求头，且“Method=POST”，那么，将使用“application/x-www-form-urlencoded”做为默认值。其他情况下，不会生成Content-Type请求头。
RecContentType - 指定了Content–Type 响应头的类型，比如text/html,application/x-javascript。当没有设置Resource属性时，用它来确定目标URL是否是可录制的资源。
Refer - 指定引用的页面
Body - 请求体
Raw Body - 请求体被当作指向数据的指针来传递
BodyFilePath - 需要作为请求体传递的文件路径，不能和Body一起使用，或者任何Body、Raw Body Attribute的属性: BodyBinary, BodyUnicode, RAW_BODY_START 或 Binary=1
Resource - 一个表明URL是否资源的值
Resouce=1，表明URL为一个资源，意味着当前操作与所在脚本的成功与否关系不大。在下载资源时如果发生错误，将当作警告而不是错误来处理的
是否下载URL受“Run-Time Setting—Browser Emulation--Download non-HTML resources” 这个选项的影响。勾选该选项，则不按HTML的形式解析响应信息。
“Resource=0”，表明此URL是重要的，不受发送请求（RTS）的影响，在需要时也会解析它。
ResourceByteLimit - 下载web页面资源的极限大小。当达到设置的极限后，不再下载资源，仅仅对需要下载的资源起作用。
Snapshot - 快照的文件名（.inf为后缀
Mode - 录制级别：HTML、HTTP
HTML级别：在当前Web界面上直观的录制HTML操作。这些操作被录制为web_url、web_link、web_image、web_submit_form等step。VuGen仅仅录制返回HTML页面的请求，不处理脚本和应用程序。
HTTP级别：VuGen把所有的请求录制为web_url step，不生成web_link、web_image、web_submit_form这些函数。这种方法更为灵活，但是生成的脚本不够直观。
ContentEncoding - 请求使用指定的方法（gzip或者deflate）对请求体进行编码，相应的“Content-Encoding:” HTTP头会随此请求一起发送。仅适用于web_custom_request和web_submit_data。
List of Resource Attributes
list of Attributes由非HTML机制的web页面生成,包含Javascript,Activex,Java applets和Flash请求的资源。VuGen Recording Options中可设置，把这些元素录制在当前脚本step中或者单独的step(查看Recording in HTML–Based Mode)
当录制在当前脚本的step中时，额外的资源被当作参数列出，支持以下资源属性：
URL 需要加载的web资源
Referer URL引用的web页面
ENDITEM 表示list中，每个资源结束的标记
相比录制每个资源为一个单一的step，按这种模式录制non-HTML元素可以精简脚本，增加可读性。
当遇到一个附加的资源时，例如，一个Javascript，VuGen录制器添加资源到附加资源列表(Resource Attributes参数列表)。当回放脚本时，会请求该资源。如果资源规律性变化，可使用关联函数参数化该资源。
例子：
web_reg_save_param("extrares_11",
"LB/IC=
"RB=\"",
"Ord=11",
LAST );
web_url("web_url",
"URL=http://lazarus/html/links.html",
"TargetFrame=",
"Resource=0",
"Referer=",
"Mode=HTTP",
EXTRARES,
"URL={extrares_11}", ENDITEM,
LAST );
函数使用范围:
支持所有Web脚本，和以HTTP协议或者无线会话协议(WSP，Wireless Session Protocol)运行的WAP脚本