feat(background-http): add request timeout option for iOS (#607)

Author: insytes

packages/background-http/README.md

@@ -296,6 +296,7 @@ The request object parameter has the following properties:
 | `method`                                | `string`  | The request method (e.g. `POST`).                                                                                                                                                               |
 | `headers`                               | `object`  | Used to specify additional headers.                                                                                                                                                             |
 | `description`                           | `string`  | Used to help identify the upload task locally - not sent to the remote server.                                                                                                                  |
+| `timeout` | `number` | (`iOS only`) Sets the request timeout in seconds (s). |
 | `utf8`                                  | `boolean` | (`Android-only`, `multipartUpload()-only`) If true, sets the charset for the multipart request to UTF-8. Default is `false`.                                                                                   |
 | `androidNotificationOnProgressTitle`    | `string`  | Use this to set the on progress title shown in the Android notifications center.                                                                                                                |
 | `androidNotificationOnProgressMessage`  | `string`  | Use this to set the on progress message shown in the Android notifications center.                                                                                                              |

packages/background-http/index.d.ts

@@ -169,6 +169,11 @@ export interface Request {
      */
     description: string;
 
+		/**
+		 * iOS only. Sets NSMutableURLRequest.timeoutInterval value in seconds (s)
+		 */
+		timeout?: number
+
     /**
      * Use utf8 encode in requests
      */

packages/background-http/index.ios.ts

@@ -177,6 +177,10 @@ class Session implements Session {
             request.HTTPMethod = options.method;
         }
 
+				if (options.timeout) {
+						request.timeoutInterval = options.timeout;
+				}
+
         let fileURL: NSURL;
         if (fileUri.substr(0, 7) === "file://") {
             // File URI in string format