@BrowserInfo (Formula Language)

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.

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)