The
Cookie type is used to handle the cookies transmitted in the HTTP requests. The characteristics of the cookies can be defined and modified by several WLanguage properties.
Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see
Declaring a variable.
// Read the cookies of previous session again
MyCookies is array of Cookie
Deserialize(MyCookies, fLoadText("MyCookies.xml"), psdXML)
// Enable the management of cookies
HTTPCookieManage(True)
HTTPCookieReplace(".yahoo.com", MyCookies)
// Request (the cookies will be sent to the Web server)
HTTPRequest("www.yahoo.com")
Remarks
Properties specific to Cookie variables
The following properties can be used to handle a Cookie:
| | |
Property name | Type used | Effect |
---|
Comment | Character string | Free comment value associated with the cookie. This property does not affect the HTTP requests. |
Domain | Character string | Validity domain of cookie. The cookie will be sent into all HTTP requests whose domain ends with the validity domain of cookie. For example, a cookie whose validity domain is ".mydomain.fr" will be sent during the following requests: - http://mydomain.fr
- http://www.mydomain.fr/index.html
- http://server.mydomain.fr/page.awp
It will not be sent in the following requests:- http://www.mydomain.com
- http://otherdomain.fr
|
Expiration | Character string or DateTime variable | Expiration date and time of cookie. In most cases, this property is set by the Web server to avoid retrieving information that is too old in an HTTP request. |
Name | Character string | Name of cookie. This name is not case sensitive. |
Path | Character string | Validity path of cookie. Indicates to the server the URLs on which the cookie must be interpreted. |
Value | Character string | Value of cookie. Remarks: - The value of a cookie is limited to 4KB. Beyond this size, the server is free to reject the cookie.
- The control characters (TAB, CR, etc.) as well as the semicolon and the binary zeros are not allowed.
|
Functions that use Cookie variables