The Tor Browser / file revision

 /* This Source Code Form is subject to the terms of the Mozilla Public

  * License, v. 2.0. If a copy of the MPL was not distributed with this

  * file, you can obtain one at http://mozilla.org/MPL/2.0/. */

 /**

  * @namespace Defines useful methods to work with localized content

  */

 var l10n = exports;

 Cu.import("resource://gre/modules/Services.jsm");

 /**

  * Retrieve the localized content for a given DTD entity

  *

  * @memberOf l10n

  * @param {String[]} aDTDs Array of URLs for DTD files.

  * @param {String} aEntityId ID of the entity to get the localized content of.

  *

  * @returns {String} Localized content

  */

 function getEntity(aDTDs, aEntityId) {

   // Add xhtml11.dtd to prevent missing entity errors with XHTML files

   aDTDs.push("resource:///res/dtd/xhtml11.dtd");

   // Build a string of external entities

   var references = "";

   for (i = 0; i < aDTDs.length; i++) {

     var id = 'dtd' + i;

     references += '<!ENTITY % ' + id + ' SYSTEM "' + aDTDs[i] + '">%' + id + ';';

   }

   var header = '<?xml version="1.0"?><!DOCTYPE elem [' + references + ']>';

   var element = '<elem id="entity">&' + aEntityId + ';</elem>';

   var content = header + element;

   var parser = Cc["@mozilla.org/xmlextras/domparser;1"].

                createInstance(Ci.nsIDOMParser);

   var doc = parser.parseFromString(content, 'text/xml');

   var node = doc.querySelector('elem[id="entity"]');

   if (!node) {

     throw new Error("Unkown entity '" + aEntityId + "'");

   }

   return node.textContent;

 }

 /**

  * Retrieve the localized content for a given property

  *

  * @memberOf l10n

  * @param {String} aURL URL of the .properties file.

  * @param {String} aProperty The property to get the value of.

  *

  * @returns {String} Value of the requested property

  */

 function getProperty(aURL, aProperty) {

   var bundle = Services.strings.createBundle(aURL);

   try {

     return bundle.GetStringFromName(aProperty);

   } catch (ex) {

     throw new Error("Unkown property '" + aProperty + "'");

   }

 }

 // Export of functions

 l10n.getEntity = getEntity;

 l10n.getProperty = getProperty;