Electron中如何模拟系统级键盘事件？（macOS环境）

Hey there! Let's figure out how to make your Electron app trigger system-wide keyboard shortcuts like Cmd+Tab and Cmd+Q on macOS—since you mentioned BrowserWindow.webContents.sendInputEvent and robotjs didn't work, let's break down why and fix this.

Why Your Previous Attempts Failed #

• sendInputEvent: This only sends events to the Electron app's web content layer (your React frontend), not the operating system. It can't trigger system-level shortcuts like Cmd+Tab that are handled by macOS itself.
• robotjs: On macOS, this library often runs into permission issues (it needs Accessibility privileges) or conflicts with Electron's sandboxing (especially in boilerplates like electron-react-boilerplate, which enables sandbox by default). Even if you fix permissions, you might need to rebuild the library for your specific Electron version, which adds extra steps.

The Most Reliable Solution: AppleScript via child_process #

macOS has native support for system automation through AppleScript, and Electron can run these scripts directly using Node's child_process module. This method bypasses Electron's web layer and interacts directly with the OS, making it perfect for your needs.

Step 1: Add the Script Execution Logic #

In your React component (where your buttons live), import exec from child_process and create functions to trigger the shortcuts:

import { exec } from 'child_process';

// Trigger Cmd+Tab to switch apps
const triggerCmdTab = () => {
  const appleScript = `
    tell application "System Events"
      key down command
      keystroke tab
      key up command
    end tell
  `;
  // Clean up newlines for the osascript command
  const formattedScript = appleScript.replace(/\n/g, ' ');
  exec(`osascript -e '${formattedScript}'`, (error, stdout, stderr) => {
    if (error) {
      console.error(`Failed to trigger Cmd+Tab: ${error.message}`);
      return;
    }
    if (stderr) {
      console.error(`Script error: ${stderr}`);
      return;
    }
    console.log('Cmd+Tab triggered successfully');
  });
};

// Trigger Cmd+Q to quit the active app
const triggerCmdQ = () => {
  const appleScript = `
    tell application "System Events"
      keystroke "q" using command down
    end tell
  `;
  const formattedScript = appleScript.replace(/\n/g, ' ');
  exec(`osascript -e '${formattedScript}'`, (error) => {
    if (error) console.error(`Failed to trigger Cmd+Q: ${error.message}`);
    else console.log('Cmd+Q triggered successfully');
  });
};

// Trigger Cmd+Tab multiple times (e.g., switch 3 apps forward)
const triggerCmdTabMultiple = (count = 3) => {
  let tabKeystrokes = '';
  for (let i = 0; i < count; i++) {
    tabKeystrokes += 'keystroke tab\n      ';
  }
  const appleScript = `
    tell application "System Events"
      key down command
      ${tabKeystrokes}
      key up command
    end tell
  `;
  const formattedScript = appleScript.replace(/\n/g, ' ');
  exec(`osascript -e '${formattedScript}'`, (error) => {
    if (error) console.error(`Failed to trigger multiple Cmd+Tab: ${error.message}`);
  });
};

Step 2: Add Buttons to Trigger the Functions #

Wire up these functions to your React buttons:

function App() {
  return (
    <div className="App">
      <button onClick={triggerCmdTab}>Switch Apps (Cmd+Tab)</button>
      <button onClick={() => triggerCmdTabMultiple(2)}>Switch 2 Apps Forward</button>
      <button onClick={triggerCmdQ}>Quit Active App (Cmd+Q)</button>
    </div>
  );
}

export default App;

Step 3: Grant Accessibility Permissions #

macOS requires your app to have Accessibility privileges to run these scripts. Here's how to enable them:

1. Open System Settings → Privacy & Security → Accessibility
2. Find your Electron app in the list (it might be named after your project)
3. Toggle the switch to allow access. If it's not listed, run your app first, then check again.

Alternative: Fixing robotjs (If You Prefer a Node Library) #

If you want to stick with robotjs, you'll need to resolve two key issues:

1. Disable Electron Sandbox: In your electron-builder config (usually in package.json or electron-builder.yml), add:

   "build": {
     "electronVersion": "<your-electron-version>",
     "mac": {
       "sandbox": false
     }
   }
   

2. Rebuild robotjs for Electron: Since Electron uses its own Node.js version, you need to rebuild the library to match:

   # Install electron-rebuild if you don't have it
   npm install --save-dev electron-rebuild
   # Rebuild robotjs
   npx electron-rebuild
   

3. Grant Accessibility Permissions: Same as the AppleScript method—enable your app in System Settings → Privacy & Security → Accessibility.

Then you can use robotjs like this:

const robot = require('robotjs');

const triggerCmdTab = () => {
  robot.keyToggle('command', 'down');
  robot.keyTap('tab');
  robot.keyToggle('command', 'up');
};

Final Notes #

• The AppleScript method is more reliable for macOS because it's native and avoids Node library compatibility issues.
• Always handle errors in your script execution—users might not have granted permissions, which will cause the commands to fail silently otherwise.

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