Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

expo-web-browser

expo2mMIT14.0.2TypeScript support: included

Provides access to the system's web browser and supports handling redirects. On iOS, it uses SFSafariViewController or ASWebAuthenticationSession, depending on the method you call, and on Android it uses ChromeCustomTabs. As of iOS 11, SFSafariViewControl

react-native, expo, expo-web-browser, web, browser

readme

changelog

Changelog

Unpublished

🛠 Breaking changes

🎉 New features

🐛 Bug fixes

💡 Others

14.0.2 — 2025-01-10

This version does not introduce any user-facing changes.

14.0.1 — 2024-11-14

This version does not introduce any user-facing changes.

14.0.0 — 2024-10-22

🛠 Breaking changes

🎉 New features

  • [iOS] dismissBrowser function updated to return a promise. (#31210 by @nishan)

🐛 Bug fixes

  • Add missing react-native peer dependencies for isolated modules. (#30490 by @byCedric)

💡 Others

13.0.3 — 2024-04-29

🐛 Bug fixes

  • On iOS, fix an issue where rapidly opening and closing the browser would leave the module in a bad state, preventing opening the browser again. (#28452 by @alanjhughes)

13.0.2 — 2024-04-24

This version does not introduce any user-facing changes.

13.0.1 — 2024-04-23

This version does not introduce any user-facing changes.

13.0.0 — 2024-04-18

💡 Others

  • drop unused web name property. (#27437 by @EvanBacon)
  • Update error message to reflect that web crypto works on web with a localhost hostname and often doesn't require https. (#26729 by @EvanBacon)
  • Remove compare-urls and url dependencies in favor of built-in URL support. (#26702 by @EvanBacon)
  • Removed deprecated backward compatible Gradle settings. (#28083 by @kudo)

12.8.2 - 2024-01-24

💡 Others

12.8.1 - 2023-12-19

This version does not introduce any user-facing changes.

12.8.0 — 2023-11-14

🛠 Breaking changes

12.7.0 — 2023-10-17

🛠 Breaking changes

12.6.0 — 2023-09-15

This version does not introduce any user-facing changes.

12.5.0 — 2023-09-04

🎉 New features

  • Added support for React Native 0.73. (#24018 by @kudo)

12.4.1 — 2023-08-02

This version does not introduce any user-facing changes.

12.4.0 — 2023-07-28

This version does not introduce any user-facing changes.

12.3.2 — 2023-06-28

This version does not introduce any user-facing changes.

12.3.1 — 2023-06-27

🐛 Bug fixes

  • On iOS, fixed crash when opening an invalid URL in the web browser. (#22986 by @hirbod)

12.3.0 — 2023-06-21

📚 3rd party library updates

🐛 Bug fixes

  • On iOS fix browser session being kept alive after view controller is dismissed. (#22415 by @alanjhughes)
  • Fixed Android build warnings for Gradle version 8. (#22537, #22609 by @kudo)

12.2.0 — 2023-05-08

This version does not introduce any user-facing changes.

12.1.1 — 2023-02-09

This version does not introduce any user-facing changes.

12.1.0 — 2023-02-03

🐛 Bug fixes

💡 Others

  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)

12.0.0 — 2022-10-25

🛠 Breaking changes

  • Bumped iOS deployment target to 13.0 and deprecated support for iOS 12. (#18873 by @tsapeta)

🎉 New features

  • Support CSS colors in controlsColor, toolbarColor and secondaryToolbarColor options. (#18586 by @janicduplessis)

💡 Others

11.0.0 — 2022-07-07

🎉 New features

  • Native module on Android is now written in Kotlin using the new API. (#17454 by @barthap)

🐛 Bug fixes

  • Fixed removeListener(): Method has been deprecated warning. (#17645 by @barthap)
  • Fixed service not registered exception on Android. (#17855 by @lukmccall)
  • Fixed redirectUrl auth session argument to be optional and thus match documentation. (#17953 by @barthap)
  • Fixed windowFeatures property not being properly recognized on web. (#18106 by @barthap)

💡 Others

  • Migrated Expo modules definitions to the new naming convention. (#17193 by @tsapeta)
  • Rewritten Android code to Kotlin. (#17195 by @barthap)

10.2.1 — 2022-05-24

🐛 Bug fixes

10.2.0 — 2022-04-18

🎉 New features

  • Native module on iOS is now written in Swift using the new API. (#16201 by @tsapeta)
  • Add presentationStyle option to customize browser window appearance on iOS. (#16919 by @barthap)
  • Add preferEphemeralSession option to openAuthSessionAsync to ask for a private auth session on iOS. (#16926 by @barthap)

⚠️ Notices

  • On Android bump compileSdkVersion to 31, targetSdkVersion to 31 and Java version to 11. (#16941 by @bbarthec)

10.1.1 - 2022-02-01

🐛 Bug fixes

  • Fix Plugin with id 'maven' not found build error from Android Gradle 7. (#16080 by @kudo)

10.1.0 — 2021-12-03

This version does not introduce any user-facing changes.

10.0.1 — 2021-10-01

This version does not introduce any user-facing changes.

10.0.0 — 2021-09-28

🛠 Breaking changes

🐛 Bug fixes

  • Fix building errors from use_frameworks! in Podfile. (#14523 by @kudo)

9.3.0 — 2021-09-09

🐛 Bug fixes

  • Fixed openAuthSessionAsync erroneously stating a browser was open when it had failed to open. (#14181 by @sumnerwarren)

💡 Others

  • Migrated from @unimodules/core to expo-modules-core. (#13757 by @tsapeta)

9.2.0 — 2021-06-16

🎉 New features

  • Added createTask (Android) flag for WebBrowser. (#12462 by @Ackuq)
  • Added custom types definitions for argument and result of maybeCompleteAuthSession method. (#13189 by @Simek)

🐛 Bug fixes

9.1.0 — 2021-03-10

🎉 New features

  • Updated Android build configuration to target Android 11 (added support for Android SDK 30). (#11647 by @bbarthec)

🐛 Bug fixes

  • Remove peerDependencies and unimodulePeerDependencies from Expo modules. (#11980 by @brentvatne)

9.0.0 — 2021-01-15

🛠 Breaking changes

🐛 Bug fixes

8.6.0 — 2020-11-17

This version does not introduce any user-facing changes.

8.5.0 — 2020-08-18

🐛 Bug fixes

  • Removed unncecessary Android dependencies. (#9538 by @barthap)
  • Fixed openAuthSessionAsync crashing when cancelled on iOS. (#9722 by @barthap)

8.4.0 — 2020-07-29

🎉 New features

🐛 Bug fixes

  • Fix native Android dependencies used in tests - Kotlin and testing libraries. (#8881 by @mczernek)

8.3.1 — 2020-05-29

This version does not introduce any user-facing changes.

8.3.0 — 2020-05-27

🎉 New features

  • Add readerMode and dismissButtonStyle (iOS) and enableDefaultShare (Android) flags for WebBrowser (#7221 by @LinusU) & @mczernek)

🐛 Bug fixes