retry

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

Die Wartezeit beginnt bei delay, wird nach jedem Fehlschlag mit multiplier multipliziert und überschreitet maxDelay nie. shouldRetry entscheidet, ob ein Fehlschlag überhaupt eine Wiederholung wert ist — ein Ratenlimit meist, ein falsches Argument nie.

Die Funktion bekommt die Versuchsnummer, beginnend bei 1. Scheitert der letzte Versuch, wird sein Fehler weitergereicht. Das Warten läuft über sleep, standardmäßig Utilities.sleep, wo es das gibt, und in Tests ersetzbar.

Parameter

Parameter	Typ	Beschreibung
`fn`	`(attempt: number) => T`	Die aufzurufende Funktion. Sie erhält die Versuchsnummer.
`options` (optional) `= {}`	`RetryOptions`	`attempts`, `delay`, `multiplier`, `maxDelay`, `shouldRetry` und `sleep`.

Rückgabewert

T — was die Funktion beim erfolgreichen Versuch zurückgibt.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	das erste Argument ist keine Funktion oder eine Option liegt außerhalb des Bereichs.

Beispiele

Einen unzuverlässigen Aufruf wiederholen

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

Siehe auch

Quellcode

src/lang/function/retry.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.