如何在Node.js终端应用中捕获多按键事件？

手动实现思路 #

终端默认会在单个按键按下时触发输入事件，要捕获多按键同时按压，核心是维护当前按下的按键状态集合，通过区分keydown（按键按下）和keyup（按键抬起）事件来更新集合，从而实时获取当前所有按下的键。

代码示例 #

const readline = require('readline');

// 启用终端按键监听
readline.emitKeypressEvents(process.stdin);
process.stdin.setRawMode(true);

// 用Set存储当前按下的按键，自动去重
const pressedKeys = new Set();

process.stdin.on('keypress', (str, key) => {
    // 按Ctrl+C退出程序
    if (key.ctrl && key.name === 'c') {
        process.exit();
    }

    // 更新按键状态集合
    if (key.type === 'keydown') {
        pressedKeys.add(key.name);
    } else if (key.type === 'keyup') {
        pressedKeys.delete(key.name);
    }

    // 实时输出当前按下的所有按键
    console.clear();
    console.log('当前按下的键：', Array.from(pressedKeys).join(', '));
});

关键逻辑说明 #

• readline.emitKeypressEvents(process.stdin)：给标准输入流添加keypress事件支持，该事件会携带按键的详细信息（包括按下/抬起类型、按键名、修饰键状态）。
• Set类型的pressedKeys：自动处理重复按键，确保同一个键多次按下不会重复存储，抬起时能准确移除。
• 区分keydown和keyup：这是实现多按键同时捕获的核心，只有跟踪按键的按下/抬起状态，才能知道当前哪些键处于按压状态。

推荐参考库及原理 #

keypress #

这是专门处理终端按键输入的轻量库，底层原理和手动实现一致：通过监听终端输入流，解析ANSI转义序列区分keydown/keyup事件，维护按键状态集合，同时封装了修饰键（Ctrl/Shift/Alt）的检测逻辑，简化了多按键组合的处理。

inquirer #

如果是开发交互式终端应用，inquirer的底层按键处理逻辑值得参考。它基于readline和keypress事件，不仅支持多按键捕获，还封装了诸如光标移动、选择菜单等交互逻辑，核心也是通过维护按键状态集合来实现多按键监听。

注意事项 #

部分终端会拦截某些组合键（如Alt+Tab、Win键），这类按键无法被Node.js应用捕获，需要测试目标终端环境的兼容性。

内容的提问来源于stack exchange，提问作者Bawbak