Browse Source

Update README.md in src

Ben Hsieh 8 years ago
parent
commit
0fb4652da8
1 changed files with 24 additions and 6 deletions
  1. 24
    6
      src/README.md

+ 24
- 6
src/README.md View File

1
-# react-native-fetch-blob [![npm version](https://img.shields.io/badge/npm package-0.5.2-brightgreen.svg)](https://badge.fury.io/js/react-native-fetch-blob) ![](https://img.shields.io/badge/PR-Welcome-brightgreen.svg) ![](https://img.shields.io/badge/in progress-0.6.0-yellow.svg)
1
+# react-native-fetch-blob [![npm version](https://img.shields.io/badge/npm package-0.5.3-brightgreen.svg)](https://badge.fury.io/js/react-native-fetch-blob) ![](https://img.shields.io/badge/PR-Welcome-brightgreen.svg) ![](https://img.shields.io/badge/in progress-0.6.0-yellow.svg)
2
 
2
 
3
 A module provides upload, download, and files access API. Supports file stream read/write for process large files.
3
 A module provides upload, download, and files access API. Supports file stream read/write for process large files.
4
 
4
 
5
-**[Please visit our Github for updated document](https://github.com/wkh237/react-native-fetch-blob)**
6
-
7
 **Why do we need this**
5
 **Why do we need this**
8
 
6
 
9
 At this moment, React Native does not support `Blob` object yet, so if you're going to send/receive binary data via `fetch` API, that might not work as you expect. See [[fetch] Does fetch with blob() marshal data across the bridge?](https://github.com/facebook/react-native/issues/854).
7
 At this moment, React Native does not support `Blob` object yet, so if you're going to send/receive binary data via `fetch` API, that might not work as you expect. See [[fetch] Does fetch with blob() marshal data across the bridge?](https://github.com/facebook/react-native/issues/854).
28
  * [File access](#user-content-file-access)
26
  * [File access](#user-content-file-access)
29
  * [File stream](#user-content-file-stream)
27
  * [File stream](#user-content-file-stream)
30
  * [Manage cached files](#user-content-manage-cached-files)
28
  * [Manage cached files](#user-content-manage-cached-files)
29
+ * [Self-Signed SSL Server](#user-content-selfsigned-ssl-server)
31
 * [API](#user-content-api)
30
 * [API](#user-content-api)
32
  * [config](#user-content-configoptionsrnfetchblobconfigfetch)
31
  * [config](#user-content-configoptionsrnfetchblobconfigfetch)
33
  * [fetch](#user-content-fetchmethod-url-headers-bodypromisefetchblobresponse)
32
  * [fetch](#user-content-fetchmethod-url-headers-bodypromisefetchblobresponse)
484
 
483
 
485
 ```
484
 ```
486
 
485
 
486
+#### Self-Signed SSL Server
487
+
488
+By default, react-native-fetch-blob does NOT allow connection to unknown certification provider since it's dangerous. If you're going to connect a server with self-signed certification, add `trusty` to `config`. This function is available for version >= `0.5.3`
489
+
490
+```js
491
+RNFetchBlob.config({
492
+  trusty : true
493
+})
494
+.then('GET', 'https://mysite.com')
495
+.then((resp) => {
496
+  // ...
497
+})
498
+```
499
+
487
 ---
500
 ---
488
 
501
 
489
 ## API
502
 ## API
759
 
772
 
760
 A set of configurations that will be injected into a `fetch` method, with the following properties.
773
 A set of configurations that will be injected into a `fetch` method, with the following properties.
761
 
774
 
775
+#### trusty:boolean
776
+  `0.5.3`
777
+  Set this property to `true` will allow the request create connection with server have self-signed SSL certification. This is not recommended to use in production.
778
+
762
 #### fileCache:boolean
779
 #### fileCache:boolean
763
   Set this property to `true` will makes response data of the `fetch` stored in a temp file, by default the temp file will stored in App's own root folder with file name template `RNFetchBlob_tmp${timestamp}`.
780
   Set this property to `true` will makes response data of the `fetch` stored in a temp file, by default the temp file will stored in App's own root folder with file name template `RNFetchBlob_tmp${timestamp}`.
764
 #### appendExt:string
781
 #### appendExt:string
765
-  Set this propery to change temp file extension that created by `fetch` response data.
782
+  Set this property to change temp file extension that created by `fetch` response data.
766
 #### path:string
783
 #### path:string
767
   When this property has value, `fetch` API will try to store response data in the path ignoring `fileCache` and `appendExt` property.
784
   When this property has value, `fetch` API will try to store response data in the path ignoring `fileCache` and `appendExt` property.
768
 #### addAndroidDownloads:object (Android only)
785
 #### addAndroidDownloads:object (Android only)
815
 
832
 
816
 ### RNFetchBlobSession
833
 ### RNFetchBlobSession
817
 
834
 
818
-A `session` is an object that helps you manage files. It simply main a list of file path and let you use `dispose()`to delete files in this session once and for all.
835
+A `session` is an object that helps you manage files. It simply maintains a list of file path and let you use `dispose()`to delete files in this session once and for all.
819
 
836
 
820
 #### add(path:string):RNFetchBlobSession
837
 #### add(path:string):RNFetchBlobSession
821
   Add a file path to this session.
838
   Add a file path to this session.
830
 
847
 
831
 | Version | |
848
 | Version | |
832
 |---|---|
849
 |---|---|
850
+| 0.5.3 | Add API for access untrusted SSL server |
833
 | 0.5.2 | Fix improper url params bug [#26](https://github.com/wkh237/react-native-fetch-blob/issues/26) and change IOS HTTP implementation from NSURLConnection to NSURLSession |
851
 | 0.5.2 | Fix improper url params bug [#26](https://github.com/wkh237/react-native-fetch-blob/issues/26) and change IOS HTTP implementation from NSURLConnection to NSURLSession |
834
 | 0.5.0 | Upload/download with direct access to file storage, and also added file access APIs |
852
 | 0.5.0 | Upload/download with direct access to file storage, and also added file access APIs |
835
 | 0.4.2 | Supports upload/download progress |
853
 | 0.4.2 | Supports upload/download progress |
849
 
867
 
850
 ### Development
868
 ### Development
851
 
869
 
852
-If you're interested in hacking this module, check our [development guide](https://github.com/wkh237/react-native-fetch-blob/wiki/Development-Guide), there might be some helpful information.
870
+If you're interested in hacking this module, check our [development guide](https://github.com/wkh237/react-native-fetch-blob/wiki/Home), there might be some helpful information.
853
 Please feel free to make a PR or file an issue.
871
 Please feel free to make a PR or file an issue.