fune/browser/base/content/browser-captivePortal.js
Valentin Gosu 36cdb65832 Bug 1824218 - Close captive portal page even if it navigated to support.mozilla.org r=mconley
In bug 1433500 we made the canonical URI be a meta refresh to a SUMO page in
order to show the user useful information if they happen to unlock the captive
portal just as the page is loading.

The portal watcher will close the tab if its location is
http://detectportal.firefox.com/canonical.html, but since the page will do a
meta refresh, its URL might be support.mozilla.org at that point, so we
make sure to also close it if it's already refreshed so it doesn't stick
around and urge the user to file a bug about it :)

Differential Revision: https://phabricator.services.mozilla.com/D200928
2024-02-09 20:12:07 +00:00

406 lines
13 KiB
JavaScript

/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
var CaptivePortalWatcher = {
// This is the value used to identify the captive portal notification.
PORTAL_NOTIFICATION_VALUE: "captive-portal-detected",
// This holds a weak reference to the captive portal tab so that we
// don't leak it if the user closes it.
_captivePortalTab: null,
/**
* If a portal is detected when we don't have focus, we first wait for focus
* and then add the tab if, after a recheck, the portal is still active. This
* is set to true while we wait so that in the unlikely event that we receive
* another notification while waiting, we don't do things twice.
*/
_delayedCaptivePortalDetectedInProgress: false,
// In the situation above, this is set to true while we wait for the recheck.
// This flag exists so that tests can appropriately simulate a recheck.
_waitingForRecheck: false,
// This holds a weak reference to the captive portal tab so we can close the tab
// after successful login if we're redirected to the canonicalURL.
_previousCaptivePortalTab: null,
// Stores the time at which the banner was displayed
_bannerDisplayTime: Date.now(),
get _captivePortalNotification() {
return gNotificationBox.getNotificationWithValue(
this.PORTAL_NOTIFICATION_VALUE
);
},
get canonicalURL() {
return Services.prefs.getCharPref("captivedetect.canonicalURL");
},
get _browserBundle() {
delete this._browserBundle;
return (this._browserBundle = Services.strings.createBundle(
"chrome://browser/locale/browser.properties"
));
},
init() {
Services.obs.addObserver(this, "captive-portal-login");
Services.obs.addObserver(this, "captive-portal-login-abort");
Services.obs.addObserver(this, "captive-portal-login-success");
this._cps = Cc["@mozilla.org/network/captive-portal-service;1"].getService(
Ci.nsICaptivePortalService
);
if (this._cps.state == this._cps.LOCKED_PORTAL) {
// A captive portal has already been detected.
this._captivePortalDetected();
// Automatically open a captive portal tab if there's no other browser window.
if (BrowserWindowTracker.windowCount == 1) {
this.ensureCaptivePortalTab();
}
} else if (this._cps.state == this._cps.UNKNOWN) {
// We trigger a portal check after delayed startup to avoid doing a network
// request before first paint.
this._delayedRecheckPending = true;
}
// This constant is chosen to be large enough for a portal recheck to complete,
// and small enough that the delay in opening a tab isn't too noticeable.
// Please see comments for _delayedCaptivePortalDetected for more details.
XPCOMUtils.defineLazyPreferenceGetter(
this,
"PORTAL_RECHECK_DELAY_MS",
"captivedetect.portalRecheckDelayMS",
500
);
},
uninit() {
Services.obs.removeObserver(this, "captive-portal-login");
Services.obs.removeObserver(this, "captive-portal-login-abort");
Services.obs.removeObserver(this, "captive-portal-login-success");
this._cancelDelayedCaptivePortal();
},
delayedStartup() {
if (this._delayedRecheckPending) {
delete this._delayedRecheckPending;
this._cps.recheckCaptivePortal();
}
},
observe(aSubject, aTopic, aData) {
switch (aTopic) {
case "captive-portal-login":
this._captivePortalDetected();
break;
case "captive-portal-login-abort":
this._captivePortalGone(false);
break;
case "captive-portal-login-success":
this._captivePortalGone(true);
break;
case "delayed-captive-portal-handled":
this._cancelDelayedCaptivePortal();
break;
}
},
onLocationChange(browser) {
if (!this._previousCaptivePortalTab) {
return;
}
let tab = this._previousCaptivePortalTab.get();
if (!tab || !tab.linkedBrowser) {
return;
}
if (browser != tab.linkedBrowser) {
return;
}
// There is a race between the release of captive portal i.e.
// the time when success/abort events are fired and the time when
// the captive portal tab redirects to the canonicalURL. We check for
// both conditions to be true and also check that we haven't already removed
// the captive portal tab in the success/abort event handlers before we remove
// it in the callback below. A tick is added to avoid removing the tab before
// onLocationChange handlers across browser code are executed.
Services.tm.dispatchToMainThread(() => {
if (!this._previousCaptivePortalTab) {
return;
}
tab = this._previousCaptivePortalTab.get();
let canonicalURI = Services.io.newURI(this.canonicalURL);
if (
tab &&
(tab.linkedBrowser.currentURI.equalsExceptRef(canonicalURI) ||
tab.linkedBrowser.currentURI.host == "support.mozilla.org") &&
(this._cps.state == this._cps.UNLOCKED_PORTAL ||
this._cps.state == this._cps.UNKNOWN)
) {
gBrowser.removeTab(tab);
}
});
},
_captivePortalDetected() {
if (this._delayedCaptivePortalDetectedInProgress) {
return;
}
// Add an explicit permission for the last detected URI such that https-only / https-first do not
// attempt to upgrade the URI to https when following the "open network login page" button.
// We set explicit permissions for regular and private browsing windows to keep permissions
// separate.
let canonicalURI = Services.io.newURI(this.canonicalURL);
let isPrivate = PrivateBrowsingUtils.isWindowPrivate(window);
let principal = Services.scriptSecurityManager.createContentPrincipal(
canonicalURI,
{
userContextId: gBrowser.contentPrincipal.userContextId,
privateBrowsingId: isPrivate ? 1 : 0,
}
);
Services.perms.addFromPrincipal(
principal,
"https-only-load-insecure",
Ci.nsIPermissionManager.ALLOW_ACTION,
Ci.nsIPermissionManager.EXPIRE_SESSION
);
let win = BrowserWindowTracker.getTopWindow();
// Used by tests: ignore the main test window in order to enable testing of
// the case where we have no open windows.
if (win.document.documentElement.getAttribute("ignorecaptiveportal")) {
win = null;
}
// If no browser window has focus, open and show the tab when we regain focus.
// This is so that if a different application was focused, when the user
// (re-)focuses a browser window, we open the tab immediately in that window
// so they can log in before continuing to browse.
if (win != Services.focus.activeWindow) {
this._delayedCaptivePortalDetectedInProgress = true;
window.addEventListener("activate", this, { once: true });
Services.obs.addObserver(this, "delayed-captive-portal-handled");
}
this._showNotification();
},
/**
* Called after we regain focus if we detect a portal while a browser window
* doesn't have focus. Triggers a portal recheck to reaffirm state, and adds
* the tab if needed after a short delay to allow the recheck to complete.
*/
_delayedCaptivePortalDetected() {
if (!this._delayedCaptivePortalDetectedInProgress) {
return;
}
// Used by tests: ignore the main test window in order to enable testing of
// the case where we have no open windows.
if (window.document.documentElement.getAttribute("ignorecaptiveportal")) {
return;
}
Services.obs.notifyObservers(null, "delayed-captive-portal-handled");
// Trigger a portal recheck. The user may have logged into the portal via
// another client, or changed networks.
this._cps.recheckCaptivePortal();
this._waitingForRecheck = true;
let requestTime = Date.now();
let observer = () => {
let time = Date.now() - requestTime;
Services.obs.removeObserver(observer, "captive-portal-check-complete");
this._waitingForRecheck = false;
if (this._cps.state != this._cps.LOCKED_PORTAL) {
// We're free of the portal!
return;
}
if (time <= this.PORTAL_RECHECK_DELAY_MS) {
// The amount of time elapsed since we requested a recheck (i.e. since
// the browser window was focused) was small enough that we can add and
// focus a tab with the login page with no noticeable delay.
this.ensureCaptivePortalTab();
}
};
Services.obs.addObserver(observer, "captive-portal-check-complete");
},
_captivePortalGone(aSuccess) {
this._cancelDelayedCaptivePortal();
this._removeNotification();
let durationInSeconds = Math.round(
(Date.now() - this._bannerDisplayTime) / 1000
);
Services.telemetry.keyedScalarAdd(
"networking.captive_portal_banner_display_time",
aSuccess ? "success" : "abort",
durationInSeconds
);
if (!this._captivePortalTab) {
return;
}
let tab = this._captivePortalTab.get();
let canonicalURI = Services.io.newURI(this.canonicalURL);
if (
tab &&
tab.linkedBrowser &&
(tab.linkedBrowser.currentURI.equalsExceptRef(canonicalURI) ||
tab.linkedBrowser.currentURI.host == "support.mozilla.org")
) {
this._previousCaptivePortalTab = null;
gBrowser.removeTab(tab);
}
this._captivePortalTab = null;
},
_cancelDelayedCaptivePortal() {
if (this._delayedCaptivePortalDetectedInProgress) {
this._delayedCaptivePortalDetectedInProgress = false;
Services.obs.removeObserver(this, "delayed-captive-portal-handled");
window.removeEventListener("activate", this);
}
},
async handleEvent(aEvent) {
switch (aEvent.type) {
case "activate":
this._delayedCaptivePortalDetected();
break;
case "TabSelect":
if (this._notificationPromise) {
await this._notificationPromise;
}
if (!this._captivePortalTab || !this._captivePortalNotification) {
break;
}
let tab = this._captivePortalTab.get();
let n = this._captivePortalNotification;
if (!tab || !n) {
break;
}
let doc = tab.ownerDocument;
let button = n.buttonContainer.querySelector(
"button.notification-button"
);
if (doc.defaultView.gBrowser.selectedTab == tab) {
button.style.visibility = "hidden";
} else {
button.style.visibility = "visible";
}
break;
}
},
_showNotification() {
if (this._captivePortalNotification) {
return;
}
Services.telemetry.scalarAdd(
"networking.captive_portal_banner_displayed",
1
);
this._bannerDisplayTime = Date.now();
let buttons = [
{
label: this._browserBundle.GetStringFromName(
"captivePortal.showLoginPage2"
),
callback: () => {
this.ensureCaptivePortalTab();
// Returning true prevents the notification from closing.
return true;
},
},
];
let message = this._browserBundle.GetStringFromName(
"captivePortal.infoMessage3"
);
let closeHandler = aEventName => {
if (aEventName == "dismissed") {
let durationInSeconds = Math.round(
(Date.now() - this._bannerDisplayTime) / 1000
);
Services.telemetry.keyedScalarAdd(
"networking.captive_portal_banner_display_time",
"dismiss",
durationInSeconds
);
}
if (aEventName != "removed") {
return;
}
gBrowser.tabContainer.removeEventListener("TabSelect", this);
};
this._notificationPromise = gNotificationBox.appendNotification(
this.PORTAL_NOTIFICATION_VALUE,
{
label: message,
priority: gNotificationBox.PRIORITY_INFO_MEDIUM,
eventCallback: closeHandler,
},
buttons
);
gBrowser.tabContainer.addEventListener("TabSelect", this);
},
_removeNotification() {
let n = this._captivePortalNotification;
if (!n || !n.parentNode) {
return;
}
n.close();
},
ensureCaptivePortalTab() {
let tab;
if (this._captivePortalTab) {
tab = this._captivePortalTab.get();
}
// If the tab is gone or going, we need to open a new one.
if (!tab || tab.closing || !tab.parentNode) {
tab = gBrowser.addWebTab(this.canonicalURL, {
ownerTab: gBrowser.selectedTab,
triggeringPrincipal: Services.scriptSecurityManager.createNullPrincipal(
{
userContextId: gBrowser.contentPrincipal.userContextId,
}
),
disableTRR: true,
});
this._captivePortalTab = Cu.getWeakReference(tab);
this._previousCaptivePortalTab = Cu.getWeakReference(tab);
}
gBrowser.selectedTab = tab;
},
};