Merge pull request #105 from microsoftgraph/Passing-Options-For-Fetch

Passing options for fetch

Author: muthurathinam

README.md

@@ -247,6 +247,14 @@ You can pass in additional request headers, either individually or in a dictiona
 
 ````
 
+### .option() and .options()
+You can pass in additional request options, either individually or in a dictionay. Options can be [node specific](https://github.com/bitinn/node-fetch#options) or [from fetch standard](https://fetch.spec.whatwg.org/#requestinit)
+```js
+.option("someOptionName", "someOptionValue")
+// or
+.options({"someOptionName":"someOptionValue"})
+```
+
 ### .responseType()
 To set a custom response type, use the `.responseType(<ResponseType>)` method. Refer [ResponseType.ts](./src/ResponseType.ts) for available options.
 ````js

lib/graph-js-sdk-core.js

@@ -1,18 +1,23 @@
 import { Promise } from 'es6-promise';
 import 'isomorphic-fetch';
-import { Options, URLComponents, GraphRequestCallback } from "./common";
+import { Options, URLComponents, GraphRequestCallback, FetchOptions } from "./common";
 export declare class GraphRequest {
     config: Options;
     urlComponents: URLComponents;
+    _options: FetchOptions;
     _headers: {
-        [key: string]: string | number;
+        [key: string]: string;
     };
     _responseType: string;
     constructor(config: Options, path: string);
     header(headerKey: string, headerValue: string): this;
     headers(headers: {
         [key: string]: string | number;
     }): this;
+    option(key: string, value: any): this;
+    options(options: {
+        [key: string]: any;
+    }): this;
     parsePath(rawPath: string): void;
     private urlJoin;
     buildFullUrl(): string;
@@ -28,21 +33,57 @@ export declare class GraphRequest {
     responseType(responseType: string): GraphRequest;
     private addCsvQueryParamater;
     delete(callback?: GraphRequestCallback): Promise<any>;
+    /**
+     * Alias for delete call
+     */
+    del(callback?: GraphRequestCallback): Promise<any>;
     patch(content: any, callback?: GraphRequestCallback): Promise<any>;
     post(content: any, callback?: GraphRequestCallback): Promise<any>;
-    put(content: any, callback?: GraphRequestCallback): Promise<any>;
+    /**
+     * Alias for Post call
+     */
     create(content: any, callback?: GraphRequestCallback): Promise<any>;
+    put(content: any, callback?: GraphRequestCallback): Promise<any>;
+    /**
+     * Alias for update call
+     */
     update(content: any, callback?: GraphRequestCallback): Promise<any>;
-    del(callback?: GraphRequestCallback): Promise<any>;
     get(callback?: GraphRequestCallback): Promise<any>;
+    getStream(callback: GraphRequestCallback): Promise<any>;
+    putStream(stream: any, callback: GraphRequestCallback): Promise<any>;
+    /**
+     * @private
+     * Sends request and routes response to the callback or resolves to promise
+     * @param {RequestInfo} request - The Request object or url string value
+     * @param {FetchOptions} options - The options for the fetch api request
+     * @param {GraphRequestCallback} callback - The callback that needs to be called on response
+     * @return The promise in case if the callback param is empty
+     */
+    private sendRequestAndRouteResponse;
+    /**
+     * @private
+     * Gets the Promise that will resolve or reject with fetch api request
+     * @param {RequestInfo} request - The Request object or url string value
+     * @param {FetchOptions} options - The options for the fetch api request
+     * @return The Promise that resolves with Response
+     */
     private routeResponseToPromise;
-    private handleFetch;
+    /**
+     * @private
+     * Makes request to the service by getting auth token from the auth provider
+     * @param {RequestInfo} request - The Request object or url string value
+     * @param {FetchOptions} options - The options for the fetch api request
+     * @param {GraphRequestCallback} callback - The callback function
+     */
     private routeResponseToCallback;
-    private sendRequestAndRouteResponse;
-    getStream(callback: GraphRequestCallback): void;
-    putStream(stream: any, callback: GraphRequestCallback): void;
-    private getDefaultRequestHeaders;
-    private configureRequest;
+    /**
+     * @private
+     * Customizes the fetch options with the Auth token, SDKVersion header and customization applied via init, .header, .headers, .option, .options etc
+     * @param {FetchOptions} options - The options for the fetch api request
+     * @param {string} accessToken - The access token value
+     * @return The fetch options with customization
+     */
+    private configureRequestOptions;
     query(queryDictionaryOrString: string | {
         [key: string]: string | number;
     }): GraphRequest;