Interface: RetryPolicy

Retry configuration. Partial overrides on the client or per call inherit the remaining fields from the level above.

属性

apiConnectionError

readonly apiConnectionError: boolean;

是否重试连接错误（APIConnectionError）。默认 true。 / Retry connection errors. Default true.

---

apiTimeoutError

readonly apiTimeoutError: boolean;

是否重试超时（APITimeoutError）。默认 true。 / Retry timeouts. Default true.

---

backoffInitialMs

readonly backoffInitialMs: number;

首次退避（毫秒），之后每次翻倍。默认 500。 / First backoff in ms, doubled each retry. Default 500.

---

backoffJitter

readonly backoffJitter: number;

每次退避随机扣减的比例（0–1）。默认 0.25。 / Fraction randomly subtracted. Default 0.25.

---

backoffMaxMs

readonly backoffMaxMs: number;

单次退避上限（毫秒）。默认 8000。 / Maximum backoff in ms. Default 8000.

---

httpStatuses

readonly httpStatuses: ReadonlySet<number>;

会重试的 HTTP 状态码。默认 429、500、502、503、504、529。 / Retried statuses.

---

maxRetries

readonly maxRetries: number;

首次请求之外的最大重试次数；0 关闭重试。默认 2。 / Retries after the first attempt. Default 2.

---

maxRetryAfterMs

readonly maxRetryAfterMs: number;

服务端建议等待时间的上限（毫秒），超出按上限等待。默认 60000。 / Cap for server delays. Default 60000.

---

respectRetryAfter

readonly respectRetryAfter: boolean;

是否遵守 retry-after / retry-after-ms。默认 true。 / Honor retry-after headers. Default true.