The Tor Browser: accessible/tests/mochitest/actions.js@97036ab72558 (annotated)

accessible/tests/mochitest/actions.js@97036ab72558 (annotated)

accessible/tests/mochitest/actions.js

Tue, 06 Jan 2015 21:39:09 +0100

author: Michael Schloh von Bennewitz <michael@schloh.com>
date: Tue, 06 Jan 2015 21:39:09 +0100
branch: TOR_BUG_9701
changeset 8: 97036ab72558
permissions: -rw-r--r--

Conditionally force memory storage according to privacy.thirdparty.isolate;
This solves Tor bug #9701, complying with disk avoidance documented in
https://www.torproject.org/projects/torbrowser/design/#disk-avoidance.

 ////////////////////////////////////////////////////////////////////////////////
 // Event constants
 const MOUSEDOWN_EVENT = 1;
 const MOUSEUP_EVENT = 2;
 const CLICK_EVENT = 4;
 const COMMAND_EVENT = 8;
 const FOCUS_EVENT = 16;
 const CLICK_EVENTS = MOUSEDOWN_EVENT | MOUSEUP_EVENT | CLICK_EVENT;
 const XUL_EVENTS = CLICK_EVENTS | COMMAND_EVENT;
 ////////////////////////////////////////////////////////////////////////////////
 // Public functions
 /**
  * Test default accessible actions.
  *
  * Action tester interface is:
  *
  *  var actionObj = {
  *    // identifier of accessible to perform an action on
  *    get ID() {},
  *
  *    // index of the action
  *    get actionIndex() {},
  *
  *    // name of the action
  *    get actionName() {},
  *
  *    // DOM events (see constants defined above)
  *    get events() {},
  *
  *    // [optional] identifier of target DOM events listeners are registered on,
  *    // used with 'events', if missing then 'ID' is used instead.
  *    get targetID() {},
  *
  *    // [optional] perform checks when 'click' event is handled if 'events'
  *    // is used.
  *    checkOnClickEvent: function() {},
  *
  *    // [optional] an array of invoker's checker objects (see eventQueue
  *    // constructor events.js)
  *    get eventSeq() {}
  *  };
  *
  *
  * @param  aArray [in] an array of action cheker objects
  */
 function testActions(aArray)
 {
   gActionsQueue = new eventQueue();
   for (var idx = 0; idx < aArray.length; idx++) {
     var actionObj = aArray[idx];
     var accOrElmOrID = actionObj.ID;
     var actionIndex = actionObj.actionIndex;
     var actionName = actionObj.actionName;
     var events = actionObj.events;
     var accOrElmOrIDOfTarget = actionObj.targetID ?
       actionObj.targetID : accOrElmOrID;
     var eventSeq = new Array();
     if (events) {
       var elm = getNode(accOrElmOrIDOfTarget);
       if (events & MOUSEDOWN_EVENT)
         eventSeq.push(new checkerOfActionInvoker("mousedown", elm));
       if (events & MOUSEUP_EVENT)
         eventSeq.push(new checkerOfActionInvoker("mouseup", elm));
       if (events & CLICK_EVENT)
         eventSeq.push(new checkerOfActionInvoker("click", elm, actionObj));
       if (events & COMMAND_EVENT)
         eventSeq.push(new checkerOfActionInvoker("command", elm));
       if (events & FOCUS_EVENT)
         eventSeq.push(new focusChecker(elm));
     }
     if (actionObj.eventSeq)
       eventSeq = eventSeq.concat(actionObj.eventSeq);
     var invoker = new actionInvoker(accOrElmOrID, actionIndex, actionName,
                                     eventSeq);
     gActionsQueue.push(invoker);
   }
   gActionsQueue.invoke();
 }
 /**
  * Test action names and descriptions.
  */
 function testActionNames(aID, aActions)
 {
   var actions = (typeof aActions == "string") ?
     [ aActions ] : (aActions || []);
   var acc = getAccessible(aID);
   is(acc.actionCount, actions.length, "Wong number of actions.");
   for (var i = 0; i < actions.length; i++ ) {
     is(acc.getActionName(i), actions[i], "Wrong action name at " + i + " index.");
     is(acc.getActionDescription(0), gActionDescrMap[actions[i]],
        "Wrong action description at " + i + "index.");
   }
 }
 ////////////////////////////////////////////////////////////////////////////////
 // Private
 var gActionsQueue = null;
 function actionInvoker(aAccOrElmOrId, aActionIndex, aActionName, aEventSeq)
 {
   this.invoke = function actionInvoker_invoke()
   {
     var acc = getAccessible(aAccOrElmOrId);
     if (!acc)
       return INVOKER_ACTION_FAILED;
     var isThereActions = acc.actionCount > 0;
     ok(isThereActions,
        "No actions on the accessible for " + prettyName(aAccOrElmOrId));
     if (!isThereActions)
       return INVOKER_ACTION_FAILED;
     is(acc.getActionName(aActionIndex), aActionName,
        "Wrong action name of the accessible for " + prettyName(aAccOrElmOrId));
     try {
       acc.doAction(aActionIndex);
     }
     catch (e){
       ok(false, "doAction(" + aActionIndex + ") failed with: " + e.name);
       return INVOKER_ACTION_FAILED;
     }
   }
   this.eventSeq = aEventSeq;
   this.getID = function actionInvoker_getID()
   {
     return "invoke an action " + aActionName + " at index " + aActionIndex +
       " on " + prettyName(aAccOrElmOrId);
   }
 }
 function checkerOfActionInvoker(aType, aTarget, aActionObj)
 {
   this.type = aType;
   this.target = aTarget;
   this.phase = false;
   this.getID = function getID()
   {
     return aType + " event handling";
   }
   this.check = function check(aEvent)
   {
     if (aActionObj && "checkOnClickEvent" in aActionObj)
       aActionObj.checkOnClickEvent(aEvent);
   }
 }
 var gActionDescrMap =
 {
   jump: "Jump",
   press: "Press",
   check: "Check",
   uncheck: "Uncheck",
   select: "Select",
   open: "Open",
   close: "Close",
   switch: "Switch",
   click: "Click",
   collapse: "Collapse",
   expand: "Expand",
   activate: "Activate",
   cycle: "Cycle"
 };