Firefox扩展SDK开发人员指南(七)-两种类型的脚本

小工具不用东奔西走，阳光宝盒全有
如果您喜欢这篇文章，请访问盛夏莲花博客以获取最新内容更新及评论，以及更好的阅读体验

在web页面上，javascript在页面的的上下文中执行，并且可以访问该页面的DOM。这使得您可以如下例调用：

 
 
window.alert("Hello there");

在扩展的main脚本里，您却不可以这样做，因为addon-on的代码并不是在页面的上下文中执行，因此DOM也无法访问。如果您需要访问某个特别页面的DOM，您需要一个内容脚本。因此，在一个扩展中可能存在两种不同类型的javascript脚本，它们分别可以调用不同的API集。在SDK文档（即本文档）中，我们称其中的一种为扩展代码（add-on code)，而另一种为内容脚本（content script）。

扩展代码

 

这是您扩展中主要逻辑得以实现的地方。

您的扩展被实现为一组（或多组）CommonJs模块集。每个模块通过一个位于lib文件夹下的javascript文件提供，而lib文件夹则是您的扩展的根目录下的一个子文件夹。

您的扩展最少包含一个模块，这个模块被称作main.js。但您可以在lib里包含额外的模块，并且使用require将它们导入进来。要学习如何实现自己的模块以及如何导入它们，请参阅实现可重用的模块。

内容脚本

每个扩展都必然有一个main.js模块。但只有当扩展需要操纵页面内容时，才需要一个内容脚本。内容脚本通过使用诸如page-mod,panel或widget这一类的SDK模块定义的API被注入到网页中。

内容脚本可以文本字符串形式，或者以单独的文件形式提供。如果它们存放在文件中，您需要将其存放在扩展根目录下的data目录中。

要进一步学习内容脚本，请阅读使用内容脚本指南。

扩展代码和内容脚本可使用的API列表

API	扩展代码	内容脚本
定义在核心javascript语言中的全局对象，如Math,Array,JSON。请参见reference at MDN	✔	✔
CommonJS模块规范1.0中定义的require()和exports()	✔	✘
SDK定义的console全局对象	✔	✔
HTML5定义的全局对象，如window,document,localStorage	✘	✔
self全局对象，用于内容脚本与扩展脚本之间的通信。参见与内容脚本通信。	✘	✔