Merge pull request #135 from SimenB/patch-1

Add tips for React Native gotchas.

Author: jaydenseric

changelog.md

@@ -1,5 +1,11 @@
 # apollo-upload-client changelog
 
+## Next
+
+### Patch
+
+- Add tips for React Native gotchas, via [#135](https://github.com/jaydenseric/apollo-upload-client/pull/135).
+
 ## 10.0.0
 
 ### Major

readme.md

@@ -211,13 +211,15 @@ GraphQL request `fetch` options.
 
 A React Native [`File`](https://developer.mozilla.org/docs/web/api/file) substitute.
 
+Be aware that inspecting network requests with Chrome dev tools interferes with the React Native `FormData` implementation, causing network errors.
+
 **Type:** [Object](https://mdn.io/object)
 
-| Property | Type                             | Description        |
-| :------- | :------------------------------- | :----------------- |
-| `uri`    | [String](https://mdn.io/string)  | Filesystem path.   |
-| `name`   | [String](https://mdn.io/string)? | File name.         |
-| `type`   | [String](https://mdn.io/string)? | File content type. |
+| Property | Type                             | Description                                                                                                                                             |
+| :------- | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `uri`    | [String](https://mdn.io/string)  | Filesystem path.                                                                                                                                        |
+| `name`   | [String](https://mdn.io/string)? | File name.                                                                                                                                              |
+| `type`   | [String](https://mdn.io/string)? | File content type. Some environments (particularly Android) require a valid MIME type; Expo `ImageResult.type` is unreliable as it can be just `image`. |
 
 #### See
 

src/index.js

@@ -12,14 +12,17 @@ const { extractFiles, ReactNativeFile } = require('extract-files')
 /**
  * A React Native [`File`](https://developer.mozilla.org/docs/web/api/file)
  * substitute.
+ *
+ * Be aware that inspecting network requests with Chrome dev tools interferes
+ * with the React Native `FormData` implementation, causing network errors.
  * @kind typedef
  * @name ReactNativeFileSubstitute
  * @type {Object}
  * @see [`extract-files` docs](https://github.com/jaydenseric/extract-files#type-reactnativefilesubstitute).
  * @see [React Native `FormData` polyfill source](https://github.com/facebook/react-native/blob/v0.45.1/Libraries/Network/FormData.js#L34).
  * @prop {String} uri Filesystem path.
  * @prop {String} [name] File name.
- * @prop {String} [type] File content type.
+ * @prop {String} [type] File content type. Some environments (particularly Android) require a valid MIME type; Expo `ImageResult.type` is unreliable as it can be just `image`.
  * @example <caption>A camera roll file.</caption>
  * ```js
  * {