http202-retry
A module to automatically retry HTTP requests if a HTTP 202 response is returned.
I built this module specifically for interacting with GeoJSON APIs on ArcGIS Open Data websites, but it may be useful for other purposes.
The GeoJSON API on ArcGIS Open Data websites returns a 202 Accepted response code when a filter is applied to a dataset. This means the server is still processing the request. This module catches that response code and automatically schedules another request after a short duration. By default the process repeats for 30s or until data is returned.
Usage
var reqRetry =
API
var reqRetry =
reqRetry([url], [opts], cb)
By default, creates a new request (xhr in browsers). Automatically retries the request several times (up to 30s by default) if response.statusCode === 202
.
-
[opts.request]
{Function} if specified, a substitute XMLHttpRequest GET function. See this example. If not specified, nets is used. -
[opts.reqOpts]
{Object} options passed to requestOptions parameter (xhrOptions in the browser). Includejson:true
if requesting JSON or GeoJSON data. -
[opts.timeout]
{Number} Time, in milliseconds, to wait until timeout (default30000
) -
cb
{Function} is called with the arguments (Error
,response
,body
)
Error
is only returned if something is preventing the request or after time out. HTTP 400 or 500 responses will not return an error. You should catch these yourself.
Installation
npm install http202-retry
License
ISC License (ISC)
Copyright 2017 Nick Peihl
Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.