The Tor Browser: addon-sdk/source/lib/sdk/system.js@129ffea94266 (annotated)

addon-sdk/source/lib/sdk/system.js@129ffea94266 (annotated)

addon-sdk/source/lib/sdk/system.js

Sat, 03 Jan 2015 20:18:00 +0100

author: Michael Schloh von Bennewitz <michael@schloh.com>
date: Sat, 03 Jan 2015 20:18:00 +0100
branch: TOR_BUG_3246
changeset 7: 129ffea94266
permissions: -rw-r--r--

Conditionally enable double key logic according to:
private browsing mode or privacy.thirdparty.isolate preference and
implement in GetCookieStringCommon and FindCookie where it counts...
With some reservations of how to convince FindCookie users to test
condition and pass a nullptr when disabling double key logic.

 /* 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/. */
 'use strict';
 module.metadata = {
   "stability": "unstable"
 };
 const { Cc, Ci, CC } = require('chrome');
 const options = require('@loader/options');
 const file = require('./io/file');
 const runtime = require("./system/runtime");
 const appStartup = Cc['@mozilla.org/toolkit/app-startup;1'].
                    getService(Ci.nsIAppStartup);
 const appInfo = Cc["@mozilla.org/xre/app-info;1"].
                 getService(Ci.nsIXULAppInfo);
 const directoryService = Cc['@mozilla.org/file/directory_service;1'].
                          getService(Ci.nsIProperties);
 const PR_WRONLY = parseInt("0x02");
 const PR_CREATE_FILE = parseInt("0x08");
 const PR_APPEND = parseInt("0x10");
 const PR_TRUNCATE = parseInt("0x20");
 function openFile(path, mode) {
   let file = Cc["@mozilla.org/file/local;1"].
              createInstance(Ci.nsILocalFile);
   file.initWithPath(path);
   let stream = Cc["@mozilla.org/network/file-output-stream;1"].
                createInstance(Ci.nsIFileOutputStream);
   stream.init(file, mode, -1, 0);
   return stream
 }
 const { eAttemptQuit: E_ATTEMPT, eForceQuit: E_FORCE } = appStartup;
 /**
  * Parsed JSON object that was passed via `cfx --static-args "{ foo: 'bar' }"`
  */
 exports.staticArgs = options.staticArgs;
 /**
  * Environment variables. Environment variables are non-enumerable properties
  * of this object (key is name and value is value).
  */
 exports.env = require('./system/environment').env;
 /**
  * Ends the process with the specified `code`. If omitted, exit uses the
  * 'success' code 0. To exit with failure use `1`.
  * TODO: Improve platform to actually quit with an exit code.
  */
 let forcedExit = false;
 exports.exit = function exit(code) {
   if (forcedExit) {
     // a forced exit was already tried
     // NOTE: exit(0) is called twice sometimes (ex when using cfx testaddons)
     return;
   }
   // This is used by 'cfx' to find out exit code.
   if ('resultFile' in options && options.resultFile) {
     let mode = PR_WRONLY | PR_CREATE_FILE | PR_TRUNCATE;
     let stream = openFile(options.resultFile, mode);
     let status = code ? 'FAIL' : 'OK';
     stream.write(status, status.length);
     stream.flush();
     stream.close();
   }
   if (code == 0) {
     forcedExit = true;
   }
   appStartup.quit(code ? E_ATTEMPT : E_FORCE);
 };
 // Adapter for nodejs's stdout & stderr:
 // http://nodejs.org/api/process.html#process_process_stdout
 let stdout = Object.freeze({ write: dump, end: dump });
 exports.stdout = stdout;
 exports.stderr = stdout;
 /**
  * Returns a path of the system's or application's special directory / file
  * associated with a given `id`. For list of possible `id`s please see:
  * https://developer.mozilla.org/en-US/docs/Code_snippets/File_I_O#Getting_files_in_special_directories
  * http://mxr.mozilla.org/mozilla-central/source/xpcom/io/nsAppDirectoryServiceDefs.h
  * @example
  *
  *    // get firefox profile path
  *    let profilePath = require('system').pathFor('ProfD');
  *    // get OS temp files directory (/tmp)
  *    let temps = require('system').pathFor('TmpD');
  *    // get OS desktop path for an active user (~/Desktop on linux
  *    // or C:\Documents and Settings\username\Desktop on windows).
  *    let desktopPath = require('system').pathFor('Desk');
  */
 exports.pathFor = function pathFor(id) {
   return directoryService.get(id, Ci.nsIFile).path;
 };
 /**
  * What platform you're running on (all lower case string).
  * For possible values see:
  * https://developer.mozilla.org/en/OS_TARGET
  */
 exports.platform = runtime.OS.toLowerCase();
 const [, architecture, compiler] = runtime.XPCOMABI ?
                                    runtime.XPCOMABI.match(/^([^-]*)-(.*)$/) :
                                    [, null, null];
 /**
  * What processor architecture you're running on:
  * `'arm', 'ia32', or 'x64'`.
  */
 exports.architecture = architecture;
 /**
  * What compiler used for build:
  * `'msvc', 'n32', 'gcc2', 'gcc3', 'sunc', 'ibmc'...`
  */
 exports.compiler = compiler;
 /**
  * The application's build ID/date, for example "2004051604".
  */
 exports.build = appInfo.appBuildID;
 /**
  * The XUL application's UUID.
  * This has traditionally been in the form
  * `{AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE}` but for some applications it may
  * be: "appname@vendor.tld".
  */
 exports.id = appInfo.ID;
 /**
  * The name of the application.
  */
 exports.name = appInfo.name;
 /**
  * The XUL application's version, for example "0.8.0+" or "3.7a1pre".
  */
 exports.version = appInfo.version;
 /**
  * XULRunner version.
  */
 exports.platformVersion = appInfo.platformVersion;
 /**
  * The name of the application vendor, for example "Mozilla".
  */
 exports.vendor = appInfo.vendor;