remoting/webapp/crd/js/app_launcher.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 /**
   6  * @fileoverview
   7  * AppLauncher is an interface that allows the client code to launch and close
   8  * the app without knowing the implementation difference between a v1 app and
   9  * a v2 app.
  10  *
  11  * To launch an app:
  12  *   var appLauncher = new remoting.V1AppLauncher();
  13  *   var appId = "";
  14  *   appLauncher.launch({arg1:'someValue'}).then(function(id){
  15  *    appId = id;
  16  *   });
  17  *
  18  * To close an app:
  19  *   appLauncher.close(appId);
  20  */
  21
  22 /** @suppress {duplicate} */
  23 var remoting = remoting || {};
  24
  25 (function() {
  26
  27 'use strict';
  28
  29 /** @interface */
  30 remoting.AppLauncher = function() {};
  31
  32 /**
  33  * @param {Object=} opt_launchArgs
  34  * @return {Promise} The promise will resolve when the app is launched.  It will
  35  * provide the caller with the appId (which is either the id of the hosting tab
  36  * or window). The caller can use the appId to close the app.
  37  */
  38 remoting.AppLauncher.prototype.launch = function(opt_launchArgs) { };
  39
  40 /**
  41  * @param {string} id  The id of the app to close.
  42  * @return {Promise} The promise will resolve when the app is closed.
  43  */
  44 remoting.AppLauncher.prototype.close = function(id) {};
  45
  46 /**
  47  * @constructor
  48  * @implements {remoting.AppLauncher}
  49  */
  50 remoting.V1AppLauncher = function() {};
  51
  52 remoting.V1AppLauncher.prototype.launch = function(opt_launchArgs) {
  53   var url = base.urlJoin('main.html', opt_launchArgs);
  54
  55   return new Promise(function(resolve, reject) {
  56     chrome.tabs.create({ url: url, selected: true }, function(/**Tab*/ tab){
  57       if (!tab) {
  58         reject(new Error(chrome.runtime.lastError.message));
  59       } else {
  60         resolve(String(tab.id));
  61       }
  62     });
  63   });
  64 };
  65
  66 remoting.V1AppLauncher.prototype.close = function(id) {
  67   return new Promise(function(resolve, reject) {
  68     chrome.tabs.get(parseInt(id, 10), function(/** Tab */ tab) {
  69       if (!tab) {
  70         reject(new Error(chrome.runtime.lastError.message));
  71       } else {
  72         chrome.tabs.remove(tab.id, resolve);
  73       }
  74     });
  75   });
  76 };
  77
  78
  79 /**
  80  * @constructor
  81  * @implements {remoting.AppLauncher}
  82  */
  83 remoting.V2AppLauncher = function() {};
  84
  85 var APP_MAIN_URL = 'main.html';
  86
  87 /**
  88  * @param {string} id
  89  */
  90 remoting.V2AppLauncher.prototype.restart = function(id) {
  91   this.close(id).then(function() {
  92     // Not using the launch() method because we want to launch a new window with
  93     // the same id, such that the size and positioning of the original window
  94     // can be preserved.
  95     chrome.app.window.create(APP_MAIN_URL, {'id' : id, 'frame': 'none'});
  96   });
  97 };
  98
  99 remoting.V2AppLauncher.prototype.launch = function(opt_launchArgs) {
 100   var url = base.urlJoin(APP_MAIN_URL, opt_launchArgs);
 101
 102   return new Promise(
 103       /**
 104        * @param {function(*=):void} resolve
 105        * @param {function(*=):void} reject
 106        */
 107       function(resolve, reject) {
 108         var START_FULLSCREEN = 'start-fullscreen';
 109         /** @param {Object} values */
 110         var onValues = function(values) {
 111           /** @type {string} */
 112           var state = values[START_FULLSCREEN] ? 'fullscreen' : 'normal';
 113           chrome.app.window.create(url, {
 114               'width': 800,
 115               'height': 600,
 116               'frame': 'none',
 117               'id': String(getNextWindowId()),
 118               'state': state
 119             },
 120             function(/** chrome.app.window.AppWindow= */ appWindow) {
 121               if (!appWindow) {
 122                 reject(new Error(chrome.runtime.lastError.message));
 123               } else {
 124                 resolve(appWindow.id);
 125               }
 126             });
 127         };
 128         chrome.storage.local.get(START_FULLSCREEN, onValues);
 129       });
 130 };
 131
 132 remoting.V2AppLauncher.prototype.close = function(id) {
 133   return new Promise(
 134       /**
 135        * @param {function(*=):void} resolve
 136        * @param {function(*=):void} reject
 137        */
 138       function(resolve, reject) {
 139         var appWindow = chrome.app.window.get(id);
 140         if (!appWindow) {
 141           return Promise.reject(new Error(chrome.runtime.lastError.message));
 142         }
 143         appWindow.onClosed.addListener(resolve);
 144         appWindow.close();
 145       });
 146 };
 147
 148 /**
 149  * @return {number} The first available window id. Since Chrome remembers
 150  *     properties such as size and position for app windows, it is better
 151  *     to reuse window ids rather than allocating new ones.
 152  */
 153 function getNextWindowId() {
 154   var appWindows = chrome.app.window.getAll();
 155   var result = 1;
 156   for (; result <= appWindows.length; ++result) {
 157     if (!chrome.app.window.get(String(result))) {
 158       break;
 159     }
 160   }
 161   return result;
 162 }
 163
 164 })();