FORMULA LANGUAGE

@BrowserInfo
Example

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


Return value

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 nameReturn typeReturn value for browsersReturn value for Notes client
BrowserTypeTextThe type of the browser: "Microsoft," "Netscape," "Compatible" (for browsers that claim to be compatible with Netscape, including Notes Navigator 5.0), or "Unknown.""Notes"
CookiesBoolean1 (True) if the browser supports cookies; otherwise 0 (False).0 (False)
DHTMLBoolean1 (True) if the browser supports dynamic HTML; otherwise 0 (False).0 (False)
FileUploadBoolean1 (True) if the browser supports file upload; otherwise 0 (False).0 (False)
FramesBoolean1 (True) if the browser supports the HTML <FRAME> tag; otherwise 0 (False).1 (True)
JavaBoolean1 (True) if the browser supports Java applets; otherwise 0 (False).1 (True)
JavaScriptBoolean1 (True) if the browser supports JavaScript; otherwise 0 (False).1 (True)
IframeBoolean1 (True) if the browser supports the Microsoft HTML <IFRAME> tag; otherwise 0 (False).0 (False)
PlatformTextThe operating system platform of the browser: "Win95," "Win98," "WinNT," "MacOS," or "Unknown.""Unknown"
RobotBoolean1 (True) if the browser is probably a Web robot; otherwise 0 (False).0 (False)
SSLBoolean1 (True) if the browser supports SSL; otherwise 0 (False).0 (False)
TablesBoolean1 (True) if the browser supports the HTML <TABLE> tag; otherwise 0 (False).1 (True)
VBScriptBoolean1 (True) if the browser supports VBScript; otherwise 0 (False).0 (False)
VersionNumberThe 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