Document minimum React Native version supported

[chrisbobbe]

Thanks for this! 🙂 The list of bugs in React Native core's polyfill in the README is quite startling, and I've reproduced facebook/react-native#25717, so far.

---

A file in react-native-url-polyfill, which was added in 1.0.0, the initial release, depends on a file in React Native, which was added in v0.61.0.

On RN v0.59.10, which I'm using, I get this error from Metro:

error: bundling failed: Error: Unable to resolve module `react-native/Libraries/Blob/NativeBlobModule` from `/Users/chrisbobbe/dev/zulip-mobile/node_modules/react-native-url-polyfill/js/URL.js`: Module `react-native/Libraries/Blob/NativeBlobModule` does not exist in the Haste module map

There may be other factors preventing react-native-url-polyfill from working prior to RN v0.61.0, or indeed it might continue to not work until after that (maybe even v0.62?).

It would be nice to have a note, maybe in the install instructions in the README, on what the earliest supported React Native version is, for the latest release of react-native-url-polyfill, and perhaps mention in the notes for each release if that number changes.

Hopefully this data point will help with that. 🙂

[charpeni]

Thanks for this detailed issue, I appreciate the feedback!

I’ll make sure to mention it clearly in the README, but also specifying supported versions of React Native in peerDependencies so we can have a warning on installation too.

What you mentioned regarding upcoming releases is also important to prevent breaking changes. I’ll make sure to keep the tests up-to-date with it.

I didn’t had a lot of time for this recently, but I should be able to find some soon.

Thanks again for filling this!

[chrisbobbe]

Great, thanks so much! Stay safe, with COVID-19, and all.

[charpeni]

I'm currently working on adding support for older version (0.59) and also making sure to test a larger band of React Native versions.

[charpeni]

@chrisbobbe react-native-url-polyfill@1.2.0-rc.0 is now available with backward support for RN 0.60 & 0.59, and probably more!

Let me know how it goes for you so I can release it officially.

[chrisbobbe]

Confirmed that 1.2.0-rc.0 worked for me on react-native v0.59.10 and on react-native v0.60.6! Thank you!