ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Web-specific functions / Browser functions
  • Limits
  • Miscellaneous
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Writes a cookie onto the computer of the Web user.
WEBDEV - Server code The cookie is written during the next display of a WEBDEV page in the browser.
WEBDEV - Browser code The cookie is written onto the computer of the Web user.
WEBDEV - Server codePHPAjax
// -- Click on a BTN_Validate button (server code)
// Create a cookie: save the username
// and the date of last visit
CookieWrite("NAME_AND_DATE", Name + "," + DateSys())
PageDisplay(PAGE_Purchases)
WEBDEV - Browser codePHP
// -- Click on a BTN_Save button (browser code)
// Create a cookie: save the search options
CookieWrite("SEARCHOPT", Keyword + "," + ByIDENTICAL)
Syntax
CookieWrite(<Cookie name> , <Cookie value> [, <Validity period> [, <Path> [, <Domain> [, <Type of cookie>]]]])
<Cookie name>: Character string
Name of the cookie that must be written onto the computer of the Web user. This name can be used during the call to CookieRead.
Caution: The ";" character cannot be used in the name of the cookie.
<Cookie value>: Character string
Value of the cookie to write onto the computer of the Web user. This value can be a list of data, various information, ... The maximum size of the character string cannot exceed 4000 characters.
Caution: The ";" character and the "Carriage Return" (CR) character cannot be used in the value of the cookie.
<Validity period>: Optional integer
Number of days during which the cookie is valid. Once this number of days is exceeded, the cookie is automatically deleted from the computer of the Web user. The cookie is valid for 30 days by default.
<Path>: Optional character string
Path for which the cookie must be saved. This path must exist on the server. This parameter is case-sensitive.
By default (or if this parameter corresponds to an empty string), the path corresponds to "/".
Example: "/COOKIES_WEB/FR/LOGIN"
<Domain>: Optional character string
Domain for which the cookie must be saved.
  • If this parameter is not specified or if it corresponds to an empty string, the domain corresponds to the current domain. The cookie will be associated with this domain only.
  • If this parameter explicitly corresponds to a domain name, the cookie will be associated with the specified domain name and with all its sub-domains.
<Type of cookie>: Optional Integer constant (or combination of constants)
Type of cookie to write:
cookieHTTPOnlyCookie that can be retrieved in server code only. This cookie cannot be read in browser code.
WEBDEV - Browser code This constant is not available.
cookieNormal
(Default value)
Cookie without specific options.
This constant cannot be combined with the other constants.
cookieSameSiteStrictSameSite cookie. This type of cookie is used to prevent Cross Site Request Forgery (CSRF) attacks.
cookieSecureCookie transmitted in an HTTPS request only.
Remarks

Limits

  • The maximum size of a cookie cannot exceed 4000 characters. Up to 20 cookies can be written per domain.
  • WEBDEV - Server code A single cookie can be written per page.
    Reminder: When the Web user connects to a WEBDEV site, the Web server loads all the cookies associated with the current domain in memory.
    Note: The Internet domain corresponds to a specific section of the Internet address: http://computer.domain.com/MyPages/Index.html.

Miscellaneous

  • Some browsers give you the ability to disable the cookies. In this case, CookieWrite has no effect.
  • If the name or the value of your cookie contains special characters (* for example), accented or UNICODE, the writing of the cookie may have no effect with some browsers.
Component: wd290page.dll
Minimum version required
  • Version 9
Comments
SameSite=None option not available
We may have a site calling another website with SameSite=None with the secure attribute. This option is not currently available. Alternate method is to override the cookie with javascript to set the attibute
REJISH / BEO
17 Oct. 2022

Last update: 05/26/2022

Send a report | Local help