Initial version of an experimental Extensions Context Menu API....

chrome/renderer/resources/extension_process_bindings.js

 // Copyright (c) 2010 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // This script contains privileged chrome extension related javascript APIs.
 // It is loaded by pages whose URL has the chrome-extension protocol.
 
 var chrome = chrome || {};
 (function() {
   native function GetExtensionAPIDefinition();
@@ skipping 62 matching lines @@
       } else {
         if (!error) {
           error = "Unknown error."
         }
         console.error("Error during " + name + ": " + error);
         chrome.extension.lastError = {
           "message": error
         };
       }
 
+      if (request.customCallback)

[rafaelw, 2010/03/22 22:27:21]

need curly braces

+        request.customCallback(name, request, response);
+
       if (request.callback) {
         // Callbacks currently only support one callback argument.
         var callbackArgs = response ? [JSON.parse(response)] : [];
 
         // Validate callback in debug only -- and only when the
         // caller has provided a callback. Implementations of api
         // calls my not return data if they observe the caller
         // has not provided a callback.
         if (chromeHidden.validateCallbacks && !error) {
           try {
@@ skipping 65 matching lines @@
       request.args = [];
       for (var k = 0; k < argCount; k++) {
         request.args[k] = args[k];
       }
     }
 
     return request;
   }
 
   // Send an API request and optionally register a callback.
-  function sendRequest(functionName, args, argSchemas) {
+  function sendRequest(functionName, args, argSchemas, customCallback) {
     var request = prepareRequest(args, argSchemas);
+    if (customCallback) {
+      request.customCallback = customCallback;
+    }
     // JSON.stringify doesn't support a root object which is undefined.
     if (request.args === undefined)
       request.args = null;
 
     // Some javascript libraries (e.g. prototype.js version <= 1.6) add a toJSON
     // serializer function on Array.prototype that is incompatible with our
     // native JSON library, causing incorrect deserialization in the C++ side of
     // StartRequest. We work around that here by temporarily removing the toJSON
     // function.
     var arrayToJsonTmp;
     if (Array.prototype.toJSON) {
       arrayToJsonTmp = Array.prototype.toJSON;
       Array.prototype.toJSON = null;
     }
     var sargs = JSON.stringify(request.args);
     if (arrayToJsonTmp) {
       Array.prototype.toJSON = arrayToJsonTmp;
     }
     var requestId = GetNextRequestId();
     requests[requestId] = request;
-    return StartRequest(functionName, sargs, requestId,
-                        request.callback ? true : false);
+    var hasCallback = (request.callback || customCallback) ? true : false;
+    return StartRequest(functionName, sargs, requestId, hasCallback);
   }
 
   // Send a special API request that is not JSON stringifiable, and optionally
   // register a callback.
   function sendCustomRequest(nativeFunction, functionName, args, argSchemas) {
     var request = prepareRequest(args, argSchemas);
     var requestId = GetNextRequestId();
     requests[requestId] = request;
     return nativeFunction(functionName, request.args, requestId,
                           request.callback ? true : false);
@@ skipping 80 matching lines @@
     chrome.toolstrip.onCollapsed =
         new chrome.Event("toolstrip.onCollapsed." + renderViewId);
   }
 
   function setupPopupEvents(renderViewId) {
     chrome.experimental.popup = chrome.experimental.popup || {};
     chrome.experimental.popup.onClosed =
       new chrome.Event("experimental.popup.onClosed." + renderViewId);
   }
 
+  function setupHiddenContextMenuEvent(extensionId) {
+    var eventName = "contextMenu/" + extensionId;
+    chromeHidden.contextMenuEvent = new chrome.Event(eventName);
+    chromeHidden.contextMenuHandlers = {};
+    chromeHidden.contextMenuEvent.addListener(function() {
+      var menuItemId = arguments[0].menuItemId;
+      var onclick = chromeHidden.contextMenuHandlers[menuItemId];
+      if (onclick)

[rafaelw, 2010/03/22 22:27:21]

need curly braces

+        onclick.apply(onclick, arguments);
+
+      var parentMenuItemId = arguments[0].parentMenuItemId;
+      var parentOnclick = chromeHidden.contextMenuHandlers[parentMenuItemId];
+      if (parentOnclick)

[rafaelw, 2010/03/22 22:27:21]

need curly braces

+        parentOnclick.apply(parentOnclick, arguments);
+    });
+  }
+
   chromeHidden.onLoad.addListener(function (extensionId) {
     chrome.initExtension(extensionId, false);
 
     // |apiFunctions| is a hash of name -> object that stores the
     // name & definition of the apiFunction. Custom handling of api functions
     // is implemented by adding a "handleRequest" function to the object.
     var apiFunctions = {};
 
     // Read api definitions and setup api functions in the chrome namespace.
     // TODO(rafaelw): Consider defining a json schema for an api definition
@@ skipping 32 matching lines @@
           apiFunctions[apiFunction.name] = apiFunction;
 
           module[functionDef.name] = bind(apiFunction, function() {
             chromeHidden.validate(arguments, this.definition.parameters);
 
             var retval;
             if (this.handleRequest) {
               retval = this.handleRequest.apply(this, arguments);
             } else {
               retval = sendRequest(this.name, arguments,
-                                   this.definition.parameters);
+                                   this.definition.parameters,
+                                   this.customCallback);
             }
 
             // Validate return value if defined - only in debug.
             if (chromeHidden.validateCallbacks &&
                 chromeHidden.validate &&
                 this.definition.returns) {
               chromeHidden.validate([retval], [this.definition.returns]);
             }
             return retval;
           });
@@ skipping 187 matching lines @@
     apiFunctions["browserAction.setIcon"].handleRequest = function(details) {
       setIconCommon(
           details, this.name, this.definition.parameters, "browser action");
     };
 
     apiFunctions["pageAction.setIcon"].handleRequest = function(details) {
       setIconCommon(
           details, this.name, this.definition.parameters, "page action");
     };
 
+    apiFunctions["experimental.contextMenu.create"].customCallback =
+        function(name, request, response) {
+      if (chrome.extension.lastError || !response)

[rafaelw, 2010/03/22 22:27:21]

need curly braces

+        return;
+
+      // Set up the onclick handler if we were passed one in the request.
+      if (request.args.onclick) {
+        var menuItemId = JSON.parse(response);
+        chromeHidden.contextMenuHandlers[menuItemId] = request.args.onclick;
+      }
+    };
+
+    apiFunctions["experimental.contextMenu.remove"].customCallback =
+        function(name, request, response) {
+      // Remove any onclick handler we had registered for this menu item.
+      if (request.args.length > 0) {
+        var menuItemId = request.args[0];
+        if (chromeHidden.contextMenuHandlers[menuItemId])

[rafaelw, 2010/03/22 22:27:21]

don't need the test here. you can just delete. (otherwise would need curly
braces =-)

+          delete chromeHidden.contextMenuHandlers[menuItemId];
+      }
+    }
+
     if (chrome.test) {
       chrome.test.getApiDefinitions = GetExtensionAPIDefinition;
     }
 
     setupBrowserActionEvent(extensionId);
     setupPageActionEvents(extensionId);
     setupToolstripEvents(GetRenderViewId());
     setupPopupEvents(GetRenderViewId());
+    setupHiddenContextMenuEvent(extensionId);
   });
 
   if (!chrome.experimental)
     chrome.experimental = {};
 
   if (!chrome.experimental.accessibility)
     chrome.experimental.accessibility = {};
 
   if (!chrome.experimental.history)
     chrome.experimental.history = {};
 
   chrome.experimental.history.transitionType = {
     LINK: 0,
     TYPED: 1,
     AUTO_BOOKMARK: 2,
     AUTO_SUBFRAME: 3,
     MANUAL_SUBFRAME: 4,
     GENERATED: 5,
     START_PAGE: 6,
     FORM_SUBMIT: 7,
     RELOAD: 8,
     KEYWORD: 9,
     KEYWORD_GENERATED: 10
   };
 })();