extensions/renderer/resources/runtime_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 runtime API.
   6
   7 var binding = require('binding').Binding.create('runtime');
   8
   9 var messaging = require('messaging');
  10 var runtimeNatives = requireNative('runtime');
  11 var unloadEvent = require('unload_event');
  12 var process = requireNative('process');
  13 var forEach = require('utils').forEach;
  14
  15 var backgroundPage = window;
  16 var backgroundRequire = require;
  17 var contextType = process.GetContextType();
  18 if (contextType == 'BLESSED_EXTENSION' ||
  19     contextType == 'UNBLESSED_EXTENSION') {
  20   var manifest = runtimeNatives.GetManifest();
  21   if (manifest.app && manifest.app.background) {
  22     // Get the background page if one exists. Otherwise, default to the current
  23     // window.
  24     backgroundPage = runtimeNatives.GetExtensionViews(-1, 'BACKGROUND')[0];
  25     if (backgroundPage) {
  26       var GetModuleSystem = requireNative('v8_context').GetModuleSystem;
  27       backgroundRequire = GetModuleSystem(backgroundPage).require;
  28     } else {
  29       backgroundPage = window;
  30     }
  31   }
  32 }
  33
  34 // For packaged apps, all windows use the bindFileEntryCallback from the
  35 // background page so their FileEntry objects have the background page's context
  36 // as their own.  This allows them to be used from other windows (including the
  37 // background page) after the original window is closed.
  38 if (window == backgroundPage) {
  39   var lastError = require('lastError');
  40   var fileSystemNatives = requireNative('file_system_natives');
  41   var GetIsolatedFileSystem = fileSystemNatives.GetIsolatedFileSystem;
  42   var bindDirectoryEntryCallback = function(functionName, apiFunctions) {
  43     apiFunctions.setCustomCallback(functionName,
  44         function(name, request, callback, response) {
  45       if (callback) {
  46         if (!response) {
  47           callback();
  48           return;
  49         }
  50         var fileSystemId = response.fileSystemId;
  51         var baseName = response.baseName;
  52         var fs = GetIsolatedFileSystem(fileSystemId);
  53
  54         try {
  55           fs.root.getDirectory(baseName, {}, callback, function(fileError) {
  56             lastError.run('runtime.' + functionName,
  57                           'Error getting Entry, code: ' + fileError.code,
  58                           request.stack,
  59                           callback);
  60           });
  61         } catch (e) {
  62           lastError.run('runtime.' + functionName,
  63                         'Error: ' + e.stack,
  64                         request.stack,
  65                         callback);
  66         }
  67       }
  68     });
  69   };
  70 } else {
  71   // Force the runtime API to be loaded in the background page. Using
  72   // backgroundPageModuleSystem.require('runtime') is insufficient as
  73   // requireNative is only allowed while lazily loading an API.
  74   backgroundPage.chrome.runtime;
  75   var bindDirectoryEntryCallback = backgroundRequire(
  76       'runtime').bindDirectoryEntryCallback;
  77 }
  78
  79 binding.registerCustomHook(function(binding, id, contextType) {
  80   var apiFunctions = binding.apiFunctions;
  81   var runtime = binding.compiledApi;
  82
  83   //
  84   // Unprivileged APIs.
  85   //
  86
  87   if (id != '')
  88     runtime.id = id;
  89
  90   apiFunctions.setHandleRequest('getManifest', function() {
  91     return runtimeNatives.GetManifest();
  92   });
  93
  94   apiFunctions.setHandleRequest('getURL', function(path) {
  95     path = String(path);
  96     if (!path.length || path[0] != '/')
  97       path = '/' + path;
  98     return 'chrome-extension://' + id + path;
  99   });
 100
 101   var sendMessageUpdateArguments = messaging.sendMessageUpdateArguments;
 102   apiFunctions.setUpdateArgumentsPreValidate('sendMessage',
 103       $Function.bind(sendMessageUpdateArguments, null, 'sendMessage',
 104                      true /* hasOptionsArgument */));
 105   apiFunctions.setUpdateArgumentsPreValidate('sendNativeMessage',
 106       $Function.bind(sendMessageUpdateArguments, null, 'sendNativeMessage',
 107                      false /* hasOptionsArgument */));
 108
 109   apiFunctions.setHandleRequest('sendMessage',
 110       function(targetId, message, options, responseCallback) {
 111     var connectOptions = {name: messaging.kMessageChannel};
 112     forEach(options, function(k, v) {
 113       connectOptions[k] = v;
 114     });
 115     var port = runtime.connect(targetId || runtime.id, connectOptions);
 116     messaging.sendMessageImpl(port, message, responseCallback);
 117   });
 118
 119   apiFunctions.setHandleRequest('sendNativeMessage',
 120                                 function(targetId, message, responseCallback) {
 121     var port = runtime.connectNative(targetId);
 122     messaging.sendMessageImpl(port, message, responseCallback);
 123   });
 124
 125   apiFunctions.setUpdateArgumentsPreValidate('connect', function() {
 126     // Align missing (optional) function arguments with the arguments that
 127     // schema validation is expecting, e.g.
 128     //   runtime.connect()   -> runtime.connect(null, null)
 129     //   runtime.connect({}) -> runtime.connect(null, {})
 130     var nextArg = 0;
 131
 132     // targetId (first argument) is optional.
 133     var targetId = null;
 134     if (typeof(arguments[nextArg]) == 'string')
 135       targetId = arguments[nextArg++];
 136
 137     // connectInfo (second argument) is optional.
 138     var connectInfo = null;
 139     if (typeof(arguments[nextArg]) == 'object')
 140       connectInfo = arguments[nextArg++];
 141
 142     if (nextArg != arguments.length)
 143       throw new Error('Invalid arguments to connect.');
 144     return [targetId, connectInfo];
 145   });
 146
 147   apiFunctions.setUpdateArgumentsPreValidate('connectNative',
 148                                              function(appName) {
 149     if (typeof(appName) !== 'string') {
 150       throw new Error('Invalid arguments to connectNative.');
 151     }
 152     return [appName];
 153   });
 154
 155   apiFunctions.setHandleRequest('connect', function(targetId, connectInfo) {
 156     // Don't let orphaned content scripts communicate with their extension.
 157     // http://crbug.com/168263
 158     if (unloadEvent.wasDispatched)
 159       throw new Error('Error connecting to extension ' + targetId);
 160
 161     if (!targetId)
 162       targetId = runtime.id;
 163
 164     var name = '';
 165     if (connectInfo && connectInfo.name)
 166       name = connectInfo.name;
 167
 168     var includeTlsChannelId =
 169       !!(connectInfo && connectInfo.includeTlsChannelId);
 170
 171     var portId = runtimeNatives.OpenChannelToExtension(targetId, name,
 172                                                        includeTlsChannelId);
 173     if (portId >= 0)
 174       return messaging.createPort(portId, name);
 175   });
 176
 177   //
 178   // Privileged APIs.
 179   //
 180   if (contextType != 'BLESSED_EXTENSION')
 181     return;
 182
 183   apiFunctions.setHandleRequest('connectNative',
 184                                 function(nativeAppName) {
 185     if (!unloadEvent.wasDispatched) {
 186       var portId = runtimeNatives.OpenChannelToNativeApp(runtime.id,
 187                                                          nativeAppName);
 188       if (portId >= 0)
 189         return messaging.createPort(portId, '');
 190     }
 191     throw new Error('Error connecting to native app: ' + nativeAppName);
 192   });
 193
 194   apiFunctions.setCustomCallback('getBackgroundPage',
 195                                  function(name, request, callback, response) {
 196     if (callback) {
 197       var bg = runtimeNatives.GetExtensionViews(-1, 'BACKGROUND')[0] || null;
 198       callback(bg);
 199     }
 200   });
 201
 202   bindDirectoryEntryCallback('getPackageDirectoryEntry', apiFunctions);
 203 });
 204
 205 exports.bindDirectoryEntryCallback = bindDirectoryEntryCallback;
 206 exports.binding = binding.generate();