extensions/renderer/resources/extension_custom_bindings.js

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // Custom binding for the extension API.
   6
   7 var binding = require('binding').Binding.create('extension');
   8
   9 var messaging = require('messaging');
  10 var runtimeNatives = requireNative('runtime');
  11 var GetExtensionViews = runtimeNatives.GetExtensionViews;
  12 var chrome = requireNative('chrome').GetChrome();
  13
  14 var inIncognitoContext = requireNative('process').InIncognitoContext();
  15 var sendRequestIsDisabled = requireNative('process').IsSendRequestDisabled();
  16 var contextType = requireNative('process').GetContextType();
  17 var manifestVersion = requireNative('process').GetManifestVersion();
  18
  19 // This should match chrome.windows.WINDOW_ID_NONE.
  20 //
  21 // We can't use chrome.windows.WINDOW_ID_NONE directly because the
  22 // chrome.windows API won't exist unless this extension has permission for it;
  23 // which may not be the case.
  24 var WINDOW_ID_NONE = -1;
  25
  26 binding.registerCustomHook(function(bindingsAPI, extensionId) {
  27   var extension = bindingsAPI.compiledApi;
  28   if (manifestVersion < 2) {
  29     chrome.self = extension;
  30     extension.inIncognitoTab = inIncognitoContext;
  31   }
  32   extension.inIncognitoContext = inIncognitoContext;
  33
  34   var apiFunctions = bindingsAPI.apiFunctions;
  35
  36   apiFunctions.setHandleRequest('getViews', function(properties) {
  37     var windowId = WINDOW_ID_NONE;
  38     var type = 'ALL';
  39     if (properties) {
  40       if (properties.type != null) {
  41         type = properties.type;
  42       }
  43       if (properties.windowId != null) {
  44         windowId = properties.windowId;
  45       }
  46     }
  47     return GetExtensionViews(windowId, type);
  48   });
  49
  50   apiFunctions.setHandleRequest('getBackgroundPage', function() {
  51     return GetExtensionViews(-1, 'BACKGROUND')[0] || null;
  52   });
  53
  54   apiFunctions.setHandleRequest('getExtensionTabs', function(windowId) {
  55     if (windowId == null)
  56       windowId = WINDOW_ID_NONE;
  57     return GetExtensionViews(windowId, 'TAB');
  58   });
  59
  60   apiFunctions.setHandleRequest('getURL', function(path) {
  61     path = String(path);
  62     if (!path.length || path[0] != '/')
  63       path = '/' + path;
  64     return 'chrome-extension://' + extensionId + path;
  65   });
  66
  67   // Alias several messaging deprecated APIs to their runtime counterparts.
  68   var mayNeedAlias = [
  69     // Types
  70     'Port',
  71     // Functions
  72     'connect', 'sendMessage', 'connectNative', 'sendNativeMessage',
  73     // Events
  74     'onConnect', 'onConnectExternal', 'onMessage', 'onMessageExternal'
  75   ];
  76   $Array.forEach(mayNeedAlias, function(alias) {
  77     // Checking existence isn't enough since some functions are disabled via
  78     // getters that throw exceptions. Assume that any getter is such a function.
  79     if (chrome.runtime &&
  80         $Object.hasOwnProperty(chrome.runtime, alias) &&
  81         chrome.runtime.__lookupGetter__(alias) === undefined) {
  82       extension[alias] = chrome.runtime[alias];
  83     }
  84   });
  85
  86   apiFunctions.setUpdateArgumentsPreValidate('sendRequest',
  87       $Function.bind(messaging.sendMessageUpdateArguments,
  88                      null, 'sendRequest', false /* hasOptionsArgument */));
  89
  90   apiFunctions.setHandleRequest('sendRequest',
  91                                 function(targetId, request, responseCallback) {
  92     if (sendRequestIsDisabled)
  93       throw new Error(sendRequestIsDisabled);
  94     var port = chrome.runtime.connect(targetId || extensionId,
  95                                       {name: messaging.kRequestChannel});
  96     messaging.sendMessageImpl(port, request, responseCallback);
  97   });
  98
  99   if (sendRequestIsDisabled) {
 100     extension.onRequest.addListener = function() {
 101       throw new Error(sendRequestIsDisabled);
 102     };
 103     if (contextType == 'BLESSED_EXTENSION') {
 104       extension.onRequestExternal.addListener = function() {
 105         throw new Error(sendRequestIsDisabled);
 106       };
 107     }
 108   }
 109 });
 110
 111 exports.binding = binding.generate();