Add chrome.extension to extension_api.json and docs

chrome/renderer/resources/extension_process_bindings.js

 // Copyright (c) 2009 The chrome Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // -----------------------------------------------------------------------------
 // NOTE: If you change this file you need to touch renderer_resources.grd to
 // have your change take effect.
 // -----------------------------------------------------------------------------
 
 // This script contains privileged chrome extension related javascript APIs.
@@ skipping 132 matching lines @@
     }
   }
 
   function bind(obj, func) {
     return function() {
       return func.apply(obj, arguments);
     };
   }
 
   forEach(apiDefinitions, function(apiDef) {
-    var module = {};
-    chrome[apiDef.namespace] = module;
+    chrome[apiDef.namespace] = chrome[apiDef.namespace] || {};
+    var module = chrome[apiDef.namespace];
     
     // Setup Functions.
     if (apiDef.functions) {
       forEach(apiDef.functions, function(functionDef) {
+        // Module functions may have been defined earlier by hand. Don't clobber
+        // them.
+        if (module[functionDef.name])
+          return;
+
         var apiFunction = {};      
         apiFunction.definition = functionDef;
         apiFunction.name = apiDef.namespace + "." + functionDef.name;;
         apiFunctions[apiFunction.name] = apiFunction;
         
         module[functionDef.name] = bind(apiFunction, function() {
           validate(arguments, this.definition.parameters);
     
           if (this.handleRequest)
             return this.handleRequest.apply(this, arguments);
           else 
             return sendRequest(this.name, arguments,
                 this.definition.parameters);        
         });
       });
     }
     
     // Setup Events
     if (apiDef.events) {
       forEach(apiDef.events, function(eventDef) {
+        // Module events may have been defined earlier by hand. Don't clobber
+        // them.
+        if (module[eventDef.name])
+          return;
+
         var eventName = apiDef.namespace + "." + eventDef.name;
         module[eventDef.name] = new chrome.Event(eventName);
       });
     }
   });
 
   // --- Setup additional api's not currently handled in common/extensions/api
 
   // Page action events send (pageActionId, {tabId, tabUrl}).
   function setupPageActionEvents(extensionId) {
@@ skipping 22 matching lines @@
     chrome.self.onConnect = chrome.extension.onConnect;
 
     setupPageActionEvents(extensionId);
   });
   
   // Self getViews();
   apiFunctions["self.getViews"].handleRequest = function() {
     return GetViews();
   }
 })();