@BrowserInfo (Formula Language)
Determines the capabilities of a Web client, that is you can determine the properties of the browser for the current request.
Syntax
@BrowserInfo( "propertyname" )
Parameters
propertyname
Text. The name of the browser property to be retrieved.
Return value
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™" |
"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 |
Usage
@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")
Examples
This example displays the value in the field named KeyThought, if the current browser supports JavaScript™; otherwise the value in the field Topic is displayed.@If (@BrowserInfo("JavaScript"); KeyThought;Topic)