Push Permission Status Change

Description

The onPermissionStatusChanged listener triggers whenever the device’s permission state changes for supported features — most importantly Push Notification permissions.

This listener is essential for detecting when a user has granted or revoked push permissions, either:

• Immediately after calling requestPermissions("push"), or
• When the user manually enables/disables notifications from device settings.

Use this event to update UI elements, enable push-only features, or prompt users when permissions are denied.

Function Signature

Superfans.listeners.onPermissionStatusChanged(() => {
// Do the necessary logic
});

Example Usage

function checkPushPerm() {
let permission = Superfans.variables.device.permissions.notification;
Superfans.listeners.onPermissionStatusChanged(() => {
    document.getElementById("test_data_visibility").innerHTML += permission;
    if (permission == "denied") {
        Superfans.actions.showToast({
            title: "Oops!!",
            message: "Please enable Push."
        });
        Superfans.actions.requestPushPermission();
    } else {
        Superfans.actions.showToast({
            title: "YAAY!!",
            message: "Push Enabled"
        });
    }
    });
}
checkPushPerm();

Best Practices

1. Use this listener after requesting push permissions to determine user action.
2. Update UI dynamically — hide "Enable Notifications" button when permission is granted.
3. Cache permission status if needed for business logic.
4. Show clear, friendly messaging when the user denies permission.
5. Consider using this listener during onboarding flows to track permission onboarding success.

Caveats

1. Listener fires only after a permission state changes (not on initial load).
2. The payload may not include all permissions — only those supported by the device + app version.