| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270 |
- /**
- * @license Copyright (c) 2003-2020, CKSource - Frederico Knabben. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
- import env from '../src/env';
- import {
- keyCodes,
- getCode,
- parseKeystroke,
- getEnvKeystrokeText,
- isArrowKeyCode,
- isForwardArrowKeyCode,
- getLocalizedArrowKeyCodeDirection
- } from '../src/keyboard';
- import { expectToThrowCKEditorError } from './_utils/utils';
- describe( 'Keyboard', () => {
- describe( 'keyCodes', () => {
- it( 'contains numbers', () => {
- expect( keyCodes[ '0' ] ).to.equal( 48 );
- expect( keyCodes[ '9' ] ).to.equal( 57 );
- } );
- it( 'contains letters', () => {
- expect( keyCodes.a ).to.equal( 65 );
- expect( keyCodes.z ).to.equal( 90 );
- } );
- it( 'modifiers and other keys', () => {
- expect( keyCodes.delete ).to.equal( 46 );
- expect( keyCodes.ctrl ).to.equal( 0x110000 );
- expect( keyCodes.cmd ).to.equal( 0x110000 );
- expect( keyCodes.f1 ).to.equal( 112 );
- expect( keyCodes.f12 ).to.equal( 123 );
- expect( keyCodes ).to.include.keys(
- 'ctrl', 'cmd', 'shift', 'alt',
- 'arrowleft', 'arrowup', 'arrowright', 'arrowdown',
- 'backspace', 'delete', 'enter', 'space', 'esc', 'tab',
- 'f1', 'f2', 'f3', 'f4', 'f5', 'f6', 'f7', 'f8', 'f9', 'f10', 'f11', 'f12'
- );
- } );
- } );
- describe( 'getCode', () => {
- it( 'gets code of a number', () => {
- expect( getCode( '0' ) ).to.equal( 48 );
- } );
- it( 'gets code of a letter', () => {
- expect( getCode( 'a' ) ).to.equal( 65 );
- } );
- it( 'gets code of a function key', () => {
- expect( getCode( 'f6' ) ).to.equal( 117 );
- } );
- it( 'is case insensitive', () => {
- expect( getCode( 'A' ) ).to.equal( 65 );
- expect( getCode( 'Ctrl' ) ).to.equal( 0x110000 );
- expect( getCode( 'ENTER' ) ).to.equal( 13 );
- } );
- it( 'throws when passed unknown key name', () => {
- expectToThrowCKEditorError( () => {
- getCode( 'foo' );
- }, /^keyboard-unknown-key:/, null );
- } );
- it( 'gets code of a keystroke info', () => {
- expect( getCode( { keyCode: 48 } ) ).to.equal( 48 );
- } );
- it( 'adds modifiers to the keystroke code', () => {
- expect( getCode( { keyCode: 48, altKey: true, ctrlKey: true, shiftKey: true } ) )
- .to.equal( 48 + 0x110000 + 0x220000 + 0x440000 );
- } );
- } );
- describe( 'parseKeystroke', () => {
- it( 'parses string', () => {
- expect( parseKeystroke( 'ctrl+a' ) ).to.equal( 0x110000 + 65 );
- } );
- it( 'allows spacing', () => {
- expect( parseKeystroke( 'ctrl + a' ) ).to.equal( 0x110000 + 65 );
- } );
- it( 'is case-insensitive', () => {
- expect( parseKeystroke( 'Ctrl+A' ) ).to.equal( 0x110000 + 65 );
- } );
- it( 'works with an array', () => {
- expect( parseKeystroke( [ 'ctrl', 'a' ] ) ).to.equal( 0x110000 + 65 );
- } );
- it( 'works with an array which contains numbers', () => {
- expect( parseKeystroke( [ 'shift', 33 ] ) ).to.equal( 0x220000 + 33 );
- } );
- it( 'works with two modifiers', () => {
- expect( parseKeystroke( 'ctrl+shift+a' ) ).to.equal( 0x110000 + 0x220000 + 65 );
- } );
- it( 'throws on unknown name', () => {
- expectToThrowCKEditorError( () => {
- parseKeystroke( 'foo' );
- }, /^keyboard-unknown-key:/, null );
- } );
- } );
- describe( 'getEnvKeystrokeText', () => {
- const initialEnvMac = env.isMac;
- afterEach( () => {
- env.isMac = initialEnvMac;
- } );
- describe( 'on Macintosh', () => {
- beforeEach( () => {
- env.isMac = true;
- } );
- it( 'replaces CTRL with ⌘', () => {
- expect( getEnvKeystrokeText( 'CTRL' ) ).to.equal( '⌘' );
- expect( getEnvKeystrokeText( 'CTRL+A' ) ).to.equal( '⌘A' );
- expect( getEnvKeystrokeText( 'ctrl+A' ) ).to.equal( '⌘A' );
- } );
- it( 'replaces SHIFT with ⇧', () => {
- expect( getEnvKeystrokeText( 'SHIFT' ) ).to.equal( '⇧' );
- expect( getEnvKeystrokeText( 'SHIFT+A' ) ).to.equal( '⇧A' );
- expect( getEnvKeystrokeText( 'shift+A' ) ).to.equal( '⇧A' );
- } );
- it( 'replaces ALT with ⌥', () => {
- expect( getEnvKeystrokeText( 'ALT' ) ).to.equal( '⌥' );
- expect( getEnvKeystrokeText( 'ALT+A' ) ).to.equal( '⌥A' );
- expect( getEnvKeystrokeText( 'alt+A' ) ).to.equal( '⌥A' );
- } );
- it( 'work for multiple modifiers', () => {
- expect( getEnvKeystrokeText( 'CTRL+SHIFT+X' ) ).to.equal( '⌘⇧X' );
- expect( getEnvKeystrokeText( 'ALT+SHIFT+X' ) ).to.equal( '⌥⇧X' );
- } );
- it( 'does not touch other keys', () => {
- expect( getEnvKeystrokeText( 'ESC+A' ) ).to.equal( 'ESC+A' );
- expect( getEnvKeystrokeText( 'TAB' ) ).to.equal( 'TAB' );
- expect( getEnvKeystrokeText( 'A' ) ).to.equal( 'A' );
- expect( getEnvKeystrokeText( 'A+CTRL+B' ) ).to.equal( 'A+⌘B' );
- } );
- } );
- describe( 'on non–Macintosh', () => {
- beforeEach( () => {
- env.isMac = false;
- } );
- it( 'does not touch anything', () => {
- expect( getEnvKeystrokeText( 'CTRL+A' ) ).to.equal( 'CTRL+A' );
- expect( getEnvKeystrokeText( 'ctrl+A' ) ).to.equal( 'ctrl+A' );
- expect( getEnvKeystrokeText( 'SHIFT+A' ) ).to.equal( 'SHIFT+A' );
- expect( getEnvKeystrokeText( 'alt+A' ) ).to.equal( 'alt+A' );
- expect( getEnvKeystrokeText( 'CTRL+SHIFT+A' ) ).to.equal( 'CTRL+SHIFT+A' );
- expect( getEnvKeystrokeText( 'A' ) ).to.equal( 'A' );
- } );
- } );
- } );
- describe( 'isArrowKeyCode()', () => {
- it( 'should return "true" for right arrow', () => {
- expect( isArrowKeyCode( keyCodes.arrowright ) ).to.be.true;
- } );
- it( 'should return "true" for left arrow', () => {
- expect( isArrowKeyCode( keyCodes.arrowleft ) ).to.be.true;
- } );
- it( 'should return "true" for up arrow', () => {
- expect( isArrowKeyCode( keyCodes.arrowup ) ).to.be.true;
- } );
- it( 'should return "true" for down arrow', () => {
- expect( isArrowKeyCode( keyCodes.arrowdown ) ).to.be.true;
- } );
- it( 'should return "false" for non-arrow keystrokes', () => {
- expect( isArrowKeyCode( keyCodes.a ) ).to.be.false;
- expect( isArrowKeyCode( keyCodes.ctrl ) ).to.be.false;
- } );
- } );
- describe( 'getLocalizedArrowKeyCodeDirection()', () => {
- describe( 'for a left–to–right content language direction', () => {
- it( 'should return "left" for left arrow', () => {
- expect( getLocalizedArrowKeyCodeDirection( keyCodes.arrowleft, 'ltr' ) ).to.equal( 'left' );
- } );
- it( 'should return "right" for right arrow', () => {
- expect( getLocalizedArrowKeyCodeDirection( keyCodes.arrowright, 'ltr' ) ).to.equal( 'right' );
- } );
- it( 'should return "up" for up arrow', () => {
- expect( getLocalizedArrowKeyCodeDirection( keyCodes.arrowup, 'ltr' ) ).to.equal( 'up' );
- } );
- it( 'should return "down" for down arrow', () => {
- expect( getLocalizedArrowKeyCodeDirection( keyCodes.arrowdown, 'ltr' ) ).to.equal( 'down' );
- } );
- } );
- describe( 'for a right-to-left content language direction', () => {
- it( 'should return "right" for left arrow', () => {
- expect( getLocalizedArrowKeyCodeDirection( keyCodes.arrowleft, 'rtl' ) ).to.equal( 'right' );
- } );
- it( 'should return "left" for right arrow', () => {
- expect( getLocalizedArrowKeyCodeDirection( keyCodes.arrowright, 'rtl' ) ).to.equal( 'left' );
- } );
- it( 'should return "up" for up arrow', () => {
- expect( getLocalizedArrowKeyCodeDirection( keyCodes.arrowup, 'rtl' ) ).to.equal( 'up' );
- } );
- it( 'should return "down" for down arrow', () => {
- expect( getLocalizedArrowKeyCodeDirection( keyCodes.arrowdown, 'rtl' ) ).to.equal( 'down' );
- } );
- } );
- } );
- describe( 'isForwardArrowKeyCode()', () => {
- describe( 'for a left–to–right content language direction', () => {
- it( 'should return "true" for down arrow', () => {
- expect( isForwardArrowKeyCode( keyCodes.arrowdown, 'ltr' ) ).to.be.true;
- } );
- it( 'should return "true" for right arrow', () => {
- expect( isForwardArrowKeyCode( keyCodes.arrowright, 'ltr' ) ).to.be.true;
- } );
- it( 'should return "false" for up arrow', () => {
- expect( isForwardArrowKeyCode( keyCodes.arrowup, 'ltr' ) ).to.be.false;
- } );
- it( 'should return "false" for left arrow', () => {
- expect( isForwardArrowKeyCode( keyCodes.arrowleft, 'ltr' ) ).to.be.false;
- } );
- } );
- describe( 'for a right-to-left content language direction', () => {
- it( 'should return "true" for down arrow', () => {
- expect( isForwardArrowKeyCode( keyCodes.arrowdown, 'rtl' ) ).to.be.true;
- } );
- it( 'should return "true" for left arrow', () => {
- expect( isForwardArrowKeyCode( keyCodes.arrowleft, 'rtl' ) ).to.be.true;
- } );
- it( 'should return "false" for up arrow', () => {
- expect( isForwardArrowKeyCode( keyCodes.arrowup, 'rtl' ) ).to.be.false;
- } );
- it( 'should return "false" for right arrow', () => {
- expect( isForwardArrowKeyCode( keyCodes.arrowright, 'rtl' ) ).to.be.false;
- } );
- } );
- } );
- } );
|