feat: implement getPressedKeyString for #360, #377 (#394)

README.md

@@ -330,6 +330,17 @@ hotkeys('command+ctrl+shift+a,f', function(){
 })
 ```
 
+
+### getPressedKeyStrings
+
+Returns an array of key codes currently pressed.
+
+```js
+hotkeys('command+ctrl+shift+a,f', function(){
+  console.log(hotkeys.getPressedKeyString()); //=> ['⌘', '⌃', '⇧', 'A', 'F']
+})
+```
+
 ### filter
 
 By default hotkeys are not enabled for `INPUT` `SELECT` `TEXTAREA` elements. `Hotkeys.filter` to return to the `true` shortcut keys set to play a role, `false` shortcut keys set up failure.

dist/hotkeys.common.js

@@ -167,6 +167,18 @@ var elementHasBindEvent = []; // 已绑定事件的节点记录
 
 var code = function code(x) {
   return _keyMap[x.toLowerCase()] || _modifier[x.toLowerCase()] || x.toUpperCase().charCodeAt(0);
+};
+
+var getKey = function getKey(x) {
+  return Object.keys(_keyMap).find(function (k) {
+    return _keyMap[k] === x;
+  });
+};
+
+var getModifier = function getModifier(x) {
+  return Object.keys(_modifier).find(function (k) {
+    return _modifier[k] === x;
+  });
 }; // 设置获取当前范围（默认为'所有'）
 
 
@@ -182,6 +194,12 @@ function getScope() {
 
 function getPressedKeyCodes() {
   return _downKeys.slice(0);
+}
+
+function getPressedKeyString() {
+  return _downKeys.map(function (c) {
+    return getKey(c) || getModifier(c) || String.fromCharCode(c);
+  });
 } // 表单控件控件判断 返回 Boolean
 // hotkey is effective only when filter return true
 
@@ -566,6 +584,7 @@ function trigger(shortcut) {
 }
 
 var _api = {
+  getPressedKeyString: getPressedKeyString,
   setScope: setScope,
   getScope: getScope,
   deleteScope: deleteScope,

dist/hotkeys.esm.js

@@ -165,6 +165,18 @@ var elementHasBindEvent = []; // 已绑定事件的节点记录
 
 var code = function code(x) {
   return _keyMap[x.toLowerCase()] || _modifier[x.toLowerCase()] || x.toUpperCase().charCodeAt(0);
+};
+
+var getKey = function getKey(x) {
+  return Object.keys(_keyMap).find(function (k) {
+    return _keyMap[k] === x;
+  });
+};
+
+var getModifier = function getModifier(x) {
+  return Object.keys(_modifier).find(function (k) {
+    return _modifier[k] === x;
+  });
 }; // 设置获取当前范围（默认为'所有'）
 
 
@@ -180,6 +192,12 @@ function getScope() {
 
 function getPressedKeyCodes() {
   return _downKeys.slice(0);
+}
+
+function getPressedKeyString() {
+  return _downKeys.map(function (c) {
+    return getKey(c) || getModifier(c) || String.fromCharCode(c);
+  });
 } // 表单控件控件判断 返回 Boolean
 // hotkey is effective only when filter return true
 
@@ -564,6 +582,7 @@ function trigger(shortcut) {
 }
 
 var _api = {
+  getPressedKeyString: getPressedKeyString,
   setScope: setScope,
   getScope: getScope,
   deleteScope: deleteScope,

dist/hotkeys.js

@@ -171,6 +171,18 @@
 
   var code = function code(x) {
     return _keyMap[x.toLowerCase()] || _modifier[x.toLowerCase()] || x.toUpperCase().charCodeAt(0);
+  };
+
+  var getKey = function getKey(x) {
+    return Object.keys(_keyMap).find(function (k) {
+      return _keyMap[k] === x;
+    });
+  };
+
+  var getModifier = function getModifier(x) {
+    return Object.keys(_modifier).find(function (k) {
+      return _modifier[k] === x;
+    });
   }; // 设置获取当前范围（默认为'所有'）
 
 
@@ -186,6 +198,12 @@
 
   function getPressedKeyCodes() {
     return _downKeys.slice(0);
+  }
+
+  function getPressedKeyString() {
+    return _downKeys.map(function (c) {
+      return getKey(c) || getModifier(c) || String.fromCharCode(c);
+    });
   } // 表单控件控件判断 返回 Boolean
   // hotkey is effective only when filter return true
 
@@ -570,6 +588,7 @@
   }
 
   var _api = {
+    getPressedKeyString: getPressedKeyString,
     setScope: setScope,
     getScope: getScope,
     deleteScope: deleteScope,

src/index.js

@@ -11,6 +11,9 @@ const code = (x) => _keyMap[x.toLowerCase()]
   || _modifier[x.toLowerCase()]
   || x.toUpperCase().charCodeAt(0);
 
+const getKey = (x) => Object.keys(_keyMap).find((k) => _keyMap[k] === x);
+const getModifier = (x) => Object.keys(_modifier).find((k) => _modifier[k] === x);
+
 // 设置获取当前范围（默认为'所有'）
 function setScope(scope) {
   _scope = scope || 'all';
@@ -24,6 +27,10 @@ function getPressedKeyCodes() {
   return _downKeys.slice(0);
 }
 
+function getPressedKeyString() {
+  return _downKeys.map((c) => getKey(c) || getModifier(c) || String.fromCharCode(c));
+}
+
 // 表单控件控件判断 返回 Boolean
 // hotkey is effective only when filter return true
 function filter(event) {
@@ -398,6 +405,7 @@ function trigger(shortcut, scope = 'all') {
 }
 
 const _api = {
+  getPressedKeyString,
   setScope,
   getScope,
   deleteScope,

test/run.test.js

@@ -107,6 +107,24 @@ describe('\n   Hotkeys.js Test Case222.\n', () => {
     await hotkeys.unbind('command+ctrl+shift+a');
   });
 
+  test('HotKeys getPressedKeyString Test Case', async () => {
+    let isExecuteFunction = false;
+    await hotkeys('command+ctrl+shift+a', (e) => {
+      isExecuteFunction = true;
+      expect(e.metaKey).toBeTruthy();
+      expect(e.ctrlKey).toBeTruthy();
+      expect(e.shiftKey).toBeTruthy();
+      expect(hotkeys.getPressedKeyString()).toEqual(['⇧', '⌃', 'A', '⌘']);
+    });
+    __triggerKeyboardEvent(document.body, 65, {
+      metaKey: true,
+      ctrlKey: true,
+      shiftKey: true,
+    });
+    expect(isExecuteFunction).toBeTruthy();
+    await hotkeys.unbind('command+ctrl+shift+a');
+  });
+
   test('HotKeys modifier scope,setScope,getScope,deleteScope Test Case', () => {
     let isExecuteFunction = false;
     __triggerKeyboardFocus(window);