loadrunner Web_类函数之web_reg_add_cookie（）

web_reg_add_cookie（）--常用函数

注册搜索文本字符串，如果找到文本，则添加一个cookie。（带“reg”的函数都是属于注册型函数，一般都是先注册后被后续的协议请求所使用）

int web_reg_add_cookie（constchar * cookie，constchar * searchstring，LAST）;

 

 参数说明：

cookie：定义要添加或修改的cookie。Cookie参数具有以下格式：

<name> = VALUE; （需要）

domain = DOMAIN_NAME; （需要）

expires = DATE;

path = PATH; （默认路径为“/”）

secure

Cookie参数中的元素与Set-Cookie HTTP响应标头中的元素相同。有关详情，请参阅

http://wp.netscape.com/newsref/std/cookie_spec.html

例如，“Session = 1234; domain = sanditon.com”，其中“Session”是名称。

searchstring：要搜索的文本字符串。此属性必须是非空的，以空字符结尾的字符串。使用格式“Text = string”。

LAST指示参数列表结束的标记。

 

一般信息：

web_reg_add_cookie函数注册搜索由searchstring参数指定的文本字符串。如果在由下一个操作函数检索的Web页面上找到searchstring，则会添加指定的cookie。

 

注意，虽然web_reg_add_cookie在功能上类似于HTTP Set_Cookie头部，但是存在显着的差异。根据HTTP标准，域属性在来自服务器的Set-Cookie头中是可选的。如果未指定，则domain的默认值是生成cookie响应的服务器的主机名。由于在调用web_reg_add_cookie时，此信息对于Load Generator主机不可用，因此需要domain属性。

 

此功能可用于基于HTML和基于URL的脚本（请参阅录制选项>录制选项卡）。它在缓冲器到达之前注册搜索请求，因此缓冲器在它们到来时被扫描。这导致更有效的脚本具有更好的性能。

web_reg_add_cookie由用户添加到脚本中。它不被记录。

 

示例：web_reg_add_cookie

在以下示例中，web_reg_add_cookie函数注册对文本字符串“Darcy”的搜索。 如果在下载的下一页中找到该字符串，则会添加该Cookie。

web_reg_add_cookie ("client_id=RosingsPark127B; path=/;expires=Wednesday, 09–Nov–2011 23:12:40 GMT;domain=www.pemberley.com","Text=Darcy");