onStateChanged
Fires when the captive portal state changes.
Syntax
js
browser.captivePortal.onStateChanged.addListener(listener)
browser.captivePortal.onStateChanged.removeListener(listener)
browser.captivePortal.onStateChanged.hasListener(listener)
Events have three functions:
addListener(listener)
-
Adds a listener to this event.
removeListener(listener)
-
Stop listening to this event. The
listener
argument is the listener to remove. hasListener(listener)
-
Check whether
listener
is registered for this event. Returnstrue
if it is listening,false
otherwise.
addListener syntax
Parameters
listener
-
The function called when this event occurs. The function is passed this argument:
details
-
string
The captive portal state, being one ofunknown
,not_captive
,unlocked_portal
, orlocked_portal
.
Examples
Handle a change in captive portal status:
js
function handlePortalStatus(portalstatusInfo) {
console.log(`The portal status is now: ${portalstatusInfo.details}`);
}
browser.captivePortal.onStateChanged.addListener(handlePortalStatus);
Browser compatibility
BCD tables only load in the browser