fune/browser/base/content/test/fullscreen/browser_fullscreen_keydown_reservation.js
Masayuki Nakano 6b54cbe573 Bug 1821886 - Reserve shortcut keys exiting from the fullscreen mode r=Gijs,edgar,smaug
Chrome for Windows does not dispatch `keydown` event for shortcut keys existing
from the fullscreen mode.  Therefore, we can follow it.

For reserving only shortcut keys in fullscreen mode, we need to duplicate XUL
`<key>` elements which define the shortcut keys (only one in Windows/Linux,
but 3 in macOS).  Then, their `disabled` attributes should be managed when
toggling the fullscreen mode.

Finally, we need to make `XULKeySetGlobalKeyListener` check the `disabled`
attribute **of** `<key>` elements because it's check in `DispatchXULKeyCommand`
in the final step:
https://searchfox.org/mozilla-central/rev/11a4d97a7b5cdfa133f4bda4525649f651703018/dom/events/KeyEventHandler.cpp#315-316

and it stops handling everything with doing nothing. I'm not sure whether this
was intentionally implemented or just a inefficient code which we didn't take
care the performance. However, I think that ignoring the disabled `<key>`
elements is reasonable behavior from `<key>` element users point of view.

(I found only one `<key>` which is disabled by default:
https://searchfox.org/mozilla-central/rev/11a4d97a7b5cdfa133f4bda4525649f651703018/browser/base/content/browser-sets.inc#225-233)

Differential Revision: https://phabricator.services.mozilla.com/D178262
2023-05-24 00:50:17 +00:00

112 lines
3.1 KiB
JavaScript

/* Any copyright is dedicated to the Public Domain.
http://creativecommons.org/publicdomain/zero/1.0/ */
"use strict";
// This test verifies that whether shortcut keys of toggling fullscreen modes
// are reserved.
add_task(async function test_keydown_event_reservation_toggling_fullscreen() {
await SpecialPowers.pushPrefEnv({
set: [
["full-screen-api.transition-duration.enter", "0 0"],
["full-screen-api.transition-duration.leave", "0 0"],
],
});
let shortcutKeys = [{ key: "KEY_F11", modifiers: {} }];
if (navigator.platform.startsWith("Mac")) {
shortcutKeys.push({
key: "f",
modifiers: { metaKey: true, ctrlKey: true },
});
shortcutKeys.push({
key: "F",
modifiers: { metaKey: true, shiftKey: true },
});
}
function shortcutDescription(aShortcutKey) {
return `${
aShortcutKey.metaKey ? "Meta + " : ""
}${aShortcutKey.shiftKey ? "Shift + " : ""}${aShortcutKey.ctrlKey ? "Ctrl + " : ""}${aShortcutKey.key.replace("KEY_", "")}`;
}
for (const shortcutKey of shortcutKeys) {
const tab = await BrowserTestUtils.openNewForegroundTab(
gBrowser,
"https://example.org/browser/browser/base/content/test/fullscreen/fullscreen.html"
);
await SimpleTest.promiseFocus(tab.linkedBrowser);
const fullScreenEntered = BrowserTestUtils.waitForEvent(
window,
"fullscreen"
);
await SpecialPowers.spawn(tab.linkedBrowser, [], async () => {
content.wrappedJSObject.keydown = null;
content.window.addEventListener("keydown", event => {
switch (event.key) {
case "Shift":
case "Meta":
case "Control":
break;
default:
content.wrappedJSObject.keydown = event;
}
});
});
EventUtils.synthesizeKey(shortcutKey.key, shortcutKey.modifiers);
info(
`Waiting for entering the fullscreen mode with synthesizing ${shortcutDescription(
shortcutKey
)}...`
);
await fullScreenEntered;
info("Retrieving the result...");
Assert.ok(
await SpecialPowers.spawn(
tab.linkedBrowser,
[],
async () => !!content.wrappedJSObject.keydown
),
`Entering the fullscreen mode with ${shortcutDescription(
shortcutKey
)} should cause "keydown" event`
);
const fullScreenExited = BrowserTestUtils.waitForEvent(
window,
"fullscreen"
);
await SpecialPowers.spawn(tab.linkedBrowser, [], async () => {
content.wrappedJSObject.keydown = null;
});
EventUtils.synthesizeKey(shortcutKey.key, shortcutKey.modifiers);
info(
`Waiting for exiting from the fullscreen mode with synthesizing ${shortcutDescription(
shortcutKey
)}...`
);
await fullScreenExited;
info("Retrieving the result...");
Assert.ok(
await SpecialPowers.spawn(
tab.linkedBrowser,
[],
async () => !content.wrappedJSObject.keydown
),
`Exiting from the fullscreen mode with ${shortcutDescription(
shortcutKey
)} should not cause "keydown" event`
);
BrowserTestUtils.removeTab(tab);
}
});