Browser compatibility

  • Revision slug: Persona/Browser_compatibility
  • Revision title: Browser compatibility
  • Revision id: 331247
  • Created:
  • Creator: wbamberg
  • Is current revision? No
  • Comment

Revision Content

Supported Browsers

Persona is developed, tested, and supported with the following browsers. Thanks to Persona's cross-platform JavaScript library, users do not need add-ons in order to use Persona.

Desktop Browsers
Internet Explorer 8.0*, 9.0 (but see Compatibility Mode below)
Firefox Current Stable, Beta, Aurora, Nightly, and Extended Support Releases
Previous Stable Release
Chrome Latest Stable Release
Safari Latest Stable Release
Opera Latest Stable Release
iOS Browsers
Mobile Safari iOS 5.x — 6.x
Android Browsers
Default Browser 2.2 — 4.x
Firefox Current Stable, Beta, Aurora, and Nightly Releases
Previous Stable Release
Chrome Latest Stable Release

*: For Windows XP. : For Windows Vista and Windows 7. : As time allows.

Unsupported Browsers

  • Internet Explorer versions 6.0 and 7.0 are not supported. Users will be prompted to upgrade their browser. Also see the section below on IE "Compatibility Mode".
  • Google Chrome Frame is not supported and will not function. Support may be added later (Issue #796).
  • Third party browsers on iOS are not supported and will not function. Support may be added later (Issue #1870, Issue #2034).

Internet Explorer "Compatibility Mode"

From version 8.0 onwards Internet Explorer supports a feature called Compatibility Mode, in which the browser may be instructed to emulate a pre-8.0 version when rendering a page. This feature may be controlled in three different ways

  1. as a local setting in the browser
  2. based on the presence and value of the DOCTYPE declaration in the page
  3. as an instruction sent from the site, using the "X-UA-Compatible" header either as an HTTP header or as a <meta> tag in the page. This method overrides the other two.

Because versions of Internet Explorer earlier than 8.0 are not supported by Persona, any version of Internet Explorer which is configured to emulate a pre-8.0 version will also not function with Persona. This is typically for one of the following reasons:

  • your site is using "X-UA-Compatible" to explicitly instruct the browser to emulate a pre-8.0 version
  • your site's pages omit the DOCTYPE, do not have the DOCTYPE as the first line of the page, or set the browser to quirks mode, and your site is not setting "X-UA-Compatible" to IE version 8.0 or higher
  • the browser is locally configured to use a pre-8.0 Compatibility Mode, and your site is not overriding this by setting "X-UA-Compatible" to IE version 8.0 or higher

For more information, see "Understanding Compatibility Modes in Internet Explorer 8" and "IE8 and IE9 Complications".

Other Browsers

Despite not being explicitly supported, any browser that includes both {{ domxref("window.postMessage()") }} and {{ domxref("Storage", "localStorage") }} should work. These APIs have been available in all major browsers since March 2010.

Known Issues

  • Browsers must accept third party cookies for full functionality (Issue #1352).
  • Android 2.x users without a default browser selected may be unable to log in (Issue #1854).

Revision Source

<h2 id="Supported_Browsers">Supported Browsers</h2>
<p>Persona is developed, tested, and supported with the following browsers. Thanks to Persona's cross-platform JavaScript library, users do not need add-ons in order to use Persona.</p>
<table>
  <tbody>
    <tr>
      <th colspan="3" scope="row" style="text-align: center; background-color: #d3d7cf"><strong>Desktop Browsers</strong></th>
    </tr>
    <tr>
      <th scope="row"><strong>Internet Explorer</strong></th>
      <td colspan="2" rowspan="1" style="background-color: #8ae234">8.0<sup>*</sup>, 9.0<sup>†</sup> (but see <a href="https://developer.mozilla.org/docs/persona/Browser_compatibility#Internet_Explorer_.22Compatibility_Mode.22" title="https://developer.mozilla.org/docs/persona/Browser_compatibility#Internet_Explorer_.22Compatibility_Mode.22">Compatibility Mode</a> below)</td>
    </tr>
    <tr>
      <th scope="row"><strong>Firefox</strong></th>
      <td colspan="2" style="background-color: #8ae234">Current Stable, Beta, Aurora, Nightly, and Extended Support Releases<br />
        Previous Stable Release</td>
    </tr>
    <tr>
      <th scope="row"><strong>Chrome</strong></th>
      <td colspan="2" style="background-color: #8ae234">Latest Stable Release</td>
    </tr>
    <tr>
      <th scope="row"><strong>Safari</strong></th>
      <td colspan="2" style="background-color: #8ae234">Latest Stable Release</td>
    </tr>
    <tr>
      <th scope="row"><strong>Opera</strong></th>
      <td colspan="2" style="background-color: #8ae234">Latest Stable Release<sup>‡</sup></td>
    </tr>
    <tr>
      <th colspan="3" scope="row" style="text-align: center; background-color: #d3d7cf"><strong>iOS Browsers</strong></th>
    </tr>
    <tr>
      <th scope="row"><strong>Mobile Safari</strong></th>
      <td colspan="2" rowspan="1" style="background-color: #8ae234">iOS 5.x — 6.x</td>
    </tr>
    <tr>
      <th colspan="3" scope="row" style="text-align: center; background-color: #d3d7cf"><strong>Android Browsers</strong></th>
    </tr>
    <tr>
      <th scope="row"><strong>Default Browser</strong></th>
      <td colspan="2" rowspan="1" style="background-color: #8ae234">2.2 — 4.x</td>
    </tr>
    <tr>
      <th scope="row"><strong>Firefox</strong></th>
      <td colspan="2" style="background-color: #8ae234">Current Stable, Beta, Aurora, and Nightly Releases<br />
        Previous Stable Release</td>
    </tr>
    <tr>
      <th scope="row"><strong>Chrome</strong></th>
      <td colspan="2" style="background-color: #8ae234">Latest Stable Release</td>
    </tr>
  </tbody>
</table>
<p><sup>*</sup>: For Windows XP. <sup>†</sup>: For Windows Vista and Windows 7. <sup>‡</sup>: As time allows.</p>
<h2 id="Unsupported_Browsers">Unsupported Browsers</h2>
<ul>
  <li>Internet Explorer versions 6.0 and 7.0 are not supported. Users will be prompted to upgrade their browser. Also see the section below on <a href="https://developer.mozilla.org/docs/persona/Browser_compatibility#Internet_Explorer_.22Compatibility_Mode.22" title="https://developer.mozilla.org/docs/persona/Browser_compatibility#Internet_Explorer_.22Compatibility_Mode.22">IE "Compatibility Mode"</a>.</li>
  <li>Google Chrome Frame is not supported and will not function. Support may be added later (<a href="https://github.com/mozilla/browserid/issues/796" title="https://github.com/mozilla/browserid/issues/796">Issue #796</a>).</li>
  <li>Third party browsers on iOS are not supported and will not function. Support may be added later (<a href="https://github.com/mozilla/browserid/issues/1870" title="https://github.com/mozilla/browserid/issues/1870">Issue #1870</a>, <a href="https://github.com/mozilla/browserid/issues/2034" title="https://github.com/mozilla/browserid/issues/2034">Issue #2034</a>).</li>
</ul>
<h2 id="Internet_Explorer_.22Compatibility_Mode.22">Internet Explorer "Compatibility Mode"</h2>
<p>From version 8.0 onwards Internet Explorer supports a feature called Compatibility Mode, in which the browser may be instructed to emulate a pre-8.0 version when rendering a page. This feature may be controlled in three different ways</p>
<ol>
  <li>as a local setting in the browser</li>
  <li>based on the presence and value of the <a href="https://developer.mozilla.org/docs/Quirks_Mode_and_Standards_Mode" title="https://developer.mozilla.org/docs/Quirks_Mode_and_Standards_Mode">DOCTYPE</a> declaration in the page</li>
  <li>as an instruction sent from the site, using the <a href="http://msdn.microsoft.com/library/cc288325%28v=vs.85%29.aspx" title="http://msdn.microsoft.com/library/cc288325%28v=vs.85%29.aspx">"X-UA-Compatible"</a> header either as an HTTP header or as a <a href="https://developer.mozilla.org/docs/HTML/Element/meta" title="https://developer.mozilla.org/docs/HTML/Element/meta"><code>&lt;meta&gt;</code></a> tag in the page. This method overrides the other two.</li>
</ol>
<p>Because versions of Internet Explorer earlier than 8.0 are not supported by Persona, any version of Internet Explorer which is configured to emulate a pre-8.0 version will also not function with Persona. This is typically for one of the following reasons:</p>
<ul>
  <li>your site is using "X-UA-Compatible" to explicitly instruct the browser to emulate a pre-8.0 version</li>
  <li>your site's pages omit the DOCTYPE, do not have the DOCTYPE as the first line of the page, or set the browser to quirks mode, and your site is not setting "X-UA-Compatible" to IE version 8.0 or higher</li>
  <li>the browser is locally configured to use a pre-8.0 Compatibility Mode, and your site is not overriding this by setting "X-UA-Compatible" to IE version 8.0 or higher</li>
</ul>
<p>For more information, see <a href="https://blogs.msdn.com/b/askie/archive/2009/03/23/understanding-compatibility-modes-in-internet-explorer-8.aspx?Redirected=true" title="https://blogs.msdn.com/b/askie/archive/2009/03/23/understanding-compatibility-modes-in-internet-explorer-8.aspx?Redirected=true">"Understanding Compatibility Modes in Internet Explorer 8"</a> and <a href="http://hsivonen.iki.fi/doctype/index.html#ie8" title="http://hsivonen.iki.fi/doctype/index.html#ie8">"IE8 and IE9 Complications"</a>.</p>
<h2 id="Other_Browsers">Other Browsers</h2>
<p>Despite not being explicitly supported, any browser that includes both {{ domxref("window.postMessage()") }} and {{ domxref("Storage", "localStorage") }} should work. These APIs have been available in all major browsers since March 2010.</p>
<h2 id="Known_Issues">Known Issues</h2>
<ul>
  <li>Browsers must accept third party cookies for full functionality (<a href="https://github.com/mozilla/browserid/issues/1352" title="https://github.com/mozilla/browserid/issues/1352">Issue #1352</a>).</li>
  <li>Android 2.x users without a default browser selected may be unable to log in (<a href="https://github.com/mozilla/browserid/issues/1854" title="https://github.com/mozilla/browserid/issues/1854">Issue #1854</a>).</li>
</ul>
Revert to this revision