]>
git.proxmox.com Git - mirror_novnc.git/blob - tests/test.helper.js
1 var assert
= chai
.assert
;
2 var expect
= chai
.expect
;
4 import keysyms
from '../core/input/keysymdef.js';
5 import * as KeyboardUtil
from "../core/input/util.js";
7 describe('Helpers', function() {
10 describe('keysyms.lookup', function() {
11 it('should map ASCII characters to keysyms', function() {
12 expect(keysyms
.lookup('a'.charCodeAt())).to
.be
.equal(0x61);
13 expect(keysyms
.lookup('A'.charCodeAt())).to
.be
.equal(0x41);
15 it('should map Latin-1 characters to keysyms', function() {
16 expect(keysyms
.lookup('ø'.charCodeAt())).to
.be
.equal(0xf8);
18 expect(keysyms
.lookup('é'.charCodeAt())).to
.be
.equal(0xe9);
20 it('should map characters that are in Windows-1252 but not in Latin-1 to keysyms', function() {
21 expect(keysyms
.lookup('Š'.charCodeAt())).to
.be
.equal(0x01a9);
23 it('should map characters which aren\'t in Latin1 *or* Windows-1252 to keysyms', function() {
24 expect(keysyms
.lookup('ũ'.charCodeAt())).to
.be
.equal(0x03fd);
26 it('should map unknown codepoints to the Unicode range', function() {
27 expect(keysyms
.lookup('\n'.charCodeAt())).to
.be
.equal(0x100000a);
28 expect(keysyms
.lookup('\u262D'.charCodeAt())).to
.be
.equal(0x100262d);
30 // This requires very recent versions of most browsers... skipping for now
31 it
.skip('should map UCS-4 codepoints to the Unicode range', function() {
32 //expect(keysyms.lookup('\u{1F686}'.codePointAt())).to.be.equal(0x101f686);
36 describe('getKeycode', function() {
37 it('should pass through proper code', function() {
38 expect(KeyboardUtil
.getKeycode({code
: 'Semicolon'})).to
.be
.equal('Semicolon');
40 it('should map legacy values', function() {
41 expect(KeyboardUtil
.getKeycode({code
: ''})).to
.be
.equal('Unidentified');
42 expect(KeyboardUtil
.getKeycode({code
: 'OSLeft'})).to
.be
.equal('MetaLeft');
44 it('should map keyCode to code when possible', function() {
45 expect(KeyboardUtil
.getKeycode({keyCode
: 0x14})).to
.be
.equal('CapsLock');
46 expect(KeyboardUtil
.getKeycode({keyCode
: 0x5b})).to
.be
.equal('MetaLeft');
47 expect(KeyboardUtil
.getKeycode({keyCode
: 0x35})).to
.be
.equal('Digit5');
48 expect(KeyboardUtil
.getKeycode({keyCode
: 0x65})).to
.be
.equal('Numpad5');
50 it('should map keyCode left/right side', function() {
51 expect(KeyboardUtil
.getKeycode({keyCode
: 0x10, location
: 1})).to
.be
.equal('ShiftLeft');
52 expect(KeyboardUtil
.getKeycode({keyCode
: 0x10, location
: 2})).to
.be
.equal('ShiftRight');
53 expect(KeyboardUtil
.getKeycode({keyCode
: 0x11, location
: 1})).to
.be
.equal('ControlLeft');
54 expect(KeyboardUtil
.getKeycode({keyCode
: 0x11, location
: 2})).to
.be
.equal('ControlRight');
56 it('should map keyCode on numpad', function() {
57 expect(KeyboardUtil
.getKeycode({keyCode
: 0x0d, location
: 0})).to
.be
.equal('Enter');
58 expect(KeyboardUtil
.getKeycode({keyCode
: 0x0d, location
: 3})).to
.be
.equal('NumpadEnter');
59 expect(KeyboardUtil
.getKeycode({keyCode
: 0x23, location
: 0})).to
.be
.equal('End');
60 expect(KeyboardUtil
.getKeycode({keyCode
: 0x23, location
: 3})).to
.be
.equal('Numpad1');
62 it('should return Unidentified when it cannot map the keyCode', function() {
63 expect(KeyboardUtil
.getKeycode({keycode
: 0x42})).to
.be
.equal('Unidentified');
66 describe('Fix Meta on macOS', function() {
68 beforeEach(function () {
69 // window.navigator is a protected read-only property in many
70 // environments, so we need to redefine it whilst running these
72 origNavigator
= Object
.getOwnPropertyDescriptor(window
, "navigator");
73 if (origNavigator
=== undefined) {
74 // Object.getOwnPropertyDescriptor() doesn't work
75 // properly in any version of IE
79 Object
.defineProperty(window
, "navigator", {value
: {}});
80 if (window
.navigator
.platform
!== undefined) {
81 // Object.defineProperty() doesn't work properly in old
86 window
.navigator
.platform
= "Mac x86_64";
88 afterEach(function () {
89 Object
.defineProperty(window
, "navigator", origNavigator
);
92 it('should respect ContextMenu on modern browser', function() {
93 expect(KeyboardUtil
.getKeycode({code
: 'ContextMenu', keyCode
: 0x5d})).to
.be
.equal('ContextMenu');
95 it('should translate legacy ContextMenu to MetaRight', function() {
96 expect(KeyboardUtil
.getKeycode({keyCode
: 0x5d})).to
.be
.equal('MetaRight');
101 describe('getKeysym', function() {
102 it('should prefer char', function() {
103 expect(KeyboardUtil
.getKeysym({char : 'a', charCode
: 'Š'.charCodeAt(), keyCode
: 0x42, which
: 0x43})).to
.be
.equal(0x61);
105 it('should use charCode if no char', function() {
106 expect(KeyboardUtil
.getKeysym({char : '', charCode
: 'Š'.charCodeAt(), keyCode
: 0x42, which
: 0x43})).to
.be
.equal(0x01a9);
107 expect(KeyboardUtil
.getKeysym({charCode
: 'Š'.charCodeAt(), keyCode
: 0x42, which
: 0x43})).to
.be
.equal(0x01a9);
108 expect(KeyboardUtil
.getKeysym({char : 'hello', charCode
: 'Š'.charCodeAt(), keyCode
: 0x42, which
: 0x43})).to
.be
.equal(0x01a9);
110 it('should use keyCode if no charCode', function() {
111 expect(KeyboardUtil
.getKeysym({keyCode
: 0x42, which
: 0x43, shiftKey
: false})).to
.be
.equal(0x62);
112 expect(KeyboardUtil
.getKeysym({keyCode
: 0x42, which
: 0x43, shiftKey
: true})).to
.be
.equal(0x42);
114 it('should return null for unknown keycodes', function() {
115 expect(KeyboardUtil
.getKeysym({keyCode
: 0xc0, which
: 0xc1, shiftKey
:false})).to
.be
.null;
116 expect(KeyboardUtil
.getKeysym({keyCode
: 0xde, which
: 0xdf, shiftKey
:false})).to
.be
.null;
118 it('should use which if no keyCode', function() {
119 expect(KeyboardUtil
.getKeysym({which
: 0x43, shiftKey
: false})).to
.be
.equal(0x63);
120 expect(KeyboardUtil
.getKeysym({which
: 0x43, shiftKey
: true})).to
.be
.equal(0x43);
123 describe('Non-character keys', function() {
124 it('should recognize the right keys', function() {
125 expect(KeyboardUtil
.getKeysym({keyCode
: 0x0d})).to
.be
.equal(0xFF0D);
126 expect(KeyboardUtil
.getKeysym({keyCode
: 0x08})).to
.be
.equal(0xFF08);
127 expect(KeyboardUtil
.getKeysym({keyCode
: 0x09})).to
.be
.equal(0xFF09);
128 expect(KeyboardUtil
.getKeysym({keyCode
: 0x10})).to
.be
.equal(0xFFE1);
129 expect(KeyboardUtil
.getKeysym({keyCode
: 0x11})).to
.be
.equal(0xFFE3);
130 expect(KeyboardUtil
.getKeysym({keyCode
: 0x12})).to
.be
.equal(0xFFE9);
131 expect(KeyboardUtil
.getKeysym({keyCode
: 0xe0})).to
.be
.equal(0xFFE7);
132 expect(KeyboardUtil
.getKeysym({keyCode
: 0xe1})).to
.be
.equal(0xFE03);
133 expect(KeyboardUtil
.getKeysym({keyCode
: 0x1b})).to
.be
.equal(0xFF1B);
134 expect(KeyboardUtil
.getKeysym({keyCode
: 0x26})).to
.be
.equal(0xFF52);
136 it('should not recognize character keys', function() {
137 expect(KeyboardUtil
.getKeysym({keyCode
: 'A'})).to
.be
.null;
138 expect(KeyboardUtil
.getKeysym({keyCode
: '1'})).to
.be
.null;
139 expect(KeyboardUtil
.getKeysym({keyCode
: '.'})).to
.be
.null;
140 expect(KeyboardUtil
.getKeysym({keyCode
: ' '})).to
.be
.null;
145 describe('Modifier Sync', function() { // return a list of fake events necessary to fix modifier state
146 describe('Toggle all modifiers', function() {
147 var sync
= KeyboardUtil
.ModifierSync();
148 it ('should do nothing if all modifiers are up as expected', function() {
149 expect(sync
.keydown({
156 ).to
.have
.lengthOf(0);
158 it ('should synthesize events if all keys are unexpectedly down', function() {
159 var result
= sync
.keydown({
167 expect(result
).to
.have
.lengthOf(5);
169 for (var i
= 0; i
< result
.length
; ++i
) {
170 keysyms
[result
[i
].keysym
] = (result
[i
].type
== 'keydown');
172 expect(keysyms
[0xffe3]);
173 expect(keysyms
[0xffe9]);
174 expect(keysyms
[0xfe03]);
175 expect(keysyms
[0xffe1]);
176 expect(keysyms
[0xffe7]);
178 it ('should do nothing if all modifiers are down as expected', function() {
179 expect(sync
.keydown({
186 })).to
.have
.lengthOf(0);
189 describe('Toggle Ctrl', function() {
190 var sync
= KeyboardUtil
.ModifierSync();
191 it('should sync if modifier is suddenly down', function() {
192 expect(sync
.keydown({
195 })).to
.be
.deep
.equal([{keysym
: 0xffe3, type
: 'keydown'}]);
197 it('should sync if modifier is suddenly up', function() {
198 expect(sync
.keydown({
201 })).to
.be
.deep
.equal([{keysym
: 0xffe3, type
: 'keyup'}]);
204 describe('Toggle Alt', function() {
205 var sync
= KeyboardUtil
.ModifierSync();
206 it('should sync if modifier is suddenly down', function() {
207 expect(sync
.keydown({
210 })).to
.be
.deep
.equal([{keysym
: 0xffe9, type
: 'keydown'}]);
212 it('should sync if modifier is suddenly up', function() {
213 expect(sync
.keydown({
216 })).to
.be
.deep
.equal([{keysym
: 0xffe9, type
: 'keyup'}]);
219 describe('Toggle AltGr', function() {
220 var sync
= KeyboardUtil
.ModifierSync();
221 it('should sync if modifier is suddenly down', function() {
222 expect(sync
.keydown({
225 })).to
.be
.deep
.equal([{keysym
: 0xfe03, type
: 'keydown'}]);
227 it('should sync if modifier is suddenly up', function() {
228 expect(sync
.keydown({
231 })).to
.be
.deep
.equal([{keysym
: 0xfe03, type
: 'keyup'}]);
234 describe('Toggle Shift', function() {
235 var sync
= KeyboardUtil
.ModifierSync();
236 it('should sync if modifier is suddenly down', function() {
237 expect(sync
.keydown({
240 })).to
.be
.deep
.equal([{keysym
: 0xffe1, type
: 'keydown'}]);
242 it('should sync if modifier is suddenly up', function() {
243 expect(sync
.keydown({
246 })).to
.be
.deep
.equal([{keysym
: 0xffe1, type
: 'keyup'}]);
249 describe('Toggle Meta', function() {
250 var sync
= KeyboardUtil
.ModifierSync();
251 it('should sync if modifier is suddenly down', function() {
252 expect(sync
.keydown({
255 })).to
.be
.deep
.equal([{keysym
: 0xffe7, type
: 'keydown'}]);
257 it('should sync if modifier is suddenly up', function() {
258 expect(sync
.keydown({
261 })).to
.be
.deep
.equal([{keysym
: 0xffe7, type
: 'keyup'}]);
264 describe('Modifier keyevents', function() {
265 it('should not sync a modifier on its own events', function() {
266 expect(KeyboardUtil
.ModifierSync().keydown({
269 })).to
.be
.deep
.equal([]);
270 expect(KeyboardUtil
.ModifierSync().keydown({
273 }), 'B').to
.be
.deep
.equal([]);
275 it('should update state on modifier keyevents', function() {
276 var sync
= KeyboardUtil
.ModifierSync();
280 expect(sync
.keydown({
283 })).to
.be
.deep
.equal([]);
285 it('should sync other modifiers on ctrl events', function() {
286 expect(KeyboardUtil
.ModifierSync().keydown({
289 })).to
.be
.deep
.equal([{keysym
: 0xffe9, type
: 'keydown'}]);
292 describe('sync modifiers on non-key events', function() {
293 it('should generate sync events when receiving non-keyboard events', function() {
294 expect(KeyboardUtil
.ModifierSync().syncAny({
296 })).to
.be
.deep
.equal([{keysym
: 0xffe9, type
: 'keydown'}]);
299 describe('do not treat shift as a modifier key', function() {
300 it('should not treat shift as a shortcut modifier', function() {
301 expect(KeyboardUtil
.hasShortcutModifier([], {0xffe1 : true})).to
.be
.false;
303 it('should not treat shift as a char modifier', function() {
304 expect(KeyboardUtil
.hasCharModifier([], {0xffe1 : true})).to
.be
.false;