Library that creates toggleable menu commands for userscript managers
Version au
Ce script ne doit pas être installé directement. C'est une librairie destinée à être incluse dans d'autres scripts avec la méta-directive // @require https://update.greasyfork.org/scripts/498119/1395413/setupToggleCommands.js
// ==UserScript==
// @name setupToggleCommands
// @license MIT
// @namespace rtonne
// @match *://*/*
// @version 1.0
// @author Rtonne
// @description Library that creates toggleable menu commands for userscript managers
// @grant GM.registerMenuCommand
// @grant GM.unregisterMenuCommand
// @grant GM.getValue
// @grant GM.setValue
// ==/UserScript==
/**
* Can be the only function of this library used externally.
* @param {_Command[]} command_list The list of all toggle commands that are to be added.
*/
async function setupToggleCommands(command_list) {
for (const command of command_list) {
_runCommandFunction(command);
}
for (const command of command_list) {
await _registerCommand(command_list, command);
}
}
/**
* @typedef {Object} _Command
* @property {string} id The id of the menu command and the key for the value.
* @property {boolean} default The default value.
* @property {string} off_text The text displayed when the last function ran was toggleOffFunction.
* @property {string} on_text The text displayed when the last function ran was toggleOnFunction.
* @property {() => void} toggleOffFunction A function to be run then toggling off the command.
* @property {() => void} toggleOnFunction A function to be run then toggling on the command.
*/
// To check if in place command replacement is supported
// https://violentmonkey.github.io/api/gm/#gm_registermenucommand
const _can_replace_in_place =
"test" === GM.registerMenuCommand("test", () => {}, { id: "test" });
GM.unregisterMenuCommand("test");
/**
* Runs the correct command function, and toggles the command text.
* @param {_Command[]} command_list The list of all commands (may be used to replace old commands).
* @param {_Command} command The command being toggled.
*/
async function _toggleCommand(command_list, command) {
await GM.setValue(
command.id,
!(await GM.getValue(command.id, command.default))
);
_runCommandFunction(command);
if (_can_replace_in_place) {
await _registerCommand(command_list, command);
} else {
// If we can't replace commands, we need to remove them all, then re-add them
for (const command of command_list) {
GM.unregisterMenuCommand(command.id);
}
for (const command of command_list) {
await _registerCommand(command_list, command);
}
}
}
/**
* Registers the command with the correct text.
* @param {_Command[]} command_list The list of all commands (may be used to replace old commands).
* @param {_Command} command
*/
async function _registerCommand(command_list, command) {
let text = command.on_text;
if (!(await GM.getValue(command.id, command.default))) {
text = command.off_text;
}
GM.registerMenuCommand(text, () => _toggleCommand(command_list, command), {
id: command.id,
autoClose: false,
});
}
/**
* Runs the correct command function.
* @param {_Command} command
*/
async function _runCommandFunction(command) {
if (await GM.getValue(command.id, command.default)) {
command.toggleOnFunction();
} else {
command.toggleOffFunction();
}
}