【Swift】.getPendingNotificationRequestsとは？使い方や引数の意味をわかりやすく解説

2025年8月30日 2025年8月30日

ローカル通知の管理をアプリ内で柔軟に行いたいときに活用できるのが UNUserNotificationCenter.current().getPendingNotificationRequests です。

これは通知をスケジュールした後、どの通知がまだ保留状態にあるのかを確認・取得できるAPI。

特定の通知のキャンセルや状態確認、リスト表示などに役立ちます。

この記事では getPendingNotificationRequests の基本的な意味や使い方、主要な引数、活用シーン、注意点までをわかりやすく丁寧に解説します。

getPendingNotificationRequestsとは？

getPendingNotificationRequests(completionHandler:) は、UserNotifications フレームワークに含まれる UNUserNotificationCenter クラスのインスタンスメソッドです。

ユーザー通知センター (UNUserNotificationCenter) にある現在保留中のローカル通知リクエスト一覧を非同期的に取得してくれます。

このメソッドを使うことで、アプリがスケジュールした通知（トリガーを待っている状態）の一覧を取得し、確認・表示・削除などの処理を行うことができます。

通知がすでに発火されたものは含まれず、まだ発火前の保留状態の通知のみが対象となります。

具体例：保留中の通知を取得・表示する

以下は、保留中の通知リクエストを取得してコンソールに出力するサンプルコードです。

import UserNotifications

UNUserNotificationCenter.current().getPendingNotificationRequests { requests in
    for request in requests {
        print("通知ID: \(request.identifier)")
        print("タイトル: \(request.content.title)")
        print("本文: \(request.content.body)")
        print("トリガー: \(String(describing: request.trigger))")
    }
}

import UserNotifications

UNUserNotificationCenter.current().getPendingNotificationRequests { requests in

for request in requests {

print("通知ID: \(request.identifier)")

print("タイトル: \(request.content.title)")

print("本文: \(request.content.body)")

print("トリガー: \(String(describing: request.trigger))")

}

このコードでは、各通知の identifier（通知識別子）、content（通知本文）、および trigger（トリガー条件）を順に出力しています。

これを使えば、保留中の通知が何件あるのか、どんな内容かをアプリ内で動的に取得して処理できます。

主要な引数とその意味

getPendingNotificationRequests は非同期APIで、クロージャ内で取得結果が渡されます。

指定するのは completionHandler のみです。

引数名	型	説明
completionHandler	`([UNNotificationRequest]) -> Void`	保留中の通知リクエストを受け取る非同期クロージャ

受け取る配列の要素 UNNotificationRequest は、スケジュールされた1つ1つの通知の情報（ID、コンテンツ、トリガーなど）を表します。

通知処理

【Swift】UNNotificationRequestとは？使い方や引数の意味、活用シーンをわかりやすく解説！

iOSアプリでローカル通知を送信したいときに必要なのが UNNotificationRequest です。「アプリを閉じていても決まった時間にリマインダーを送りたい」「タスクの期限前に通知したい」といったニーズを簡単に実現できます。この記事では UNNotificationRequest の...

getPendingNotificationRequestsの活用シーン

getPendingNotificationRequests は以下のような場面で活躍します。

現在スケジュールされている通知を一覧表示したいとき
通知のキャンセル対象を判断したいとき（特定IDのみ削除など）
デバッグ用途で現在の通知状況を確認したいとき
通知の重複スケジュールを防止したいとき（同一内容の通知が複数回セットされていないか確認）
設定済みの通知をアプリ内で可視化したいとき（設定画面など）

このように、通知機能が動的な管理を必要とするアプリでは非常に便利なAPIです。

getPendingNotificationRequests を使うときの注意点

getPendingNotificationRequests は便利なメソッドですが、実際にアプリで利用する際にはいくつか注意しておくべき点があります。

これらを理解しておくことで、想定外の動作を避け、通知管理を安全に実装できます。

1. 非同期処理である

このメソッドは 非同期的に通知リストを返す 仕組みになっています。

呼び出した直後には結果が得られず、クロージャ内で結果を受け取ります。

そのため、UI の更新や状態管理は必ず メインスレッドに戻して 行う必要があります。

UNUserNotificationCenter.current().getPendingNotificationRequests { requests in
    DispatchQueue.main.async {
        self.notifications = requests // UI更新は必ずメインスレッドで
    }
}