Determines the capabilities of a Web client, that is you can determine the properties of the browser for the current request.
@BrowserInfo( "propertyname" )
propertyname
Text. The name of the browser property to be retrieved.
The return value type is dependent on the capability. The table shows the current set of Web browser and Notes® client capabilities that Notes/Domino supports:
Property name |
Return type |
Return value for browsers |
Return value for Notes client |
---|---|---|---|
BrowserType |
Text |
The type of the browser: "Microsoft," "Netscape," "Compatible" (for browsers that claim to be compatible with Netscape, including Notes Navigator 5.0), or "Unknown." |
"Notes" |
Cookies |
Boolean |
1 (True) if the browser supports cookies; otherwise 0 (False). |
0 (False) |
DHTML |
Boolean |
1 (True) if the browser supports dynamic HTML; otherwise 0 (False). |
0 (False) |
FileUpload |
Boolean |
1 (True) if the browser supports file upload; otherwise 0 (False). |
0 (False) |
Frames |
Boolean |
1 (True) if the browser supports the HTML <FRAME> tag; otherwise 0 (False). |
1 (True) |
Java™ |
Boolean |
1 (True) if the browser supports Java applets; otherwise 0 (False). |
1 (True) |
JavaScript |
Boolean |
1 (True) if the browser supports JavaScript; otherwise 0 (False). |
1 (True) |
Iframe |
Boolean |
1 (True) if the browser supports the Microsoft HTML <IFRAME> tag; otherwise 0 (False). |
0 (False) |
Platform |
Text |
The operating system platform of the browser: "Win95," "Win98," "WinNT," "MacOS," or "Unknown." |
"Unknown" |
Robot |
Boolean |
1 (True) if the browser is probably a Web robot; otherwise 0 (False). |
0 (False) |
SSL |
Boolean |
1 (True) if the browser supports SSL; otherwise 0 (False). |
0 (False) |
Tables |
Boolean |
1 (True) if the browser supports the HTML <TABLE> tag; otherwise 0 (False). |
1 (True) |
VBScript |
Boolean |
1 (True) if the browser supports VBScript; otherwise 0 (False). |
0 (False) |
Version |
Number |
The browser version number, or -1 for unrecognized browsers. |
Notes client build number |
@BrowserInfo determines the properties of a browser by matching the HTTP User-Agent header sent by the browser to property rules in the browser.cnf file in the Domino® data directory. @BrowserInfo also contains hard-coded rules for the Notes client.
@BrowserInfo can be used in all types of formulas except view selection and view column formulas.
Pre-5.0 Notes clients will not be able to open forms that use @BrowserInfo. The client will display the error message "Invalid formula: unknown function/operator." To prevent this error, check the version number of the client in your formulas. Example:
@If(@TextToNumber(@Version) >= 160; @BrowserInfo("BrowserType");"Unknown")
@If (@BrowserInfo("JavaScript"); KeyThought;Topic)