Docs/Browser/Browser.md

   1 Object: Browser {#Browser}
   2 ==========================
   3
   4 Some browser properties are attached to the Browser Object for browser and platform detection.
   5
   6 Browser.Features {#Browser:Browser-Features}
   7 --------------------------------------------
   8
   9 * Browser.Features.xpath - (*boolean*) True if the browser supports DOM queries using XPath.
  10 * Browser.Features.air - (*boolean*)  True if the browser supports AIR.
  11 * Browser.Features.query - (*boolean*) True if the browser supports querySelectorAll.
  12 * Browser.Features.json - (*boolean*) True if the browser has a native JSON object.
  13 * Browser.Features.xhr - (*boolean*) True if the browser supports native XMLHTTP object.
  14
  15 Browser.name {#Browser:Browser-name}
  16 ------------------------------------
  17
  18 'Browser.name' reports the name of the Browser as string, identical to the property names of the following Boolean values:
  19
  20 * Browser.ie - (*boolean*) True if the current browser is Internet Explorer.
  21 * Browser.firefox - (*boolean*) True if the current browser is Firefox.
  22 * Browser.safari - (*boolean*) True if the current browser is Safari.
  23 * Browser.chrome - (*boolean*) True if the current browser is Chrome.
  24 * Browser.opera - (*boolean*) True if the current browser is Opera.
  25
  26 In addition to one of the above properties a second property consisting of the name and the major version is provided ('Browser.ie6', 'Browser.chrome15', ...).
  27
  28 If 'Browser.chrome' is True, all other possible properties, like 'Browser.firefox', 'Browser.ie', ... , will be `undefined`.
  29
  30 ### Example:
  31
  32         alert(Browser.name); // Alerts "ie" in Internet Explorer, "firefox" in Mozilla Firefox, "chrome" in Google Chrome, "safari" or "opera".
  33
  34         if (Browser.ie){
  35                 // This code will only run in IE
  36         }
  37
  38         if (Browser.firefox2){
  39                 // This code will only run in Firefox 2
  40         }
  41
  42         if (Browser.ie6 || Browser.ie7){
  43                 // Please upgrade your browser
  44         }
  45
  46 If an IE document is set to backwards compatibility mode using the X-UA-Compatible header, then the Browser object is treated as if the earlier version of the browser is running.
  47
  48 Browser.version {#Browser:Browser-version}
  49 ------------------------------------------
  50
  51 'Browser.version' reports the version of the Browser as number.
  52
  53 ### Example:
  54
  55         alert(Browser.version); // Alerts '3.6' in FireFox 3.6.13
  56
  57 Browser.Platform {#Browser:Browser-Platform}
  58 --------------------------------------------
  59
  60 * Browser.Platform.mac - (*boolean*) True if the platform is Mac.
  61 * Browser.Platform.win - (*boolean*) True if the platform is Windows.
  62 * Browser.Platform.linux - (*boolean*) True if the platform is Linux.
  63 * Browser.Platform.ios - (*boolean*) True if the platform is iOS.
  64 * Browser.Platform.android - (*boolean*) True if the platform is Android
  65 * Browser.Platform.webos - (*boolean*) True if the platform is WebOS
  66 * Browser.Platform.other - (*boolean*) True if the platform is neither Mac, Windows, Linux, Android, WebOS nor iOS.
  67 * Browser.Platform.name - (*string*) The name of the platform.
  68
  69 Browser.Plugins {#Browser:Browser-Plugins}
  70 ------------------------------------------
  71
  72 * Browser.Plugins.Flash - (*object*) - An object with properties corresponding to the `version` and `build` number of the installed Flash plugin. Note: if flash is not installed, both `Browser.Plugins.Flash.version` and `Browser.Plugins.Flash.build` will return zero.
  73 * Browser.Plugins.Flash.version - (*number*) The major version of the flash plugin installed.
  74 * Browser.Plugins.Flash.build - (*number*) The build version of the flash plugin installed.
  75
  76 Browser.Request {#Browser:Browser-Request}
  77 ------------------------------------------
  78
  79 * Browser.Request - (*object*) The XMLHTTP object or equivalent.
  80
  81 Browser.exec {#Browser:Browser-exec}
  82 ------------------------------------
  83
  84 Executes the passed in string in the browser context.
  85
  86 ### Example:
  87
  88         Browser.exec('alert("Moo!");');
  89
  90 Deprecated {#Deprecated}
  91 ------------------------
  92
  93 The *Browser.Engine* object is deprecated since MooTools 1.3.
  94
  95 ### Engine:
  96
  97 * Browser.Engine.trident - (*boolean*) True if the current browser uses the trident engine (e.g. Internet Explorer).
  98 * Browser.Engine.gecko - (*boolean*) True if the current browser uses the gecko engine (e.g. Firefox, or any Mozilla Browser).
  99 * Browser.Engine.webkit - (*boolean*) True if the current browser uses the webkit engine (e.g. Safari, Google Chrome, Konqueror).
 100 * Browser.Engine.presto - (*boolean*) True if the current browser uses the presto engine (e.g. Opera 9).
 101 * Browser.Engine.name - (*string*) The name of the engine.
 102 * Browser.Engine.version - (*number*) The version of the engine. (e.g. 950)