Javascript Reference
Categories: userProfile

javascript userProfile doReadRequest( )

@March 15, 2008, 1:22 a.m.
doReadRequest( )Firefox/Netscape/NN n/a IE 4(Win) Chrome/Safari/DOM n/a  

doReadRequest(usageCode[, "friendlyName"[, "domain"[, "path"[, "expiration"]]]])

  

Based on the items in the queue, this method inspects the browser to see whether the user has given permission to inspect these attributes in the past. If not (for some or all), the method displays a dialog box (the Profile Assistant window) that lets users turn off the items that should not be exposed to the server. Parameters provide information for the dialog and for maintenance of the permission (similar to the ways that cookies are managed). Only one doReadRequest( ) method is required, regardless of the number of attributes in the queue.

 
Parameters
 
CodeMeaning
0Used for system administration.
1Used for research and/or product development.
2Used for completion and support of current transaction.
3Used to customize the content and design of a site.
4Used to improve the content of the site, including advertisements.
5Used for notifying visitors about updates to the site.
6Used for contacting visitors for marketing of services or products.
7Used for linking other collected information.
8Used by site for other purposes.
9Disclosed to others for customization or improvement of the content and design of the site.
10Disclosed to others who may contact you for marketing of services and/or products.
11Disclosed to others who may contact you for marketing of services and/or products, but you have the opportunity to ask a site not to do this.
12Disclosed to others for any other purpose.
 
  • One of the following code integers that display human-readable messages defined by the Internet Privacy Working Group, as shown in the following table.
 
  • An optional string containing an identifiable name (and URL) that the user recognizes as the source of the request. This may be a corporate identity.
  • An optional string containing the domain of the server making the request. If an expiration date is set, this information is stored with the requested attributes to prevent future requests from this domain from interrupting the user with the Profile Assistant dialog box.
  • An optional string containing the path of the server document making the request. If an expiration date is set, this information is stored with the requested attributes to prevent future requests from this domain from interrupting the user with the Profile Assistant dialog box.
  • An optional string containing the date on which the user's permissions settings expire. Not recognized in Internet Explorer 4.
 
Returned Value

In Windows, the method returns no value, regardless of how the user responds to the Profile Assistant dialog box. On the Macintosh (which does not support this object fully), the method does not display the Profile Assistant dialog box and returns false.


Powered by Linode.