Comunica Retry HTTP Actor

An HTTP actor that performs simple request retries.

This module is part of the Comunica framework, and should only be used by developers that want to build their own query engine.

Click here if you just want to query with Comunica.

Install

$ yarn add @comunica/actor-http-retry
Copy

Configure

After installing, this package can be added to your engine's configuration as follows:

{
  "@context": [
    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/actor-http-retry/^3.0.0/components/context.jsonld"
  ],
  "actors": [
    {
      "@id": "urn:comunica:default:http/actors#retry",
      "@type": "ActorHttpRetry"
    }
  ]
}
Copy

Requests that fail without a response, such as on connection errors, are also retried. This does not apply to requests that the caller aborted, or that exceeded KeysHttp.httpTimeout. As the server may have processed such requests already, this only applies to idempotent methods (such as GET and QUERY) and POST requests of SPARQL queries, but not of SPARQL updates.

Context Parameters

• KeysHttp.httpRetryCount: The number of retries, added on top of the initial attempt.
• KeysHttp.httpRetryDelayFallback: The fallback retry delay in milliseconds, if a server does not send a Retry-After header.
• KeysHttp.httpRetryDelayLimit: The optional upper limit of the retry delay in milliseconds. If a server requests a delay larger than this, the engine will consider it unavailable.