IT学习者 -> 技术文档 -> JavaScript语言参考手册
JavaScript手册
【目录】 【上一页】 【下一章】 【索引】

Plugin

在客户端上安装的一个插件模块。

客户端对象
实现版本 Navigator 3.0

创建源

Plugin 对象是 JavaScript 的预定义对象,你可以通过 navigator.plugins 数组访问它们。

描述

一个 Plugin 对象就是一个安装在客户端的插件。所谓插件,就是浏览器用于显示特定类型嵌入数据时调用的软件模块。用户从帮助菜单中选择关于插件选项可以获取已安装插件的清单。

每个 Plugin 对象本身都是一个数组,其中包含的每个元素分别对应于每个该插件支持的 MIME 类型。而数组的每个元素都是一个 MimeType 对象。例如,下面的代码将显示第一个 Plugin 对象的第一个 MimeType 对象的 type 和描述 属性。

myPlugin=navigator.plugins[0]
myMimeType=myPlugin[0]
document.writeln('myMimeType.type 为 ',myMimeType.type,"<BR>")
document.writeln('myMimeType.description 为 ',myMimeType.description)

而此代码的显示输出与下列内容相似:

myMimeType.type 为 video/quicktime
myMimeType.description 为 QuickTime for Windows

Plugin 对象使你可以动态判断客户端上安装了哪些插件。你可以编写这样的脚本,用于在已安装对应的插件时显示嵌入插件数据,而在没有安装对应插件的时候显示某些如图像或文本等的替换信息。

插件可能是与平台相关的或可配置的,所以 Plugin 对象的 MimeType 对象数组在不同的平台或用户那里的情况可能并不相同。

每个 Plugin 对象都是 plugins 数组中的一个元素。

当你使用 EMBED 标记从插件应用程序中生成输出的时候,你就不能创建 Plugin 对象。你可以使用 document.embeds 数组获取对用 EMBED 标记创建的插件实例的引用。详细内容请参看 document.embeds 数组。

属性概览

description 插件的描述。
filename 插件文件在磁盘上的文件名。
length 插件中 MimeType 对象数组的元素个数。
name 插件的名称。

示例

示例 1 用户可以从帮助菜单中选择关于插件获取已安装的插件列表。要查看浏览器完成此报表的源代码,可以首先从帮助菜单中选择关于插件选项,然后从查看菜单中选择页面源文件。

示例 2 下列代码将把预定义的 LiveAudio 属性赋给简明变量。

var myPluginName = navigator.plugins["LiveAudio"].name
var myPluginFile = navigator.plugins["LiveAudio"].filename
var myPluginDesc = navigator.plugins["LiveAudio"].description

示例 3 下面的代码将在已安装 LiveAudio 的情况下显示消息“LiveAudio 已经配置为 audio/wav”,也就是说它对应于“audio/wav”MIME类型:

var myPlugin = navigator.plugins["LiveAudio"]
var myType = myPlugin["audio/wav"]
if (myType && myType.enabledPlugin == myPlugin)
   document.writeln("LiveAudio 已经配置为 audio/wav")

示例 4 下面的表达式将呈现出 Shockwave 可以显示的 MIME 类型数目:

navigator.plugins["Shockwave"].length

示例 5 下面的代码将列出一张表,其中显示了客户端每个 Plugin 对象的 name、filename、description 和 length 属性:

document.writeln("<TABLE BORDER=1><TR VALIGN=TOP>",
   "<TH ALIGN=left>i",
   "<TH ALIGN=left>名称",
   "<TH ALIGN=left>文件名",
   "<TH ALIGN=left>描述",
   "<TH ALIGN=left>类型数</TR>")
for (i=0; i < navigator.plugins.length; i++) {
   document.writeln("<TR VALIGN=TOP><TD>",i,
      "<TD>",navigator.plugins[i].name,
      "<TD>",navigator.plugins[i].filename,
      "<TD>",navigator.plugins[i].description,
      "<TD>",navigator.plugins[i].length,
      "</TR>")
}
document.writeln("</TABLE>")
上面例子的输出结果与下面类似:

i 名称 文件名 描述 类型数
0QuickTime Plug-Ind:\nettools\netscape\nav30\Program\
plugins\NPQTW32.DLL
QuickTime Plug-In for Win32 v.1.0.01
1LiveAudiod:\nettools\netscape\nav30\Program\
plugins\NPAUDIO.DLL
LiveAudio - Netscape Navigator sound playing component7
2NPAVI32 Dynamic Link Libraryd:\nettools\netscape\nav30\Program\
plugins\npavi32.dll
NPAVI32, avi plugin DLL2
3Netscape Default Plugind:\nettools\netscape\nav30\Program\
plugins\npnul32.dll
Null Plugin1

参看

MimeType, document.embeds

属性

description

人工可阅读的插件描述。该文本由插件开发者提供。

属性源Plugin
只读
实现版本Navigator 3.0

filename

插件文件在磁盘上的名称。

属性源Plugin
只读
实现版本Navigator 3.0

描述

filename 属性是插件程序文件名,由插件自身提供。该名称可能因平台不同而不同。

示例

参看 Plugin 的示例。

length

MimeType 对象的插件数组中的元素个数。

属性源Plugin
只读
实现版本Navigator 3.0

name

指定插件名称的字符串。

属性源Plugin
只读
实现版本Navigator 3.0

安全性

Navigator 3.0: 该属性缺省情况下是带有污点的。要获得关于数据污点更多的信息,请看“JavaScript 安全性”

描述

插件的名称,由插件自身提供。每个插件都应该有一个唯一的名称标识自身。


【目录】 【上一页】 【下一章】 【索引】

返回页面顶部