.. _browser-compatibility:

**********************************
Browser Compatibility
**********************************

Extensive browser support is an important goal for MathJax. 
At the same time, MathJax does require a certain minimum 
level of browser functionality. 

Our extensive `MathJax test suite <https://github.com/mathjax/MathJax-test/>`__ 
tests every MathJax release for regressions on all major 
browsers.

Please comment in the `MathJax User Group
<http://groups.google.com/group/mathjax-users/>`__  or `file issues
on GitHub <https://github.com/mathjax/MathJax/issues>`__ if you
notice inaccuracies or problems.

It usually helps to add screenshots for which we suggest 
services such as 
`browsershots.org <http://browsershots.org>`_, 
`saucelabs.com <http://saucelabs.com>`_, or `browserstack.com 
<http://browserstack.com>`_.


---------------
HTML-CSS Output
---------------

The HTML-CSS Output supports Internet Explorer 6 (and above) as well
as all modern browsers (Firefox 3+, Safari 2+, Chrome 0.2+).


-----------------
CommonHTML Output
-----------------

The CommonHTML Output supports Internet Explorer 8 (and above) as well 
as all modern browsers.


----------
SVG Output
----------

The SVG Output supports Internet Explorer 9 (and above) as well as all 
modern browsers.


--------------
Legacy Results
--------------

The following list describes the browsers that were originally
tested with MathJax's HTML-CSS output.

+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Browser                                                                             | Versions                                | Notes                                                                                                     |
+=====================================================================================+=========================================+===========================================================================================================+
| Internet Explorer                                                                   | 6.0 and later (Windows)                 | In MathJax v2.0+, IE8 and IE9 run faster in their IE8 and IE9 standards mode than in IE7 emulation mode.  |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Firefox                                                                             | 3.0 and later (Windows, MacOS, Linux)   | Firefox 2.0 is not supported. Firefox before 3.5 uses image fonts.                                        |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Chrome                                                                              | 0.3 and later (Windows, MacOS, Linux)   |                                                                                                           |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Safari                                                                              | 2.0 and later (MacOSX, Windows)         |                                                                                                           |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Opera                                                                               | 9.5 and later (Windows, MacOS, Linux)   |                                                                                                           |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| iPad/iPhone/iTouch                                                                  | All iOS versions                        |                                                                                                           |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Android stock browser                                                               | v2.1 and later                          |                                                                                                           |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| BlackBerry                                                                          | OS 6 and later                          |                                                                                                           |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Symbian                                                                             | Supported                               | Tested on Symbian3 emulator.                                                                              |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Konqueror                                                                           | 4.x and later (Linux)                   | Not tested with older versions.                                                                           |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| `Gecko browsers <https://en.wikipedia.org/wiki/List_of_web_browsers#Gecko-based>`_  |                                         | Not systematically tested, but should be like Firefox.                                                    |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
| `WebKit browsers <https://en.wikipedia.org/wiki/List_of_web_browsers#WebKit-based>`_|                                         | Not systematically tested, but should be like Safari.                                                     |
+-------------------------------------------------------------------------------------+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+