GNOME扩展开发：如何用JavaScript实现键盘禁用功能？

一、你的现有代码问题 #

Main.onkeydown不是GNOME Shell的合法事件监听方式，所以这段代码不会起作用。GNOME Shell基于Clutter，需要用Clutter的全局事件处理机制来拦截键盘事件。

二、方法1：使用Clutter全局事件过滤器（纯JS实现） #

这种方法不需要调用外部命令，直接在扩展里拦截所有键盘输入：

1. 在扩展类里添加变量保存过滤器ID，用于后续移除清理：

class MyExtension extends Extension {
    constructor(metadata) {
        super(metadata);
        this._keyboardFilterId = null;
    }
}

2. 编写拦截键盘事件的过滤器函数：

_filterKeyboardEvents(event) {
    // 拦截所有键盘按下/释放事件
    if (event.type() === Clutter.EventType.KEY_PRESS || event.type() === Clutter.EventType.KEY_RELEASE) {
        return Clutter.EVENT_STOP; // 阻止事件继续传播
    }
    return Clutter.EVENT_PROPAGATE; // 其他事件正常传递
}

3. 修改_onClicked方法，切换过滤器的添加/移除：

_onClicked(actor, event) {
    if ((event.type() !== Clutter.EventType.TOUCH_BEGIN && event.type() !== Clutter.EventType.BUTTON_PRESS)) {
        return Clutter.EVENT_PROPAGATE;
    }

    if (this._icon.icon_name === TOGGLE_ON_ICON) {
        this._icon.icon_name = TOGGLE_OFF_ICON;
        Main.notify('Keyboard has been turned off!');
        // 添加全局事件过滤器
        this._keyboardFilterId = Clutter.add_global_filter(Clutter.EventFilterPhase.EARLY, this._filterKeyboardEvents.bind(this));
    } else {
        this._icon.icon_name = TOGGLE_ON_ICON;
        Main.notify('Keyboard has been turned on!');
        // 移除全局事件过滤器
        if (this._keyboardFilterId !== null) {
            Clutter.remove_global_filter(this._keyboardFilterId);
            this._keyboardFilterId = null;
        }
    }
}

4. 关键：在扩展禁用时清理过滤器，避免内存泄漏：

disable() {
    // 如果过滤器存在，移除它
    if (this._keyboardFilterId !== null) {
        Clutter.remove_global_filter(this._keyboardFilterId);
        this._keyboardFilterId = null;
    }
    // 其他清理逻辑...
}

三、方法2：调用xinput命令（底层硬件级禁用） #

如果需要更彻底的禁用（比如拦截系统级快捷键），可以调用xinput命令禁用键盘设备：

1. 编写函数获取所有键盘设备ID：

_getKeyboardDeviceIds() {
    // 执行xinput命令筛选出所有键盘设备ID
    const [success, stdout] = GLib.spawn_command_line_sync('xinput list --id-only --name-only | grep -i "keyboard" | xargs xinput list --id-only');
    if (!success) return [];
    // 解析输出为ID数组
    return stdout.toString().trim().split('\n').filter(id => id !== '');
}

2. 修改_onClicked方法切换禁用/启用：

_onClicked(actor, event) {
    if ((event.type() !== Clutter.EventType.TOUCH_BEGIN && event.type() !== Clutter.EventType.BUTTON_PRESS)) {
        return Clutter.EVENT_PROPAGATE;
    }

    const keyboardIds = this._getKeyboardDeviceIds();
    if (this._icon.icon_name === TOGGLE_ON_ICON) {
        this._icon.icon_name = TOGGLE_OFF_ICON;
        Main.notify('Keyboard has been turned off!');
        // 禁用每个键盘设备
        keyboardIds.forEach(id => {
            GLib.spawn_command_line_async(`xinput disable ${id}`);
        });
    } else {
        this._icon.icon_name = TOGGLE_ON_ICON;
        Main.notify('Keyboard has been turned on!');
        // 启用每个键盘设备
        keyboardIds.forEach(id => {
            GLib.spawn_command_line_async(`xinput enable ${id}`);
        });
    }
}

3. 扩展禁用时恢复键盘状态：

disable() {
    const keyboardIds = this._getKeyboardDeviceIds();
    keyboardIds.forEach(id => {
        GLib.spawn_command_line_async(`xinput enable ${id}`);
    });
    // 其他清理逻辑...
}

给JavaScript新手的小提示 #

• 始终用const/let声明变量，避免全局污染；
• 用bind(this)确保回调函数里的this指向扩展实例；
• 扩展的enable()/disable()方法是资源管理的关键，一定要在disable()里清理所有添加的监听器、过滤器或外部状态；
• 调试GNOME扩展可以用journalctl -f -o cat /usr/bin/gnome-shell查看实时日志。

内容的提问来源于stack exchange，提问作者c.silva