timeout

指定された時間後にTimeoutErrorを発生させるPromiseを返します。

await timeout(ms);

参照

timeout(ms)

特定の時間が経過した後にタイムアウトエラーを発生させたい場合にtimeoutを使用します。他のPromiseとPromise.race()を一緒に使用して、タスクに時間制限を設定する際に便利です。

import { timeout } from 'es-toolkit/promise';

// 基本的な使用 - 1秒後にTimeoutErrorが発生
try {
  await timeout(1000);
  console.log('このコードは実行されません');
} catch (error) {
  console.log('タイムアウトエラー発生:', error.message); // 'The operation was timed out'
}

Promise.race()と一緒に使用してタスクに時間制限を設定できます:

async function fetchWithTimeout(url: string) {
  try {
    const result = await Promise.race([
      fetch(url),
      timeout(5000), // 5秒制限
    ]);
    return result;
  } catch (error) {
    if (error.name === 'TimeoutError') {
      console.log('リクエストに時間がかかりすぎています');
    }
    throw error;
  }
}

複数の非同期タスクのいずれかが決められた時間内に完了しない場合、全体のタスクを失敗させたい場合にも使用できます。

async function multipleOperationsWithTimeout() {
  try {
    await Promise.race([
      Promise.all([fetch('/api/data1'), fetch('/api/data2'), fetch('/api/data3')]),
      timeout(3000), // 全体のタスクに3秒制限
    ]);
    console.log('すべてのタスクが時間内に完了しました');
  } catch (error) {
    console.log('タスクが時間内に完了しませんでした');
  }
}

パラメータ

• ms (number): TimeoutErrorが発生するまでのミリ秒単位の時間です。

戻り値

(Promise<never>): 指定された時間後にTimeoutErrorで拒否されるPromiseを返します。

エラー

指定された時間が経過するとTimeoutErrorをスローします。