]>
Commit | Line | Data |
---|---|---|
bd5340c7 | 1 | // requires local modules: input/keysym, input/keysymdef, input/util |
31f169e8 SR |
2 | |
3 | var assert = chai.assert; | |
f00b6fb6 | 4 | var expect = chai.expect; |
5 | ||
6 | describe('Helpers', function() { | |
7 | "use strict"; | |
8 | describe('keysymFromKeyCode', function() { | |
9 | it('should map known keycodes to keysyms', function() { | |
ae510306 SR |
10 | expect(KeyboardUtil.keysymFromKeyCode(0x41, false), 'a').to.be.equal(0x61); |
11 | expect(KeyboardUtil.keysymFromKeyCode(0x41, true), 'A').to.be.equal(0x41); | |
12 | expect(KeyboardUtil.keysymFromKeyCode(0xd, false), 'enter').to.be.equal(0xFF0D); | |
13 | expect(KeyboardUtil.keysymFromKeyCode(0x11, false), 'ctrl').to.be.equal(0xFFE3); | |
14 | expect(KeyboardUtil.keysymFromKeyCode(0x12, false), 'alt').to.be.equal(0xFFE9); | |
15 | expect(KeyboardUtil.keysymFromKeyCode(0xe1, false), 'altgr').to.be.equal(0xFE03); | |
16 | expect(KeyboardUtil.keysymFromKeyCode(0x1b, false), 'esc').to.be.equal(0xFF1B); | |
17 | expect(KeyboardUtil.keysymFromKeyCode(0x26, false), 'up').to.be.equal(0xFF52); | |
f00b6fb6 | 18 | }); |
19 | it('should return null for unknown keycodes', function() { | |
ae510306 SR |
20 | expect(KeyboardUtil.keysymFromKeyCode(0xc0, false), 'DK æ').to.be.null; |
21 | expect(KeyboardUtil.keysymFromKeyCode(0xde, false), 'DK ø').to.be.null; | |
f00b6fb6 | 22 | }); |
23 | }); | |
24 | ||
25 | describe('keysyms.fromUnicode', function() { | |
26 | it('should map ASCII characters to keysyms', function() { | |
27 | expect(keysyms.fromUnicode('a'.charCodeAt())).to.have.property('keysym', 0x61); | |
28 | expect(keysyms.fromUnicode('A'.charCodeAt())).to.have.property('keysym', 0x41); | |
29 | }); | |
30 | it('should map Latin-1 characters to keysyms', function() { | |
31 | expect(keysyms.fromUnicode('ø'.charCodeAt())).to.have.property('keysym', 0xf8); | |
32 | ||
33 | expect(keysyms.fromUnicode('é'.charCodeAt())).to.have.property('keysym', 0xe9); | |
34 | }); | |
35 | it('should map characters that are in Windows-1252 but not in Latin-1 to keysyms', function() { | |
36 | expect(keysyms.fromUnicode('Š'.charCodeAt())).to.have.property('keysym', 0x01a9); | |
37 | }); | |
38 | it('should map characters which aren\'t in Latin1 *or* Windows-1252 to keysyms', function() { | |
39 | expect(keysyms.fromUnicode('ŵ'.charCodeAt())).to.have.property('keysym', 0x1000175); | |
40 | }); | |
115eedf6 PO |
41 | it('should map unknown codepoints to the Unicode range', function() { |
42 | expect(keysyms.fromUnicode('\n'.charCodeAt())).to.have.property('keysym', 0x100000a); | |
e9ddbec5 SM |
43 | expect(keysyms.fromUnicode('\u262D'.charCodeAt())).to.have.property('keysym', 0x100262d); |
44 | }); | |
331ae153 SM |
45 | // This requires very recent versions of most browsers... skipping for now |
46 | it.skip('should map UCS-4 codepoints to the Unicode range', function() { | |
80b7dde6 | 47 | //expect(keysyms.fromUnicode('\u{1F686}'.codePointAt())).to.have.property('keysym', 0x101f686); |
f00b6fb6 | 48 | }); |
49 | }); | |
50 | ||
466a09f0 | 51 | describe('substituteCodepoint', function() { |
52 | it('should replace characters which don\'t have a keysym', function() { | |
ae510306 SR |
53 | expect(KeyboardUtil.substituteCodepoint('Ș'.charCodeAt())).to.equal('Ş'.charCodeAt()); |
54 | expect(KeyboardUtil.substituteCodepoint('ș'.charCodeAt())).to.equal('ş'.charCodeAt()); | |
55 | expect(KeyboardUtil.substituteCodepoint('Ț'.charCodeAt())).to.equal('Ţ'.charCodeAt()); | |
56 | expect(KeyboardUtil.substituteCodepoint('ț'.charCodeAt())).to.equal('ţ'.charCodeAt()); | |
466a09f0 | 57 | }); |
58 | it('should pass other characters through unchanged', function() { | |
ae510306 | 59 | expect(KeyboardUtil.substituteCodepoint('T'.charCodeAt())).to.equal('T'.charCodeAt()); |
466a09f0 | 60 | }); |
61 | }); | |
62 | ||
f00b6fb6 | 63 | describe('nonCharacterKey', function() { |
64 | it('should recognize the right keys', function() { | |
ae510306 SR |
65 | expect(KeyboardUtil.nonCharacterKey({keyCode: 0xd}), 'enter').to.be.defined; |
66 | expect(KeyboardUtil.nonCharacterKey({keyCode: 0x08}), 'backspace').to.be.defined; | |
67 | expect(KeyboardUtil.nonCharacterKey({keyCode: 0x09}), 'tab').to.be.defined; | |
68 | expect(KeyboardUtil.nonCharacterKey({keyCode: 0x10}), 'shift').to.be.defined; | |
69 | expect(KeyboardUtil.nonCharacterKey({keyCode: 0x11}), 'ctrl').to.be.defined; | |
70 | expect(KeyboardUtil.nonCharacterKey({keyCode: 0x12}), 'alt').to.be.defined; | |
71 | expect(KeyboardUtil.nonCharacterKey({keyCode: 0xe0}), 'meta').to.be.defined; | |
f00b6fb6 | 72 | }); |
73 | it('should not recognize character keys', function() { | |
ae510306 SR |
74 | expect(KeyboardUtil.nonCharacterKey({keyCode: 'A'}), 'A').to.be.null; |
75 | expect(KeyboardUtil.nonCharacterKey({keyCode: '1'}), '1').to.be.null; | |
76 | expect(KeyboardUtil.nonCharacterKey({keyCode: '.'}), '.').to.be.null; | |
77 | expect(KeyboardUtil.nonCharacterKey({keyCode: ' '}), 'space').to.be.null; | |
f00b6fb6 | 78 | }); |
79 | }); | |
80 | ||
81 | describe('getKeysym', function() { | |
82 | it('should prefer char', function() { | |
ae510306 | 83 | expect(KeyboardUtil.getKeysym({char : 'a', charCode: 'Š'.charCodeAt(), keyCode: 0x42, which: 0x43})).to.have.property('keysym', 0x61); |
f00b6fb6 | 84 | }); |
85 | it('should use charCode if no char', function() { | |
ae510306 SR |
86 | expect(KeyboardUtil.getKeysym({char : '', charCode: 'Š'.charCodeAt(), keyCode: 0x42, which: 0x43})).to.have.property('keysym', 0x01a9); |
87 | expect(KeyboardUtil.getKeysym({charCode: 'Š'.charCodeAt(), keyCode: 0x42, which: 0x43})).to.have.property('keysym', 0x01a9); | |
88 | expect(KeyboardUtil.getKeysym({char : 'hello', charCode: 'Š'.charCodeAt(), keyCode: 0x42, which: 0x43})).to.have.property('keysym', 0x01a9); | |
f00b6fb6 | 89 | }); |
90 | it('should use keyCode if no charCode', function() { | |
ae510306 SR |
91 | expect(KeyboardUtil.getKeysym({keyCode: 0x42, which: 0x43, shiftKey: false})).to.have.property('keysym', 0x62); |
92 | expect(KeyboardUtil.getKeysym({keyCode: 0x42, which: 0x43, shiftKey: true})).to.have.property('keysym', 0x42); | |
f00b6fb6 | 93 | }); |
94 | it('should use which if no keyCode', function() { | |
ae510306 SR |
95 | expect(KeyboardUtil.getKeysym({which: 0x43, shiftKey: false})).to.have.property('keysym', 0x63); |
96 | expect(KeyboardUtil.getKeysym({which: 0x43, shiftKey: true})).to.have.property('keysym', 0x43); | |
f00b6fb6 | 97 | }); |
466a09f0 | 98 | it('should substitute where applicable', function() { |
ae510306 | 99 | expect(KeyboardUtil.getKeysym({char : 'Ș'})).to.have.property('keysym', 0x1aa); |
466a09f0 | 100 | }); |
f00b6fb6 | 101 | }); |
102 | ||
103 | describe('Modifier Sync', function() { // return a list of fake events necessary to fix modifier state | |
104 | describe('Toggle all modifiers', function() { | |
ae510306 | 105 | var sync = KeyboardUtil.ModifierSync(); |
f00b6fb6 | 106 | it ('should do nothing if all modifiers are up as expected', function() { |
107 | expect(sync.keydown({ | |
108 | keyCode: 0x41, | |
109 | ctrlKey: false, | |
110 | altKey: false, | |
111 | altGraphKey: false, | |
112 | shiftKey: false, | |
113 | metaKey: false}) | |
114 | ).to.have.lengthOf(0); | |
115 | }); | |
116 | it ('should synthesize events if all keys are unexpectedly down', function() { | |
117 | var result = sync.keydown({ | |
118 | keyCode: 0x41, | |
119 | ctrlKey: true, | |
120 | altKey: true, | |
121 | altGraphKey: true, | |
122 | shiftKey: true, | |
123 | metaKey: true | |
124 | }); | |
125 | expect(result).to.have.lengthOf(5); | |
126 | var keysyms = {}; | |
127 | for (var i = 0; i < result.length; ++i) { | |
128 | keysyms[result[i].keysym] = (result[i].type == 'keydown'); | |
129 | } | |
130 | expect(keysyms[0xffe3]); | |
131 | expect(keysyms[0xffe9]); | |
132 | expect(keysyms[0xfe03]); | |
133 | expect(keysyms[0xffe1]); | |
134 | expect(keysyms[0xffe7]); | |
135 | }); | |
136 | it ('should do nothing if all modifiers are down as expected', function() { | |
137 | expect(sync.keydown({ | |
138 | keyCode: 0x41, | |
139 | ctrlKey: true, | |
140 | altKey: true, | |
141 | altGraphKey: true, | |
142 | shiftKey: true, | |
143 | metaKey: true | |
144 | })).to.have.lengthOf(0); | |
145 | }); | |
146 | }); | |
147 | describe('Toggle Ctrl', function() { | |
ae510306 | 148 | var sync = KeyboardUtil.ModifierSync(); |
f00b6fb6 | 149 | it('should sync if modifier is suddenly down', function() { |
150 | expect(sync.keydown({ | |
151 | keyCode: 0x41, | |
152 | ctrlKey: true, | |
153 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe3), type: 'keydown'}]); | |
154 | }); | |
155 | it('should sync if modifier is suddenly up', function() { | |
156 | expect(sync.keydown({ | |
157 | keyCode: 0x41, | |
158 | ctrlKey: false | |
159 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe3), type: 'keyup'}]); | |
160 | }); | |
161 | }); | |
162 | describe('Toggle Alt', function() { | |
ae510306 | 163 | var sync = KeyboardUtil.ModifierSync(); |
f00b6fb6 | 164 | it('should sync if modifier is suddenly down', function() { |
165 | expect(sync.keydown({ | |
166 | keyCode: 0x41, | |
167 | altKey: true, | |
168 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe9), type: 'keydown'}]); | |
169 | }); | |
170 | it('should sync if modifier is suddenly up', function() { | |
171 | expect(sync.keydown({ | |
172 | keyCode: 0x41, | |
173 | altKey: false | |
174 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe9), type: 'keyup'}]); | |
175 | }); | |
176 | }); | |
177 | describe('Toggle AltGr', function() { | |
ae510306 | 178 | var sync = KeyboardUtil.ModifierSync(); |
f00b6fb6 | 179 | it('should sync if modifier is suddenly down', function() { |
180 | expect(sync.keydown({ | |
181 | keyCode: 0x41, | |
182 | altGraphKey: true, | |
183 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xfe03), type: 'keydown'}]); | |
184 | }); | |
185 | it('should sync if modifier is suddenly up', function() { | |
186 | expect(sync.keydown({ | |
187 | keyCode: 0x41, | |
188 | altGraphKey: false | |
189 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xfe03), type: 'keyup'}]); | |
190 | }); | |
191 | }); | |
192 | describe('Toggle Shift', function() { | |
ae510306 | 193 | var sync = KeyboardUtil.ModifierSync(); |
f00b6fb6 | 194 | it('should sync if modifier is suddenly down', function() { |
195 | expect(sync.keydown({ | |
196 | keyCode: 0x41, | |
197 | shiftKey: true, | |
198 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe1), type: 'keydown'}]); | |
199 | }); | |
200 | it('should sync if modifier is suddenly up', function() { | |
201 | expect(sync.keydown({ | |
202 | keyCode: 0x41, | |
203 | shiftKey: false | |
204 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe1), type: 'keyup'}]); | |
205 | }); | |
206 | }); | |
207 | describe('Toggle Meta', function() { | |
ae510306 | 208 | var sync = KeyboardUtil.ModifierSync(); |
f00b6fb6 | 209 | it('should sync if modifier is suddenly down', function() { |
210 | expect(sync.keydown({ | |
211 | keyCode: 0x41, | |
212 | metaKey: true, | |
213 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe7), type: 'keydown'}]); | |
214 | }); | |
215 | it('should sync if modifier is suddenly up', function() { | |
216 | expect(sync.keydown({ | |
217 | keyCode: 0x41, | |
218 | metaKey: false | |
219 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe7), type: 'keyup'}]); | |
220 | }); | |
221 | }); | |
222 | describe('Modifier keyevents', function() { | |
223 | it('should not sync a modifier on its own events', function() { | |
ae510306 | 224 | expect(KeyboardUtil.ModifierSync().keydown({ |
f00b6fb6 | 225 | keyCode: 0x11, |
226 | ctrlKey: false | |
227 | })).to.be.deep.equal([]); | |
ae510306 | 228 | expect(KeyboardUtil.ModifierSync().keydown({ |
f00b6fb6 | 229 | keyCode: 0x11, |
230 | ctrlKey: true | |
231 | }), 'B').to.be.deep.equal([]); | |
232 | }) | |
233 | it('should update state on modifier keyevents', function() { | |
ae510306 | 234 | var sync = KeyboardUtil.ModifierSync(); |
f00b6fb6 | 235 | sync.keydown({ |
236 | keyCode: 0x11, | |
237 | }); | |
238 | expect(sync.keydown({ | |
239 | keyCode: 0x41, | |
240 | ctrlKey: true, | |
241 | })).to.be.deep.equal([]); | |
242 | }); | |
243 | it('should sync other modifiers on ctrl events', function() { | |
ae510306 | 244 | expect(KeyboardUtil.ModifierSync().keydown({ |
f00b6fb6 | 245 | keyCode: 0x11, |
246 | altKey: true | |
247 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe9), type: 'keydown'}]); | |
248 | }) | |
249 | }); | |
250 | describe('sync modifiers on non-key events', function() { | |
251 | it('should generate sync events when receiving non-keyboard events', function() { | |
ae510306 | 252 | expect(KeyboardUtil.ModifierSync().syncAny({ |
f00b6fb6 | 253 | altKey: true |
254 | })).to.be.deep.equal([{keysym: keysyms.lookup(0xffe9), type: 'keydown'}]); | |
255 | }); | |
256 | }); | |
f6a1d98a JD |
257 | describe('do not treat shift as a modifier key', function() { |
258 | it('should not treat shift as a shortcut modifier', function() { | |
ae510306 | 259 | expect(KeyboardUtil.hasShortcutModifier([], {0xffe1 : true})).to.be.false; |
f6a1d98a JD |
260 | }); |
261 | it('should not treat shift as a char modifier', function() { | |
ae510306 | 262 | expect(KeyboardUtil.hasCharModifier([], {0xffe1 : true})).to.be.false; |
f6a1d98a JD |
263 | }); |
264 | }); | |
f00b6fb6 | 265 | }); |
266 | }); |