supported browsers update

Author: patriciasantaana

src/content/docs/cloudflare-challenges/reference/supported-browsers.mdx

@@ -5,59 +5,106 @@ sidebar:
   order: 4
 ---
 
-When your application sends a challenge, your visitors either receive a non-interactive or an interactive challenge page.
+import { Details } from "~/components"
 
-Cloudflare Challenges are most compatible with major desktop and mobile browsers and applications. If your visitors are using an up-to-date version of a major browser, they will receive the challenge correctly.
+Cloudflare can challenge your visitors in various ways. They can be challenged by [Challenge Pages](/cloudflare-challenges/challenge-types/challenge-pages/), [Turnstile](/turnstile/), or by [JavaScript Detections (JSD) in Bot Management](/cloudflare-challenges/challenge-types/javascript-detections/). This document lays out the supported browsers across all of these challenge methods. When your website or application presents a challenge, your visitors receive either a non-interactive or an interactive challenge. 
 
-Officially supported browsers include:
+Cloudflare is committed to ensuring our challenges work with as many browsers as possible, but there are limitations that you should be aware of. 
 
-- Google Chrome (desktop and mobile)
-- Firefox
-- Safari (desktop and mobile)
-- Microsoft Edge
+## Overview
 
+Cloudflare challenges are designed to be compatible with any desktop and mobile browser. If your visitors are using an up-to-date version of a browser listed below, they will receive and be able to solve challenges without any issues. The following is a non-exclusive list of browsers supported by Cloudflare challenges. Browsers not listed on this list are supported on a best effort basis. 
 
-:::caution
-Challenges are not supported by Microsoft Internet Explorer. 
-:::
+### Official supported browsers
+
+The following browsers are officially supported and tested.
+
+<Details header="Google Chrome (desktop and mobile)">
+  - Current version and two previous major versions
+  - Chromium-based browsers 
+    - Chromium-based browsers that track the current Chrome stable version
+  
+  :::caution
+  Beta, Dev, Canary, Nightly, or other unreleased builds are not officially supported
+  :::
+</Details>
+
+<Details header="Mozilla Firefox">
+  - Current version and two previous major versions
+  - Extended Support Release (ESR) versions are supported
+</Details>
+
+<Details header="Safari">
+  - Current version and two previous major versions
+  - iOS Safari on current iOS version and two previous major versions
+</Details>
+
+<Details header="Microsoft Edge">
+  - Current version and two previous major versions
+  </Details>
+
+<Details header="Samsung Internet Browser">
+  - Current version and two previous major versions
+</Details>
+
+### Limited browser support
+
+The following browsers and environments have limited support and may experience occasional issues.
+
+- Internet Explorer is no longer supported.
+- Browsers or operating systems that are more than five years old or have not received security updates in over two years.
+- Browsers with data-saving modes enabled.
+- Custom or heavily modified browser engines, webviews, or embedded browsers.
 
 :::note
-Other browsers that are not listed above are supported on a best-effort basis.
+If your visitors encounter issues using these browsers, we recommend upgrading to a more current browser for the best experience.
 :::
 
-If your visitors encounter issues using a major browser besides Internet Explorer, they should upgrade their browser.
+### Unsupported browsers
 
-## Testing
+The following environments are not supported.
 
-Cloudflare runs tests against the following browsers and its latest versions:
+- Command-line tools such as `wget`, `curl`, or others that lack JavaScript execution capabilities required for Cloudflare challenges.
+- Headless browsers like headless Chrome, headless Firefox, PhantomJS, or others. Challenges are specifically designed to identify and block headless browser traffic. Automation tools and scripts that use headless browsers are not supported.
+- Browser automation frameworks such as Selenium, Puppeteer, Playwright, or others that are considered automated traffic and will be blocked by challenges. 
 
-- Chrome on Windows
-- Safari on Mac OS
-- Safari on iOS
-- Microsoft Edge
-- Android browser for Samsung
+## Common issues
 
-Cloudflare runs webview specific tests against the following browsers:
+### Browser extensions
 
-- Flutter
-- Android webview
+Browser extensions can interfere with challenges in several ways.
 
-Cloudflare runs tests to monitor the following browsers every few hours:
+- Ad blockers and content blockers may prevent challenge scripts from loading properly or block communication with Cloudflare's validation servers.
+- Privacy-focused extensions like script blockers, fingerprinting protection, or canvas blockers can interfere with the challenge verification process.
+- VPN or proxy extensions might trigger additional security checks or cause IP address inconsistencies.
+- Browser automation tools are often detected as potential bots and may cause challenge failures.
 
-- Latest versions of Chrome, Microsoft Edge, and Firefox
-- Latest beta versions of Chrome, Microsoft Edge, and Firefox
-- Latest versions of Safari for Mac OS
-- Android browser for Samsung
-- Safari on iOS
+:::note
+If challenges consistently fail, try temporarily disabling extensions and reload the page. 
+:::
 
-## Limitations
+### Device emulation and developer tools
 
-### Browser extensions
+Challenges are designed to distinguish between real human users and automated traffic. When device emulation is enabled (such as through browser developer tools), it can trigger bot detection mechanisms.
+
+- Mobile device emulation in desktop browsers often uses distinctive characteristics that differ from real mobile devices. 
+- Developer tools may modify browser behavior or expose debugging information that changes how challenges operate.
+- Automation frameworks like Selenium, Puppeteer, or Playwright are specifically detected as non-human traffic
+
+:::note
+For developers testing applications, we recommend using real devices rather than emulated environments when possible. 
+
+If you must use emulation, be aware that challenges may be more difficult to pass, and do not reflect the real experience on mobile devices.
+:::
+
+### WebViews and in-app browsers
 
-If you have browser extensions, they might lead to unpassable challenge loops. To fix this issue, disable your extensions and reload the page.
+Challenges may behave differently depending on embedded browser contexts.
 
-Refer to [Challenge solve issues](/cloudflare-challenges/troubleshooting/challenge-solve-issues/) for more troubleshooting information.
+- WebViews in mobile applications may have limited functionality compared to full browsers
+- In-app browsers often have restricted JavaScript capabilities
+- Email client preview windows typically cannot complete interactive challenges
 
-### Mobile device emulation
+## Troubleshooting
 
-Challenges are not supported when device emulation is enabled on a browser, for example, using the browser's developer tools.
+If your visitors consistently experience challenge issues, refer to [Challenge solve issues](/cloudflare-challenges/troubleshooting/challenge-solve-issues/) for additional troubleshooting information.