Skip to main content
This guide covers browser support, known compatibility issues, and workarounds.

Supported Browsers

Desktop Browsers

Mobile Browsers

Not Supported

  • Internet Explorer (all versions)
  • Opera Mini
  • UC Browser
  • Older browser versions

Required Browser Features

The Fanfare SDK requires these browser features:

Safari-Specific Issues

Intelligent Tracking Prevention (ITP)

Safari’s ITP can affect cookie and storage behavior. Symptoms:
  • Sessions not persisting
  • Unexpected logouts
  • Cross-site tracking issues
Solutions:
  1. Use first-party cookies
  2. Prompt for storage access

Private Browsing Mode

In Safari private browsing, localStorage and sessionStorage may be unavailable. Detection and handling:

WebSocket Limitations

Safari has stricter WebSocket handling. Symptoms:
  • Connection drops after backgrounding
  • Reconnection issues
Solution: The SDK handles this automatically, but you can configure behavior:

Mobile-Specific Issues

Background Tab Throttling

Browsers throttle background tabs to save battery. Impact:
  • Timers may be delayed
  • Real-time updates may pause
  • Position updates may lag
Handling:

iOS Safari Touch Handling

iOS Safari has unique touch event handling. 300ms tap delay workaround:

Keyboard and Viewport

Mobile keyboard can cause layout issues. Solution:

Feature Detection

Use feature detection rather than browser detection.

Show Upgrade Message

Polyfills

Adding Polyfills

For older browsers, add polyfills:

Conditional Loading

Load polyfills only when needed:

Common Issues by Browser

Chrome

Issue: Extensions blocking requests Solution: Test in incognito mode or disable extensions

Firefox

Issue: Enhanced Tracking Protection Solution: Ensure your domain is not on tracking lists Issue: Container tabs isolation Solution: Sessions may not share between containers by design

Safari

Issue: Aggressive caching Solution: Add cache-busting headers

Edge (Legacy)

Issue: Not supported Solution: Redirect to modern Edge or Chrome

Testing Across Browsers

Testing Tools

  • BrowserStack: Cross-browser testing
  • Sauce Labs: Automated browser testing
  • Chrome DevTools: Device emulation
  • Safari Technology Preview: Test upcoming Safari features

Mobile Testing

Performance Considerations

Browser-Specific Optimizations

Memory Management

Getting Help

If you encounter browser-specific issues:
  1. Check browser console for errors
  2. Test in incognito/private mode to rule out extensions
  3. Note exact browser version when reporting issues
  4. Provide reproduction steps if possible

Contact Support

Report browser-specific issues to our support team