Namespace: Http

Polling function inspired from Polling in JavaScript blog post.

The function is a higher-order function that returns a function, executePoll. The executePoll function returns a promise and will run recursively until a stopping condition is met.

Example Usage:

   mindsmine.Http.poll(
      () => {
         // Function to be polled
      },

      (result) => {
         // Function that validates the result of the above function
      }
   ).then((result) => {

      // Do something with the result

   }).catch((response) => {

      console.error(`HTTP error code = ${response.status}`);
      console.error(`HTTP error code = ${response.body.message}`);

   });

Sends an HTTP request to a remote server and returns a Promise object. This function enhances the global fetch function by rejecting on HTTP error status, even for an HTTP 404 or 500.

The promise resolves to the Response object representing the response to the request.

Problem with fetch function: A fetch() promise only rejects when a network error is encountered (which is usually when there is a permissions issue or similar). A fetch() promise does not reject on HTTP errors (404, etc.). Instead, a then() handler must check the Response.ok and/or Response.status properties.

Example Usage:

   mindsmine.Http.request(
      "valid URI",
      {
         headers: {
            "Accept" : "some value",
            "Content-Type" : "some value",
            "Authorization" : "some value"
         }
      }

   ).then((response) => {

      console.log(`HTTP status code = ${response.status}`);

      response.json().then(data => {
         console.log(data);
      });

   }).catch((response) => {

      console.log(`HTTP error code = ${response.status}`);

   }).finally(() => {

      console.log("This function is called regardless of success or failure.");

   });