Browser Capabilities 组件Browscap.ini 文件

Browscap.ini 文件

可以在 browscap.ini 文件中声明属性定义任意数量的浏览器数目。也可以设置在用户的浏览器不在所定义的列表中时使用的默认值。

对每一个浏览器定义，都可以提供一个 HTTP User Agent 标题和属性以及希望与标题相关联的值。有关 HTTP User Agent 标题格式更多的信息，请参阅 http://www.w3.org/ 站点上的 HTTP 规格说明。

语法

[; comments]
 
[HTTPUserAgentHeader] 
 
[parent = browserDefinition]
 
[property1 = value1]
 
...
 
[propertyN = valueN] 
 
[Default Browser Capability Settings]
 
[defaultProperty1 = defaultValue1]
 
...
 
[defaultPropertyN = defaultValueN]

参数

comments

用分号 (;) 开始的任何行。BrowserType 对象将忽略这些注释，它们可以位于 browscap.ini 文件中的任何位置。

HTTPUserAgentHeader

指定与在 propertyN 中指定的 browser-property 语句关联的 HTTP User Agent 标题。browscap.ini 文件可以包含多个浏览器定义，每一个都以唯一的 HTTPUserAgentHeader 值开始。

在 HTTPUserAgentHeader 中，可以使用星号 (*) 作为通配符来代替 0 个或多个字符。

例如，如果为 HTTPUserAgentHeader 指定了下面的字符串：

[Mozilla/2.0 (compatible; MSIE 3.0;* Windows 95)]

它将匹配下列所有 User Agent 标题：

[Mozilla/2.0 (compatible; MSIE 3.0; Windows 95)]
[Mozilla/2.0 (compatible; MSIE 3.0; AK; Windows 95)]
[Mozilla/2.0 (compatible; MSIE 3.0; SK; Windows 95)]
[Mozilla/2.0 (compatible; MSIE 3.0; AOL; Windows 95)]

注意 BrowserType 对象首先尝试将 User Agent 标题与 HTTPUserAgentHeader 的值完全匹配。如果失败，将尝试匹配通配符。

如果多个浏览器定义包含的通配符字符与 User Agent 标题匹配，则 BrowserType 对象返回第一个定义的属性。

browserDefinition

可选参数，指定要用作父浏览器的浏览器的 HTTP User Agent 标题字符串。当前的浏览器定义将继承父浏览器定义中声明的所有属性值。这有助于定义新版本的浏览器的属性，因为新版本通常保留先前版本属性的大部分。这些被继承的属性值可以被覆盖，方法是用 propertyN = valueN 语法在外部设置一个新的属性值。

propertyN

可选参数，指定要设置的浏览器属性名。它必须以英文字母开始且不得超过 255 个字符。在 browscap.ini 文件中的每一个浏览器定义可以包含任意多的属性语句。例如，如果用户的应用程序只需知道用户浏览器是支持 VBScript，则对于每个浏览器定义，只需设置一个属性语句即可。

下面的列表列出了一些可能的属性：

属性	说明
ActiveXControls	指定该浏览器是否支持 ActiveX 控件。
backgroundsounds	指定该浏览器是否支持背景音乐。
beta	指定该浏览器是否测试版。
browser	指定该浏览器的名称。
cdf	指定该浏览器是否支持用于 Web 预测的 Channel Definition Format。
cookies	指定该浏览器是否支持 cookies。
frames	指定该浏览器是否支持框架。
Javaapplets	指定该浏览器是否支持 Java 程序。
javascript	指定该浏览器是否支持 JScript。
platform	指定该浏览器的运行平台。
tables	指定该浏览器是否支持表格。
vbscript	指定该浏览器是否支持 VBScript。
version	指定该浏览器的版本号。

valueN

可选参数，指定 propertyN 的值。其默认值为字符串。要说明为整型，用标志 (#) 作为此值的前缀。要说明为布尔型，用 TRUE 或 FALSE。

defaultPropertyN

可选参数，指定浏览器的属性名，如果没有由浏览器发送的 HTTP User Agent 标题与 HTTPUserAgentHeader 值匹配，则将其置为默认值。

defaultValueN

可选参数，指定 defaultPropertyN 值的名称。其默认值为字符串。要将其指定为整型，请将 # 号作为此值的前缀。要将其指定为布尔型，请使用 TRUE 或 FALSE。

示例

在下面的例子中，父标签允许第二个浏览器继承第一个浏览器的定义，以便 Microsoft® Internet Explorer 3.01 定义继承 Microsoft® Internet Explorer 3.0 定义全部的属性（例如，frames=TRUE、 tables=TRUE 和 cookies=TRUE）。它通过添加 platform=Win95 行来指定平台，用 version=3.01 重写版本信息。

;;ie 3.0
[IE 3.0]
browser=IE
Version=3.0
majorver=#3
minorver=#0
frames=TRUE
tables=TRUE
cookies=TRUE
backgroundsounds=TRUE
vbscript=TRUE
javascript=TRUE
javaapplets=True
ActiveXControls=TRUE
Win16=False
beta=False
AK=False
SK=False
AOL=False
 
;;ie 3.01
[Mozilla/2.0 (compatible; MSIE 3.01*; Windows 95)]
parent=IE 3.0
version=3.01
minorver=01
platform=Win95
 
; Default Browser 
[Default Browser Capability Settings]
browser=Default
frames=FALSE 
tables=TRUE 
cookies=FALSE 
backgroundsounds=FALSE 
vbscript=FALSE 
javascript=FALSE