gears_init.js

   1 // Copyright 2007, Google Inc.
   2 //
   3 // Redistribution and use in source and binary forms, with or without
   4 // modification, are permitted provided that the following conditions are met:
   5 //
   6 //  1. Redistributions of source code must retain the above copyright notice,
   7 //     this list of conditions and the following disclaimer.
   8 //  2. Redistributions in binary form must reproduce the above copyright notice,
   9 //     this list of conditions and the following disclaimer in the documentation
  10 //     and/or other materials provided with the distribution.
  11 //  3. Neither the name of Google Inc. nor the names of its contributors may be
  12 //     used to endorse or promote products derived from this software without
  13 //     specific prior written permission.
  14 //
  15 // THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
  16 // WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  17 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
  18 // EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  19 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  20 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  21 // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  22 // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  23 // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
  24 // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25 //
  26 // Sets up google.gears.*, which is *the only* supported way to access Gears.
  27 //
  28 // Circumvent this file at your own risk!
  29 //
  30 // In the future, Gears may automatically define google.gears.* without this
  31 // file. Gears may use these objects to transparently fix bugs and compatibility
  32 // issues. Applications that use the code below will continue to work seamlessly
  33 // when that happens.
  34
  35 (function() {
  36   // We are already defined. Hooray!
  37   if (window.google && google.gears) {
  38     return;
  39   }
  40
  41   var factory = null;
  42
  43   // Firefox
  44   if (typeof GearsFactory != 'undefined') {
  45     factory = new GearsFactory();
  46   } else {
  47     // IE
  48     try {
  49       factory = new ActiveXObject('Gears.Factory');
  50       // privateSetGlobalObject is only required and supported on WinCE.
  51       if (factory.getBuildInfo().indexOf('ie_mobile') != -1) {
  52         factory.privateSetGlobalObject(this);
  53       }
  54     } catch (e) {
  55       // Safari
  56       if ((typeof navigator.mimeTypes != 'undefined')
  57            && navigator.mimeTypes["application/x-googlegears"]) {
  58         factory = document.createElement("object");
  59         factory.style.display = "none";
  60         factory.width = 0;
  61         factory.height = 0;
  62         factory.type = "application/x-googlegears";
  63         document.documentElement.appendChild(factory);
  64       }
  65     }
  66   }
  67
  68   // *Do not* define any objects if Gears is not installed. This mimics the
  69   // behavior of Gears defining the objects in the future.
  70   if (!factory) {
  71     return;
  72   }
  73
  74   // Now set up the objects, being careful not to overwrite anything.
  75   //
  76   // Note: In Internet Explorer for Windows Mobile, you can't add properties to
  77   // the window object. However, global objects are automatically added as
  78   // properties of the window object in all browsers.
  79   if (!window.google) {
  80     google = {};
  81   }
  82
  83   if (!google.gears) {
  84     google.gears = {factory: factory};
  85   }
  86 })();
  87