clipboardobserver.js 7.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269
  1. /**
  2. * @license Copyright (c) 2003-2018, CKSource - Frederico Knabben. All rights reserved.
  3. * For licensing, see LICENSE.md.
  4. */
  5. /* globals document */
  6. import ClipboardObserver from '../src/clipboardobserver';
  7. import View from '@ckeditor/ckeditor5-engine/src/view/view';
  8. import Element from '@ckeditor/ckeditor5-engine/src/view/element';
  9. import Range from '@ckeditor/ckeditor5-engine/src/view/range';
  10. import Position from '@ckeditor/ckeditor5-engine/src/view/position';
  11. import DataTransfer from '../src/datatransfer';
  12. import createViewRoot from '@ckeditor/ckeditor5-engine/tests/view/_utils/createroot';
  13. describe( 'ClipboardObserver', () => {
  14. let view, doc, observer, root, el, range, eventSpy, preventDefaultSpy;
  15. beforeEach( () => {
  16. view = new View();
  17. doc = view.document;
  18. root = createViewRoot( doc );
  19. // Create view and DOM structures.
  20. el = new Element( 'p' );
  21. root.appendChildren( el );
  22. view.domConverter.viewToDom( root, document, { withChildren: true, bind: true } );
  23. doc.selection._setTo( el );
  24. range = new Range( new Position( root, 1 ) );
  25. // Just making sure that the following tests will check anything.
  26. expect( range.isEqual( doc.selection.getFirstRange() ) ).to.be.false;
  27. observer = view.addObserver( ClipboardObserver );
  28. eventSpy = sinon.spy();
  29. preventDefaultSpy = sinon.spy();
  30. } );
  31. it( 'should define domEventType', () => {
  32. expect( observer.domEventType ).to.deep.equal( [ 'paste', 'copy', 'cut', 'drop', 'dragover' ] );
  33. } );
  34. describe( 'paste event', () => {
  35. it( 'should be fired with the right event data', () => {
  36. const dataTransfer = mockDomDataTransfer();
  37. const targetElement = mockDomTargetElement( {} );
  38. doc.on( 'paste', eventSpy );
  39. observer.onDomEvent( {
  40. type: 'paste',
  41. target: targetElement,
  42. clipboardData: dataTransfer,
  43. preventDefault: preventDefaultSpy
  44. } );
  45. expect( eventSpy.calledOnce ).to.be.true;
  46. const data = eventSpy.args[ 0 ][ 1 ];
  47. expect( data.domTarget ).to.equal( targetElement );
  48. expect( data.dataTransfer ).to.be.instanceOf( DataTransfer );
  49. expect( data.dataTransfer.getData( 'x/y' ) ).to.equal( 'foo:x/y' );
  50. expect( preventDefaultSpy.calledOnce ).to.be.true;
  51. } );
  52. } );
  53. describe( 'drop event', () => {
  54. it( 'should be fired with the right event data - basics', () => {
  55. const dataTransfer = mockDomDataTransfer();
  56. const targetElement = mockDomTargetElement( {} );
  57. doc.on( 'drop', eventSpy );
  58. observer.onDomEvent( {
  59. type: 'drop',
  60. target: targetElement,
  61. dataTransfer,
  62. preventDefault: preventDefaultSpy
  63. } );
  64. expect( eventSpy.calledOnce ).to.be.true;
  65. const data = eventSpy.args[ 0 ][ 1 ];
  66. expect( data.domTarget ).to.equal( targetElement );
  67. expect( data.dataTransfer ).to.be.instanceOf( DataTransfer );
  68. expect( data.dataTransfer.getData( 'x/y' ) ).to.equal( 'foo:x/y' );
  69. expect( data.dropRange.isEqual( doc.selection.getFirstRange() ) ).to.be.true;
  70. expect( preventDefaultSpy.calledOnce ).to.be.true;
  71. } );
  72. it( 'should be fired with the right event data – dropRange (when no info about it in the drop event)', () => {
  73. const dataTransfer = mockDomDataTransfer();
  74. const targetElement = mockDomTargetElement( {} );
  75. doc.on( 'drop', eventSpy );
  76. observer.onDomEvent( {
  77. type: 'drop',
  78. target: targetElement,
  79. dataTransfer,
  80. preventDefault() {}
  81. } );
  82. expect( eventSpy.calledOnce ).to.be.true;
  83. const data = eventSpy.args[ 0 ][ 1 ];
  84. expect( data.dropRange.isEqual( doc.selection.getFirstRange() ) ).to.be.true;
  85. } );
  86. it( 'should be fired with the right event data – dropRange (when document.caretRangeFromPoint present)', () => {
  87. let caretRangeFromPointCalledWith;
  88. const domRange = view.domConverter.viewRangeToDom( range );
  89. const dataTransfer = mockDomDataTransfer();
  90. const targetElement = mockDomTargetElement( {
  91. caretRangeFromPoint( x, y ) {
  92. caretRangeFromPointCalledWith = [ x, y ];
  93. return domRange;
  94. }
  95. } );
  96. doc.on( 'drop', eventSpy );
  97. observer.onDomEvent( {
  98. type: 'drop',
  99. target: targetElement,
  100. dataTransfer,
  101. clientX: 10,
  102. clientY: 20,
  103. preventDefault() {}
  104. } );
  105. expect( eventSpy.calledOnce ).to.be.true;
  106. const data = eventSpy.args[ 0 ][ 1 ];
  107. expect( data.dropRange.isEqual( range ) ).to.be.true;
  108. expect( caretRangeFromPointCalledWith ).to.deep.equal( [ 10, 20 ] );
  109. } );
  110. it( 'should be fired with the right event data – dropRange (when evt.rangeParent|Offset present)', () => {
  111. const domRange = view.domConverter.viewRangeToDom( range );
  112. const dataTransfer = mockDomDataTransfer();
  113. const targetElement = mockDomTargetElement( {
  114. createRange() {
  115. return document.createRange();
  116. }
  117. } );
  118. doc.on( 'drop', eventSpy );
  119. observer.onDomEvent( {
  120. type: 'drop',
  121. target: targetElement,
  122. dataTransfer,
  123. rangeParent: domRange.startContainer,
  124. rangeOffset: domRange.startOffset,
  125. preventDefault() {}
  126. } );
  127. expect( eventSpy.calledOnce ).to.be.true;
  128. const data = eventSpy.args[ 0 ][ 1 ];
  129. expect( data.dropRange.isEqual( range ) ).to.be.true;
  130. } );
  131. } );
  132. describe( 'clipboardInput event', () => {
  133. it( 'should be fired on paste', () => {
  134. const dataTransfer = new DataTransfer( mockDomDataTransfer() );
  135. const normalPrioritySpy = sinon.spy();
  136. doc.on( 'clipboardInput', eventSpy );
  137. doc.on( 'paste', normalPrioritySpy );
  138. doc.fire( 'paste', {
  139. dataTransfer,
  140. preventDefault: preventDefaultSpy
  141. } );
  142. expect( eventSpy.calledOnce ).to.be.true;
  143. expect( preventDefaultSpy.calledOnce ).to.be.true;
  144. const data = eventSpy.args[ 0 ][ 1 ];
  145. expect( data.dataTransfer ).to.equal( dataTransfer );
  146. expect( data.targetRanges ).to.have.length( 1 );
  147. expect( data.targetRanges[ 0 ].isEqual( doc.selection.getFirstRange() ) ).to.be.true;
  148. expect( sinon.assert.callOrder( normalPrioritySpy, eventSpy ) );
  149. } );
  150. it( 'should be fired on drop', () => {
  151. const dataTransfer = new DataTransfer( mockDomDataTransfer() );
  152. const normalPrioritySpy = sinon.spy();
  153. doc.on( 'clipboardInput', eventSpy );
  154. doc.on( 'drop', normalPrioritySpy );
  155. doc.fire( 'drop', {
  156. dataTransfer,
  157. preventDefault: preventDefaultSpy,
  158. dropRange: range
  159. } );
  160. expect( eventSpy.calledOnce ).to.be.true;
  161. expect( preventDefaultSpy.calledOnce ).to.be.true;
  162. const data = eventSpy.args[ 0 ][ 1 ];
  163. expect( data.dataTransfer ).to.equal( dataTransfer );
  164. expect( data.targetRanges ).to.have.length( 1 );
  165. expect( data.targetRanges[ 0 ].isEqual( range ) ).to.be.true;
  166. expect( sinon.assert.callOrder( normalPrioritySpy, eventSpy ) );
  167. } );
  168. } );
  169. describe( 'dragover event', () => {
  170. it( 'should fire when a file is dragging over the document', () => {
  171. const targetElement = mockDomTargetElement( {} );
  172. const dataTransfer = mockDomDataTransfer();
  173. doc.on( 'dragover', eventSpy );
  174. observer.onDomEvent( {
  175. type: 'dragover',
  176. target: targetElement,
  177. dataTransfer
  178. } );
  179. expect( eventSpy.calledOnce ).to.equal( true );
  180. const data = eventSpy.args[ 0 ][ 1 ];
  181. expect( data.document ).to.equal( doc );
  182. expect( data.domTarget ).to.equal( targetElement );
  183. expect( data.domEvent.type ).to.equal( 'dragover' );
  184. expect( data.dataTransfer.files ).to.deep.equal( dataTransfer.files );
  185. } );
  186. } );
  187. } );
  188. // Returns a super simple mock of HTMLElement (we use only ownerDocument from it).
  189. function mockDomTargetElement( documentMock ) {
  190. return {
  191. ownerDocument: documentMock
  192. };
  193. }
  194. function mockDomDataTransfer() {
  195. return {
  196. files: [],
  197. getData( type ) {
  198. return 'foo:' + type;
  199. }
  200. };
  201. }