Provide access to the File object

bootstrap.js.tmpl

 /*
  * This Source Code is subject to the terms of the Mozilla Public License
  * version 2.0 (the "License"). You can obtain a copy of the License at
  * http://mozilla.org/MPL/2.0/.
  */
 
 const Cc = Components.classes;
 const Ci = Components.interfaces;
 const Cr = Components.results;
 const Cu = Components.utils;
 
 let {Services, atob, btoa, File} = Cu.import("resource://gre/modules/Services.jsm", null);

[Wladimir Palant, 2012/09/25 15:21:42]

Just importing it into bootstrap.js scope is not sufficient, you also have to
add it to the scope of the modules (module scopes are set up in require()
function below).

The fact that the code works the way you have it here is more or less a bug:
modules can access the scope of bootstrap.js. That's because we don't put them
into individual sandboxes unless you specify the --multi-compartment build
option (something that currently has a bit too much impact on memory footprint
and performance). So they share the global object with bootstrap.js.

Eventually we should make sure that bootstrap.js doesn't define any global
variables beyond the required startup/shutdown/install/uninstall.

 
 let addonData = null;
 
 function startup(params, reason)
 {
   addonData = params;
 
   {%- if hasChrome %}
   if (Services.vc.compare(Services.appinfo.platformVersion, "10.0") < 0)
   {
@@ skipping 119 matching lines @@
     {
     {%- endif %}
       let url = addonData.resourceURI.spec + "lib/" + module + ".js";
       scopes[module] = {
         Cc: Cc,
         Ci: Ci,
         Cr: Cr,
         Cu: Cu,
         atob: atob,
         btoa: btoa,
+        File: File,
         require: require,
         {% if hasShutdownHandlers %}
         onShutdown: onShutdown,
         {% endif %}
         exports: {}};
       {%- if multicompartment %}
       let principal = Cc["@mozilla.org/systemprincipal;1"].getService(Ci.nsIPrincipal);
       scopes[module] = new Cu.Sandbox(principal, {
         sandboxName: url,
         sandboxPrototype: scopes[module],
@@ skipping 18 matching lines @@
   {
     if (topic == "{{metadata.get('general', 'basename')}}-require")
     {
       subject.wrappedJSObject.exports = require(data);
     }
   },
 
   QueryInterface: XPCOMUtils.generateQI([Ci.nsISupportsWeakReference, Ci.nsIObserver])
 };
 {%- endif %}