object标签的name属性必须显式声明才能通过window[name]或document[name]访问,它是插件方法调用的关键标识,非装饰性字段;不设name则无法直接调用如myPrinter.Print()等方法。

object 标签的 name 属性必须显式声明才生效
浏览器不会自动为 元素生成可脚本访问的全局变量,name 属性不是“设置名称”的装饰性字段,而是让该对象能在 JS 中通过 window[name] 或 document[name] 直接引用的关键标识。不写 name,就无法用名字取到它。
常见错误是只写 id,误以为能靠 document.getElementById() 之后再操作插件内部 API——但很多旧版插件(如 ActiveX、Flash 封装器)要求必须通过命名引用才能调用其方法。
-
name值必须是合法的 JavaScript 标识符(不能含空格、短横线、数字开头) - 同一文档中多个
不应共用相同name,否则后者覆盖前者 - 若同时设置了
id和name,二者可不同,但 JS 访问时name才触发全局绑定
在 IE 中用 name 调用 ActiveX 方法的典型写法
虽然现代浏览器已弃用 ActiveX,但遗留系统仍需维护。IE 下只有 name 正确设置后,才能在 JS 中直接调用插件暴露的方法,例如:
<object classid="clsid:XXXX..." name="myPrinter"></object>
之后可立即执行:
myPrinter.Print(); // ✅ 成功调用(前提是 name="myPrinter" 已设)
若写成 id="myPrinter" 而没设 name,这段代码会报 myPrinter is not defined。
- ActiveX 插件是否支持方法调用,取决于其 COM 接口是否标记为
[dual]或[dispatch] - IE11 的企业模式下仍保留此行为;Edge(Chromium)及所有现代浏览器完全不支持
- 不要依赖
document.myPrinter,某些文档模式下它可能为undefined,优先用顶层变量名
name 和 data/src 加载时机影响脚本调用顺序
的 name 属性在 DOM 解析阶段即注册,但插件实例(尤其是 ActiveX 或 NPAPI 插件)需等 data(或 src)资源加载完成、初始化完毕后,才真正具备方法能力。此时直接调用大概率失败。
- 监听
load事件不总是可靠(部分插件不触发),更稳妥的是轮询typeof myPrinter.Print === 'function' - 若
data指向本地文件而路径错误,name仍存在,但对象处于“空壳”状态,调用任何方法都静默失败或抛异常 - Chrome 早期支持 NPAPI 时也遵循类似规则;现在所有主流浏览器已移除 NPAPI,仅剩 IE/Edge Legacy 场景需注意
替代方案:用 id + getElementsByTagName 避免 name 冲突风险
当页面含多个同类插件,或需避免污染全局命名空间时,不推荐依赖 name 绑定。可用更可控的方式获取对象引用:
const obj = document.querySelector('object[data*="printer.dll"]');
或按类型筛选:
const objs = document.getElementsByTagName('object');<br>for (let o of objs) {<br> if (o.data && o.data.includes('report.ocx')) {<br> o.invokeReport();<br> break;<br> }<br>}
- 这种方式绕过
name全局变量机制,适合模块化或多人协作项目 - 注意
getElementsByTagName返回的是实时集合,插入新会动态更新 - 若插件未初始化完成,
o.invokeReport可能为undefined,仍需加存在性判断
实际部署时最容易被忽略的是:即使 name 设置正确,只要插件二进制文件路径不对、版本不兼容、或用户禁用了 ActiveX 控件,整个对象就形同虚设——这时 name 只是个空壳变量名,毫无意义。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











