Partner Docs › Browser & Device Support Reference

Browser & Device Support

Which environments the BRNDTS Ads SDK supports, what happens in unsupported ones, and how to handle them gracefully in your integration.

Support tiers

The SDK defines a three-tier compatibility matrix. Tier 1 is fully covered by the automated test suite. Tier 2 receives best-effort support. Tier 3 environments are detected at startup - the SDK exits cleanly without touching the video player.

Tier 1
Fully supported
Covered by the automated test suite. Guaranteed before every release.
  • Chrome
  • Edge (Chromium)
  • Firefox + ESR
  • Safari 16+
  • iOS Safari 16+
Automated - tested every release
Tier 2
Best effort
Expected to work given Chromium standards compliance. Not actively tested.
  • Opera (Chromium)
  • Samsung Internet (Chromium)
  • Brave (Chromium)
  • Chrome on ChromeOS
Best-effort - issues investigated
Tier 3
Not supported
Capability gate detects these at startup and exits cleanly. Video player is unaffected.
  • IE 11
  • Legacy EdgeHTML (pre-Chromium)
  • UC Browser
  • Old Android WebViews
  • Smart TVs & non-standard runtimes
Capability gate - exits cleanly

Required browser APIs

The SDK checks for these APIs at startup - before any network call, feature-flag check, or DOM work. If any are missing, ready resolves to false.

API Used for
WebSocket Real-time ad signaling - no polling fallback
ResizeObserver Responsive ad container sizing
HTMLVideoElement Video player integration

When any required API is missing, the SDK logs a warning to the console:

brndts-ads: unsupported environment - missing: ResizeObserver

Handling unsupported browsers

On an unsupported browser, await ads.ready returns false - the same signal as a connection failure. No extra handling needed beyond the standard ready check:

const ads = new BrndtsAds('#player', options); if (!await ads.ready) { // Unsupported browser OR connection failure - ads won't run. // Video player continues to work normally. return; }

What happens on an unsupported browser

  • await ads.ready returns false
  • No exception is thrown
  • No network requests are made
  • The host video player is unaffected

Tested devices

Tier 1 coverage across the most common form factors.

Desktop
Windows
Chrome, Edge, Firefox
Desktop
macOS
Safari 16+, Chrome
Mobile
iPhone
Safari 16+
Mobile
Android
Chrome, Firefox
Tablet
iPad
Safari 16+
Tablet
Android tablet
Chrome