iOSの通知センターに表示されているアクティブな通知を取得する方法

iOSアプリ開発において、通知センター（ステータスバーのトレイ）に現在表示されている通知の一覧を取得したいケースがあります。本記事では、getDeliveredNotifications を使って、自分のアプリが配信した通知のうち、まだ通知センターに残っているものを取得する方法を解説します。

公式ドキュメントの参照先

APIの詳細については、Appleの公式ドキュメントを参照してください。

UNUserNotificationCenter – Apple Developer Documentation

getDeliveredNotifications(completionHandler:) – Apple Developer Documentation

プライバシーに関する制限

まず押さえておきたい点として、他のアプリの通知を取得することはできません。これはユーザーのプライバシー保護のためであり、OSレベルで制限されています。

ただし、自社アプリ（自アプリ）が配信した通知であれば、通知センターに表示されたままの状態で取得することが可能です。

getDeliveredNotifications(completionHandler:) の使い方

Appleが提供している getDeliveredNotifications(completionHandler:) メソッドを使うと、現在も通知センターに表示されている、このアプリの通知リストを取得できます。

必要に応じて、以下のようなコードを記述してください。

UNUserNotificationCenter.current().getDeliveredNotifications { (notifications) in
    print(notifications)
}

クロージャに渡される notifications は [UNNotification] 型の配列です。各要素から識別子（identifier）やペイロードの内容などを取り出し、既読管理や通知の整理などに活用できます。

補足：特定の通知だけ削除したい場合

取得した通知の中から不要なものを消したい場合は、removeDeliveredNotifications(withIdentifiers:) や removeAllDeliveredNotifications() を組み合わせることで、通知センター内の表示を柔軟にコントロールできます。