retry

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

Пауза починається з delay, після кожної невдачі множиться на multiplier і не перевищує maxDelay. shouldRetry вирішує, чи варто взагалі повторювати цю помилку: перевищення ліміту зазвичай варто, хибний аргумент — ніколи.

Функція отримує номер спроби, починаючи з 1. Якщо остання спроба не вдалася, її помилка пробрасується назовні. Сама пауза виконується через sleep, який типово бере Utilities.sleep, де той є, і підміняється в тестах.

Параметри

Параметр	Тип	Опис
`fn`	`(attempt: number) => T`	Функція, що викликається. Отримує номер спроби.
`options` (необов'язковий) `= {}`	`RetryOptions`	`attempts`, `delay`, `multiplier`, `maxDelay`, `shouldRetry` та `sleep`.

Повертає

T — те, що повернула функція на вдалій спробі.

Винятки

Виняток	Умова
`IllegalArgumentException`	перший аргумент не функція або значення параметра поза припустимим діапазоном.

Приклади

Повтор ненадійного виклику

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

Дивіться також

Вихідний код

src/lang/function/retry.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.