Browser Capabilities Component

The Browser Capabilities component provides your scripts with a description of the capabilities of the client’s Web browser.

When a browser connects to the Web server, it automatically sends a User Agent HTTP header. This header is an ASCII string that identifies the browser and its version number. The Browser Capabilities component compares the header to entries in the Browscap.ini file.

If it finds a match, the Browser Capabilities component assumes the properties of the browser listing that matched the User Agent header.

If the component does not find a match for the header in the Browscap.ini file, it takes on the default browser properties. If the component does not find a match and default browser settings have not been specified in the Browscap.ini file, it sets every property to the string “UNKNOWN”.

You can add properties or new browser definitions to this component simply by updating the Browscap.ini file.

File Names

Browscap.dll	The Browser Capabilities component.
Browscap.ini	A text file that maps browser capabilities to the HTTP User Agent header. This file must be in the same directory as Browscap.dll.

Syntax

Set BrowserType = Server.CreateObject("MSWC.BrowserType")

Parameters

BrowserType

Specifies the name of the object created by the call to Server.CreateObject.

Registry Entries

None.

Example

The following example uses the Browser Capabilities component to display a table showing some of the capabilities of the current browser.

<%  Set bc = Server.CreateObject("MSWC.BrowserType") %>  
<table border=1> 
<tr><td>Browser</td><td>  <%= bc.browser  %>  
<tr><td>Version</td><td>  <%= bc.version  %>  </td></TR> 
<tr><td>Frames</td><td>
<%  if (bc.frames = TRUE) then  %>  TRUE
<%  else  %>  FALSE
<%  end if  %> </td></TR> 
<tr><td>Tables</td><td>
<%  if (bc.tables = TRUE) then  %>  TRUE 
<%  else  %> FALSE
<%  end if  %> </td></TR> 
<tr><td>BackgroundSounds</td><td> 
<%  if (bc.BackgroundSounds = TRUE) then  %>  TRUE 
<%  else  %> FALSE
<%  end if  %> </td></TR> 
<tr><td>VBScript</td><td> 
<%  if (bc.vbscript = TRUE) then  %>  TRUE 
<%  else  %> FALSE
<%  end if  %> </td></TR> 
<tr><td>JScript</td><td> 
<%  if (bc.javascript = TRUE) then  %>  TRUE 
<%  else  %> FALSE
<%  end if  %> </td></TR> 
</table>