retry

function retry<T>(fn: (attempt: number) => T, options: RetryOptions = {}): T;

L'attente part de delay, est multipliée par multiplier après chaque échec et ne dépasse jamais maxDelay. shouldRetry décide si un échec donné mérite d'être retenté — une limite de débit souvent, un mauvais argument jamais.

La fonction reçoit le numéro de tentative, à partir de 1. Si la dernière échoue, son erreur est relancée. L'attente passe par sleep, qui vaut Utilities.sleep là où il existe et se remplace dans un test.

Paramètres

Paramètre	Type	Description
`fn`	`(attempt: number) => T`	La fonction à appeler. Elle reçoit le numéro de tentative.
`options` (facultatif) `= {}`	`RetryOptions`	`attempts`, `delay`, `multiplier`, `maxDelay`, `shouldRetry` et `sleep`.

Valeur de retour

T — ce que renvoie la fonction lors de la tentative réussie.

Exceptions

Exception	Condition
`IllegalArgumentException`	le premier argument n'est pas une fonction, ou une option est hors de l'intervalle.

Exemples

Retenter un appel instable

const response = retry(() => UrlFetchApp.fetch(url), {
  attempts: 4,
  delay: 500,
  multiplier: 2,
  shouldRetry: (error) => String(error).includes("429")
});

Voir aussi

Code source

src/lang/function/retry.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.