Determines the capabilities of a Web client, that is you can determine the properties of the browser for the current request.

Note This @function is new with Release 5.

Syntax

@BrowserInfo( "propertyname" )

Parameters

propertyname

Text. The name of the browser property to be retrieved.

The return value type is dependent on the capability. The table below shows the current set of Web browser and Notes client capabilities that Lotus 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

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 Lotus 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")

Language cross-reference

CGI variables

The browser.cnf file

Example
See Also

@GetHTTPHeader
"Taking your Domino applications to the Web" on the Lotus Developer Domain
"Teach Domino new Web tricks with DHTML" on the Lotus Developer Domain
"Using XML data islands in Domino Designer" on the Lotus Developer Domain

Glossary