docs/source/Browser.html

   1 <!DOCTYPE html><html><head><title>Sencha Documentation Project</title><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../prettify.css" type="text/css"><link rel="stylesheet" href="../prettify_sa.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script></head><body onload="prettyPrint()"><pre class="prettyprint"><pre><span id='Ext-env.Browser'>/**
   2 </span> * @class Ext.env.Browser
   3  * @extends Ext.Base
   4  * Provide useful information about the current browser.
   5  * Should not be manually instantiated unless for unit-testing; access the global instance stored in Ext.browser instead. Example:
   6  * &lt;pre&gt;&lt;code&gt;
   7  * if (Ext.browser.is.IE) {
   8  *      // IE specific code here
   9  * }
  10  *
  11  * if (Ext.browser.is.WebKit) {
  12  *      // WebKit specific code here
  13  * }
  14  *
  15  * console.log(&quot;Version &quot; + Ext.browser.version);
  16  * &lt;/code&gt;&lt;/pre&gt;
  17  *
  18  * For a full list of supported values, refer to: {@link Ext.env.Browser#is}
  19  *
  20  * @borrows Ext.Base.extend
  21  */
  22 Ext.define('Ext.env.Browser', {
  23     statics: {
  24         browserNames: {
  25             ie: 'IE',
  26             firefox: 'Firefox',
  27             safari: 'Safari',
  28             chrome: 'Chrome',
  29             opera: 'Opera',
  30             other: 'Other'
  31         },
  32         engineNames: {
  33             webkit: 'WebKit',
  34             gecko: 'Gecko',
  35             presto: 'Presto',
  36             trident: 'Trident',
  37             other: 'Other'
  38         },
  39         enginePrefixes: {
  40             webkit: 'AppleWebKit/',
  41             gecko: 'Gecko/',
  42             presto: 'Presto/',
  43             trident: 'Trident/'
  44         },
  45         browserPrefixes: {
  46             ie: 'MSIE ',
  47             firefox: 'Firefox/',
  48             chrome: 'Chrome/',
  49             safari: 'Version/',
  50             opera: 'Opera/'
  51         }
  52     },
  53
  54 <span id='Ext-env.Browser-property-isSecure'>    /**
  55 </span>     * True if the page is running over SSL
  56      * @type Boolean
  57      */
  58     isSecure: false,
  59
  60 <span id='Ext-env.Browser-property-isStrict'>    /**
  61 </span>     * True if the document is in strict mode
  62      * @type Boolean
  63      */
  64     isStrict: false,
  65
  66 <span id='Ext-env.Browser-property-is'>    /**
  67 </span>     * A &quot;hybrid&quot; property, can be either accessed as a method call, i.e:
  68      * &lt;pre&gt;&lt;code&gt;
  69      * if (Ext.browser.is('IE')) { ... }
  70      * &lt;/code&gt;&lt;/pre&gt;
  71      *
  72      * or as an object with boolean properties, i.e:
  73      * &lt;pre&gt;&lt;code&gt;
  74      * if (Ext.browser.is.IE) { ... }
  75      * &lt;/code&gt;&lt;/pre&gt;
  76      *
  77      * Versions can be conveniently checked as well. For example:
  78      * &lt;pre&gt;&lt;code&gt;
  79      * if (Ext.browser.is.IE6) { ... } // Equivalent to (Ext.browser.is.IE &amp;&amp; Ext.browser.version.equals(6))
  80      * &lt;/code&gt;&lt;/pre&gt;
  81      *
  82      * Note that only {@link Ext.Version#getMajor major component}  and {@link Ext.Version#getShortVersion shortVersion}
  83      * value of the version are available via direct property checking.
  84      *
  85      * Supported values are: IE, Firefox, Safari, Chrome, Opera, WebKit, Gecko, Presto, Trident and Other
  86      *
  87      * @param {String} value The OS name to check
  88      * @return {Boolean}
  89      */
  90     is: Ext.emptyFn,
  91
  92 <span id='Ext-env.Browser-property-name'>    /**
  93 </span>     * Read-only - the full name of the current browser
  94      * Possible values are: IE, Firefox, Safari, Chrome, Opera and Other
  95      * @type String
  96      */
  97     name: null,
  98
  99 <span id='Ext-env.Browser-property-version'>    /**
 100 </span>     * Read-only, refer to {@link Ext.Version}
 101      * @type Ext.Version
 102      */
 103     version: null,
 104
 105 <span id='Ext-env.Browser-property-engineName'>    /**
 106 </span>     * Read-only - the full name of the current browser's engine
 107      * Possible values are: WebKit, Gecko, Presto, Trident and Other
 108      * @type String
 109      */
 110     engineName: null,
 111
 112 <span id='Ext-env.Browser-property-engineVersion'>    /**
 113 </span>     * Read-only, refer to {@link Ext.Version}
 114      * @type Ext.Version
 115      */
 116     engineVersion: null,
 117
 118     constructor: function() {
 119         var userAgent = this.userAgent = Ext.global.navigator.userAgent,
 120             selfClass = this.statics(),
 121             browserMatch = userAgent.match(new RegExp('((?:' + Ext.Object.getValues(selfClass.browserPrefixes).join(')|(?:') + '))([\\d\\._]+)')),
 122             engineMatch = userAgent.match(new RegExp('((?:' + Ext.Object.getValues(selfClass.enginePrefixes).join(')|(?:') + '))([\\d\\._]+)')),
 123             browserName = selfClass.browserNames.other,
 124             browserVersion = '',
 125             engineName = selfClass.engineNames.other,
 126             engineVersion = '';
 127
 128         this.is = function(name) {
 129             return this.is[name] === true;
 130         };
 131
 132         if (browserMatch) {
 133             browserName = selfClass.browserNames[Ext.Object.getKey(selfClass.browserPrefixes, browserMatch[1])];
 134             browserVersion = browserMatch[2];
 135         }
 136
 137         if (engineMatch) {
 138             engineName = selfClass.engineNames[Ext.Object.getKey(selfClass.enginePrefixes, engineMatch[1])];
 139             engineVersion = engineMatch[2];
 140         }
 141
 142         Ext.apply(this, {
 143             engineName: engineName,
 144             engineVersion: new Ext.Version(engineVersion),
 145             name: browserName,
 146             version: new Ext.Version(browserVersion)
 147         });
 148
 149         this.is[this.name] = true;
 150         this.is[this.name + (this.version.getMajor() || '')] = true;
 151         this.is[this.name + this.version.getShortVersion()] = true;
 152         Ext.Object.each(selfClass.browserNames, function(key, name) {
 153             this.is[name] = (this.name === name);
 154         }, this);
 155
 156         this.is[this.name] = true;
 157         this.is[this.engineName + (this.engineVersion.getMajor() || '')] = true;
 158         this.is[this.engineName + this.engineVersion.getShortVersion()] = true;
 159         Ext.Object.each(selfClass.engineNames, function(key, name) {
 160             this.is[name] = (this.engineName === name);
 161         }, this);
 162
 163
 164         this.isSecure = /^https/i.test(Ext.global.location.protocol);
 165
 166         this.isStrict = Ext.global.document.compatMode === &quot;CSS1Compat&quot;;
 167
 168         return this;
 169     }
 170
 171 }, function() {
 172
 173     Ext.browser = new Ext.env.Browser();
 174
 175 });
 176 </pre></pre></body></html>