OptionalcacheCache namespace (see Connector.cacheNamespace). Defaults to
http, or, with headers, to http: plus a hash of them: headers
such as Authorization may select different content at the same URL,
so connectors with different headers do not share cache entries. Set
it to share entries anyway, e.g. across rotating tokens for the same
files.
OptionalcoalesceMerge byte ranges separated by at most this many bytes into one request.
OptionalconditionalHow reads are bound to the file version seen when the source was
opened (its ETag, or Last-Modified without one).
By default every response's validator is compared with it, and a
mismatch raises SourceChangedError. With true, requests also
carry If-Match (or If-Unmodified-Since), so the server itself
refuses a changed file with 412. Conditional requests have costs:
per the Fetch standard they bypass HTTP caches, and in browsers they
need a CORS preflight per request.
OptionalheadersDefault headers sent with every request.
Useful for authorization tokens, custom user-agent strings, or
CDN-specific headers (e.g. { Authorization: 'Bearer ...' }).
OptionalmaxMost HTTP requests in flight at once across all reads through this
connector (every tile and source sharing it); further requests wait
in arrival order. Waiting does not count towards timeout.
Limits parallelism to avoid overwhelming the origin server or
exhausting local socket resources. Infinity disables the limit.
OptionalprefetchSize of the first read of a file (header plus top of the index).
OptionalretryRetry configuration for transient failures.
Retries are attempted on HTTP 5xx responses, HTTP 408 and 429, network
errors, truncated responses and timeouts. Backoff between attempts
grows exponentially (backoff * 2^attempt ms, at most 30 s) with
random jitter, so concurrent requests do not retry in lockstep. A
server's Retry-After is honoured; if it asks for more than 30 s, the
error is raised instead (with ConnectorError.retryAfterMs).
Total number of attempts (including the initial request); at least 1.
Base backoff delay in milliseconds before the first retry.
OptionaltimeoutPer-attempt timeout in milliseconds, covering the response and its body.
If an attempt does not complete within this window, it is aborted and
(if retries remain) retried. 0 or Infinity disable the timeout.
Configuration options for HttpConnector.