2015-07-23 10:55:12 +00:00
|
|
|
/**
|
|
|
|
* Copyright (c) 2015-present, Facebook, Inc.
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* This source code is licensed under the BSD-style license found in the
|
|
|
|
* LICENSE file in the root directory of this source tree. An additional grant
|
|
|
|
* of patent rights can be found in the PATENTS file in the same directory.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
|
|
|
|
#import "RCTURLRequestDelegate.h"
|
|
|
|
#import "RCTURLRequestHandler.h"
|
|
|
|
|
|
|
|
typedef void (^RCTURLRequestCompletionBlock)(NSURLResponse *response, NSData *data, NSError *error);
|
|
|
|
typedef void (^RCTURLRequestCancellationBlock)(void);
|
Add responseType as a concept to RCTNetworking, send binary data as base64
Summary:
In preparation for Blob support (wherein binary XHR and WebSocket responses can be retained as native data blobs on the native side and JS receives a web-like opaque Blob object), this change makes RCTNetworking aware of the responseType that JS requests. A `xhr.responseType` of `''` or `'text'` translates to a native response type of `'text'`. A `xhr.responseType` of `arraybuffer` translates to a native response type of `base64`, as we currently lack an API to transmit TypedArrays directly to JS. This is analogous to how the WebSocket module already works, and it's a lot more versatile and much less brittle than converting a JS *string* back to a TypedArray, which is what's currently going on.
Now that we don't always send text down to JS, JS consumers might still want to get progress updates about a binary download. This is what the `'progress'` event is designed for, so this change also implements that. This change also follows the XHR spec with regards to `xhr.response` and `xhr.responseText`:
- if the response type is `'text'`, `xhr.responseText` can be peeked at by the JS consumer. It will be updated periodically as the download progresses, so long as there's either an `onreadystatechange` or `onprogress` handler on the XHR.
- if the response type is not `'text'`, `xhr.responseText` can't be accessed and `xhr.response` remains `null` until the response is fully received. `'progress'` events containing response details (total bytes, downloaded so far) are dispatched if there's an `onprogress` handler.
Once Blobs are landed, `xhr.responseType` of `'blob'` will correspond to the same native response type, which will cause RCTNetworking to only send a blob ID down to JS, which can then create a `Blob` object from that for consumers.
Closes https://github.com/facebook/react-native/pull/8324
Reviewed By: javache
Differential Revision: D3508822
Pulled By: davidaurelio
fbshipit-source-id: 441b2d4d40265b6036559c3ccb9fa962999fa5df
2016-07-13 11:53:54 +00:00
|
|
|
typedef void (^RCTURLRequestIncrementalDataBlock)(NSData *data, int64_t progress, int64_t total);
|
2015-07-27 20:46:59 +00:00
|
|
|
typedef void (^RCTURLRequestProgressBlock)(int64_t progress, int64_t total);
|
2015-07-23 10:55:12 +00:00
|
|
|
typedef void (^RCTURLRequestResponseBlock)(NSURLResponse *response);
|
|
|
|
|
2016-02-16 20:41:20 +00:00
|
|
|
typedef NS_ENUM(NSInteger, RCTNetworkTaskStatus) {
|
|
|
|
RCTNetworkTaskPending = 0,
|
|
|
|
RCTNetworkTaskInProgress,
|
|
|
|
RCTNetworkTaskFinished,
|
|
|
|
};
|
|
|
|
|
2015-10-19 16:04:54 +00:00
|
|
|
@interface RCTNetworkTask : NSObject <RCTURLRequestDelegate>
|
2015-07-23 10:55:12 +00:00
|
|
|
|
|
|
|
@property (nonatomic, readonly) NSURLRequest *request;
|
|
|
|
@property (nonatomic, readonly) NSNumber *requestID;
|
2015-11-04 15:14:34 +00:00
|
|
|
@property (nonatomic, readonly, weak) id requestToken;
|
2015-07-23 10:55:12 +00:00
|
|
|
@property (nonatomic, readonly) NSURLResponse *response;
|
|
|
|
@property (nonatomic, readonly) RCTURLRequestCompletionBlock completionBlock;
|
|
|
|
|
|
|
|
@property (nonatomic, copy) RCTURLRequestProgressBlock downloadProgressBlock;
|
|
|
|
@property (nonatomic, copy) RCTURLRequestIncrementalDataBlock incrementalDataBlock;
|
|
|
|
@property (nonatomic, copy) RCTURLRequestResponseBlock responseBlock;
|
|
|
|
@property (nonatomic, copy) RCTURLRequestProgressBlock uploadProgressBlock;
|
|
|
|
|
2016-02-16 20:41:20 +00:00
|
|
|
@property (nonatomic, readonly) RCTNetworkTaskStatus status;
|
|
|
|
|
2015-07-23 10:55:12 +00:00
|
|
|
- (instancetype)initWithRequest:(NSURLRequest *)request
|
|
|
|
handler:(id<RCTURLRequestHandler>)handler
|
|
|
|
completionBlock:(RCTURLRequestCompletionBlock)completionBlock NS_DESIGNATED_INITIALIZER;
|
|
|
|
|
2015-10-17 16:33:09 +00:00
|
|
|
- (void)start;
|
2015-07-23 10:55:12 +00:00
|
|
|
- (void)cancel;
|
|
|
|
|
|
|
|
@end
|