Managing Push Subscriptions
You'll learn how to check subscription status, let users unsubscribe, and handle subscription changes or expiration.
The Core Challenge
Push subscriptions aren't permanent—they can expire, users can revoke permissions, or browsers might invalidate them. Managing subscriptions means regularly checking their health, respecting user preferences, and cleaning up when needed.
Think of push subscriptions like magazine subscriptions: you need to check if they're still active, allow users to cancel anytime, and handle renewals or expiration gracefully.
Checking Subscription Status
Use the Push Manager to retrieve the current subscription:
// In your main app or service worker
async function checkSubscription() {
const registration = await navigator.serviceWorker.ready;
const subscription = await registration.pushManager.getSubscription();
if (subscription) {
console.log('User is subscribed:', subscription.endpoint);
// Send to server to verify it's still valid
} else {
console.log('User is not subscribed');
}
}
Unsubscribing Users
Always provide a clear way to opt out:
async function unsubscribe() {
const registration = await navigator.serviceWorker.ready;
const subscription = await registration.pushManager.getSubscription();
if (subscription) {
await subscription.unsubscribe();
// Notify your server to remove this subscription
await fetch('/api/remove-subscription', {
method: 'POST',
body: JSON.stringify({ endpoint: subscription.endpoint })
});
}
}
Handling Expiration
Subscriptions can expire silently. Check periodically and resubscribe if needed:
async function refreshSubscription() {
const subscription = await registration.pushManager.getSubscription();
if (!subscription || subscription.expirationTime < Date.now()) {
// Create new subscription (using VAPID keys from earlier lessons)
const newSub = await registration.pushManager.subscribe({...});
// Update server with new subscription
}
}
Key Takeaway: Managing push subscriptions means actively monitoring their status, honoring unsubscribe requests immediately, and gracefully handling expiration to maintain a healthy notification system.