Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Browser support: Document jQuery 4.x browser support #194

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 14 additions & 10 deletions pages/browser-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,26 +7,30 @@
### Desktop

* Chrome: (Current - 1) and Current
* Edge: (Current - 1) and Current
* Firefox: (Current - 1) and Current, ESR
* Internet Explorer: 9+
* Edge: (Current - 1) and Current<sup>[1]</sup>, IE mode<sup>[2]</sup>
* Firefox: (Current - 1) and Current, ESR<sup>[3]</sup>
* Internet Explorer: 11<sup>[2]</sup>
* Safari: (Current - 1) and Current
* Opera: Current

### Mobile

* Stock browser on Android 4.0+<sup>[1]</sup>
* Safari on iOS 7+<sup>[1]</sup>

<small>[1]</small>: Workarounds for Android Browser 4.0-4.3, iOS 7 & iOS 10 are present in the code base, but we no longer actively test these versions. iOS 8, iOS 9 as well as iOS 11 & newer versions are tested.
* Chrome on Android: (Current - 1) and Current
* Safari on iOS: (Current - 2), (Current - 1) and Current

Any problem with jQuery in the above browsers should be reported as a bug in jQuery.

<em>(Current - 1) and Current</em> denotes that we support the current stable version of the browser and the version that preceded it. For example, if the current version of a browser is 24.x, we support the 24.x and 23.x versions.
<em>Current</em> denotes that we support the current stable version of the browser, <em>(Current - 1)</em> - that the version that preceded it is supported. For example, if we support <em>(Current - 2), (Current - 1) and Current</em> versions of a particular browser &amp; the current version of a browser is 24.x, we support the 24.x, 23.x and 22.x versions.

If you need to support Edge Legacy, Internet Explorer 9-10, iOS 7+ (and not just 3 latest versions) or Android Browser in Android 4.0+, use [jQuery 3.x](https://code.jquery.com/jquery/#jquery-all-3.x).

If, additionally, you need to support Internet Explorer 6-8, Opera 12.1x or Safari 5.1+, use [jQuery 1.x](https://releases.jquery.com/jquery/#jquery-all-1.x).

<small>[1]</small> Only the Chromium-based Edge is supported, Edge Legacy & the old EdgeHTML-based version – is not.

Firefox ESR (Extended Support Release) is a Firefox version for use by organizations including schools, universities, businesses and others who need extended support for mass deployments. It is based on a regular release of Firefox and synced from the next regular Firefox every few releases - example ESR versions include Firefox 47, 52 & 60. At any given time there are at most two ESR versions available; jQuery supports both of them. See [the Mozilla site](https://www.mozilla.org/en-US/firefox/organizations/) for more information.
<small>[2]</small> We support both the real Internet Explorer 11 and Edge in IE mode, but only in standards mode and in the IE 11 document mode. [Read more about IE mode in Edge](https://learn.microsoft.com/en-us/deployedge/edge-ie-mode).

If you need to support older browsers like Internet Explorer 6-8, Opera 12.1x or Safari 5.1+, download [jQuery 1.12](https://releases.jquery.com/jquery/#jquery-all-1.x) instead.
<small>[3]</small> Firefox ESR (Extended Support Release) is a Firefox version for use by organizations including schools, universities, businesses and others who need extended support for mass deployments. It is based on a regular release of Firefox and synced from the next regular Firefox every few releases - example ESR versions include Firefox 102, 115 &amp; 128. At any given time there are at most two ESR versions available; jQuery supports all of them. See [the Mozilla site for organizations](https://www.mozilla.org/en-US/firefox/organizations/) for more information.

-----

Expand Down