modelconversiondispatcher.js 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469
  1. /**
  2. * @license Copyright (c) 2003-2016, CKSource - Frederico Knabben. All rights reserved.
  3. * For licensing, see LICENSE.md.
  4. */
  5. /* bender-tags: conversion */
  6. import ModelConversionDispatcher from '/ckeditor5/engine/conversion/modelconversiondispatcher.js';
  7. import ModelDocument from '/ckeditor5/engine/model/document.js';
  8. import ModelText from '/ckeditor5/engine/model/text.js';
  9. import ModelElement from '/ckeditor5/engine/model/element.js';
  10. import ModelRange from '/ckeditor5/engine/model/range.js';
  11. import ModelPosition from '/ckeditor5/engine/model/position.js';
  12. import RemoveOperation from '/ckeditor5/engine/model/operation/removeoperation.js';
  13. import { wrapInDelta } from '/tests/engine/model/_utils/utils.js';
  14. describe( 'ModelConversionDispatcher', () => {
  15. let dispatcher, doc, root;
  16. beforeEach( () => {
  17. dispatcher = new ModelConversionDispatcher();
  18. doc = new ModelDocument();
  19. root = doc.createRoot();
  20. } );
  21. describe( 'constructor', () => {
  22. it( 'should create ModelConversionDispatcher with given api', () => {
  23. const apiObj = {};
  24. const dispatcher = new ModelConversionDispatcher( { apiObj } );
  25. expect( dispatcher.conversionApi.apiObj ).to.equal( apiObj );
  26. } );
  27. } );
  28. describe( 'convertChange', () => {
  29. // We will do integration tests here. Unit tests will be done for methods that are used
  30. // by `convertChange` internally. This way we will have two kinds of tests.
  31. let image, imagePos;
  32. beforeEach( () => {
  33. image = new ModelElement( 'image' );
  34. root.appendChildren( [ image, new ModelText( 'foobar' ) ] );
  35. imagePos = ModelPosition.createBefore( image );
  36. dispatcher.listenTo( doc, 'change', ( evt, type, changes ) => {
  37. dispatcher.convertChange( type, changes );
  38. } );
  39. } );
  40. it( 'should fire insert and addAttribute callbacks for insertion changes', () => {
  41. const cbInsertText = sinon.spy();
  42. const cbInsertImage = sinon.spy();
  43. const cbAddAttribute = sinon.spy();
  44. dispatcher.on( 'insert:$text', cbInsertText );
  45. dispatcher.on( 'insert:image', cbInsertImage );
  46. dispatcher.on( 'addAttribute:key:$text', cbAddAttribute );
  47. const insertedText = new ModelText( 'foo', { key: 'value' } );
  48. doc.batch().insert( ModelPosition.createFromParentAndOffset( root, 0 ), insertedText );
  49. expect( cbInsertText.called ).to.be.true;
  50. expect( cbAddAttribute.called ).to.be.true;
  51. expect( cbInsertImage.called ).to.be.false;
  52. } );
  53. it( 'should fire insert and addAttribute callbacks for reinsertion changes', () => {
  54. image.setAttribute( 'key', 'value' );
  55. // We will just create reinsert operation by reverting remove operation
  56. // because creating reinsert change is tricky and not available through batch API.
  57. const removeOperation = new RemoveOperation( imagePos, 1, 0 );
  58. // Let's apply remove operation so reinsert operation won't break.
  59. doc.applyOperation( wrapInDelta( removeOperation ) );
  60. const cbInsertText = sinon.spy();
  61. const cbInsertImage = sinon.spy();
  62. const cbAddAttribute = sinon.spy();
  63. dispatcher.on( 'insert:$text', cbInsertText );
  64. dispatcher.on( 'insert:image', cbInsertImage );
  65. dispatcher.on( 'addAttribute:key:image', cbAddAttribute );
  66. doc.applyOperation( wrapInDelta( removeOperation.getReversed() ) );
  67. expect( cbInsertImage.called ).to.be.true;
  68. expect( cbAddAttribute.called ).to.be.true;
  69. expect( cbInsertText.called ).to.be.false;
  70. } );
  71. it( 'should fire move callback for move changes', () => {
  72. const cbMove = sinon.spy();
  73. dispatcher.on( 'move', cbMove );
  74. doc.batch().move( image, imagePos.getShiftedBy( 3 ) );
  75. expect( cbMove.called );
  76. } );
  77. it( 'should fire remove callback for remove changes', () => {
  78. const cbRemove = sinon.spy();
  79. dispatcher.on( 'remove', cbRemove );
  80. doc.batch().remove( image );
  81. expect( cbRemove.called );
  82. } );
  83. it( 'should fire rename callback for rename changes', () => {
  84. const cbRename = sinon.spy();
  85. dispatcher.on( 'rename', cbRename );
  86. doc.batch().rename( image, 'figure' );
  87. expect( cbRename.called );
  88. } );
  89. it( 'should fire addAttribute callbacks for add attribute change', () => {
  90. const cbAddText = sinon.spy();
  91. const cbAddImage = sinon.spy();
  92. dispatcher.on( 'addAttribute:key:$text', cbAddText );
  93. dispatcher.on( 'addAttribute:key:image', cbAddImage );
  94. doc.batch().setAttribute( image, 'key', 'value' );
  95. // Callback for adding attribute on text not called.
  96. expect( cbAddText.called ).to.be.false;
  97. expect( cbAddImage.calledOnce ).to.be.true;
  98. doc.batch().setAttribute( ModelRange.createFromParentsAndOffsets( root, 3, root, 4 ), 'key', 'value' );
  99. expect( cbAddText.calledOnce ).to.be.true;
  100. // Callback for adding attribute on image not called this time.
  101. expect( cbAddImage.calledOnce ).to.be.true;
  102. } );
  103. it( 'should fire changeAttribute callbacks for change attribute change', () => {
  104. const cbChangeText = sinon.spy();
  105. const cbChangeImage = sinon.spy();
  106. dispatcher.on( 'changeAttribute:key:$text', cbChangeText );
  107. dispatcher.on( 'changeAttribute:key:image', cbChangeImage );
  108. doc.batch().setAttribute( image, 'key', 'value' ).setAttribute( image, 'key', 'newValue' );
  109. // Callback for adding attribute on text not called.
  110. expect( cbChangeText.called ).to.be.false;
  111. expect( cbChangeImage.calledOnce ).to.be.true;
  112. const range = ModelRange.createFromParentsAndOffsets( root, 3, root, 4 );
  113. doc.batch().setAttribute( range, 'key', 'value' ).setAttribute( range, 'key', 'newValue' );
  114. expect( cbChangeText.calledOnce ).to.be.true;
  115. // Callback for adding attribute on image not called this time.
  116. expect( cbChangeImage.calledOnce ).to.be.true;
  117. } );
  118. it( 'should fire removeAttribute callbacks for remove attribute change', () => {
  119. const cbRemoveText = sinon.spy();
  120. const cbRemoveImage = sinon.spy();
  121. dispatcher.on( 'removeAttribute:key:$text', cbRemoveText );
  122. dispatcher.on( 'removeAttribute:key:image', cbRemoveImage );
  123. doc.batch().setAttribute( image, 'key', 'value' ).removeAttribute( image, 'key' );
  124. // Callback for adding attribute on text not called.
  125. expect( cbRemoveText.called ).to.be.false;
  126. expect( cbRemoveImage.calledOnce ).to.be.true;
  127. const range = ModelRange.createFromParentsAndOffsets( root, 3, root, 4 );
  128. doc.batch().setAttribute( range, 'key', 'value' ).removeAttribute( range, 'key' );
  129. expect( cbRemoveText.calledOnce ).to.be.true;
  130. // Callback for adding attribute on image not called this time.
  131. expect( cbRemoveImage.calledOnce ).to.be.true;
  132. } );
  133. it( 'should not fire any event if not recognized event type was passed', () => {
  134. sinon.spy( dispatcher, 'fire' );
  135. dispatcher.convertChange( 'unknown', { foo: 'bar' } );
  136. expect( dispatcher.fire.called ).to.be.false;
  137. } );
  138. it( 'should not fire any event if change was in graveyard root and change type is different than remove', () => {
  139. sinon.spy( dispatcher, 'fire' );
  140. let gyNode = new ModelElement( 'image' );
  141. doc.graveyard.appendChildren( gyNode );
  142. doc.batch().setAttribute( gyNode, 'key', 'value' );
  143. expect( dispatcher.fire.called ).to.be.false;
  144. } );
  145. } );
  146. describe( 'convertInsert', () => {
  147. it( 'should fire event with correct parameters for every item in passed range', () => {
  148. root.appendChildren( [
  149. new ModelText( 'foo', { bold: true } ),
  150. new ModelElement( 'image' ),
  151. new ModelText( 'bar' ),
  152. new ModelElement( 'paragraph', { class: 'nice' }, new ModelText( 'xx', { italic: true } ) )
  153. ] );
  154. const range = ModelRange.createIn( root );
  155. const loggedEvents = [];
  156. // We will check everything connected with insert event:
  157. dispatcher.on( 'insert', ( evt, data, consumable ) => {
  158. // Check if the item is correct.
  159. const itemId = data.item.name ? data.item.name : '$text:' + data.item.data;
  160. // Check if the range is correct.
  161. const log = 'insert:' + itemId + ':' + data.range.start.path + ':' + data.range.end.path;
  162. loggedEvents.push( log );
  163. // Check if the event name is correct.
  164. expect( evt.name ).to.equal( 'insert:' + ( data.item.name || '$text' ) );
  165. // Check if model consumable is correct.
  166. expect( consumable.consume( data.item, 'insert' ) ).to.be.true;
  167. } );
  168. // Same here.
  169. dispatcher.on( 'addAttribute', ( evt, data, consumable ) => {
  170. const itemId = data.item.name ? data.item.name : '$text:' + data.item.data;
  171. const key = data.attributeKey;
  172. const value = data.attributeNewValue;
  173. const log = 'addAttribute:' + key + ':' + value + ':' + itemId + ':' + data.range.start.path + ':' + data.range.end.path;
  174. loggedEvents.push( log );
  175. expect( evt.name ).to.equal( 'addAttribute:' + key + ':' + ( data.item.name || '$text' ) );
  176. expect( consumable.consume( data.item, 'addAttribute:' + key ) ).to.be.true;
  177. } );
  178. dispatcher.convertInsertion( range );
  179. // Check the data passed to called events and the order of them.
  180. expect( loggedEvents ).to.deep.equal( [
  181. 'insert:$text:foo:0:3',
  182. 'addAttribute:bold:true:$text:foo:0:3',
  183. 'insert:image:3:4',
  184. 'insert:$text:bar:4:7',
  185. 'insert:paragraph:7:8',
  186. 'addAttribute:class:nice:paragraph:7:8',
  187. 'insert:$text:xx:7,0:7,2',
  188. 'addAttribute:italic:true:$text:xx:7,0:7,2'
  189. ] );
  190. } );
  191. it( 'should not fire events for already consumed parts of model', () => {
  192. root.appendChildren( [
  193. new ModelElement( 'image', { src: 'foo.jpg', title: 'bar', bold: true }, [
  194. new ModelElement( 'caption', {}, new ModelText( 'title' ) )
  195. ] )
  196. ] );
  197. sinon.spy( dispatcher, 'fire' );
  198. dispatcher.on( 'insert:image', ( evt, data, consumable ) => {
  199. consumable.consume( data.item.getChild( 0 ), 'insert' );
  200. consumable.consume( data.item, 'addAttribute:bold' );
  201. } );
  202. const range = ModelRange.createIn( root );
  203. dispatcher.convertInsertion( range );
  204. expect( dispatcher.fire.calledWith( 'insert:image' ) ).to.be.true;
  205. expect( dispatcher.fire.calledWith( 'addAttribute:src:image' ) ).to.be.true;
  206. expect( dispatcher.fire.calledWith( 'addAttribute:title:image' ) ).to.be.true;
  207. expect( dispatcher.fire.calledWith( 'insert:$text' ) ).to.be.true;
  208. expect( dispatcher.fire.calledWith( 'addAttribute:bold:image' ) ).to.be.false;
  209. expect( dispatcher.fire.calledWith( 'insert:caption' ) ).to.be.false;
  210. } );
  211. } );
  212. describe( 'convertMove', () => {
  213. it( 'should fire event for moved range', () => {
  214. root.appendChildren( new ModelText( 'barfoo' ) );
  215. const range = ModelRange.createFromParentsAndOffsets( root, 0, root, 3 );
  216. const loggedEvents = [];
  217. dispatcher.on( 'move', ( evt, data ) => {
  218. const log = 'move:' + data.sourcePosition.path + ':' + data.targetPosition.path + ':' + data.item.offsetSize;
  219. loggedEvents.push( log );
  220. } );
  221. dispatcher.convertMove( ModelPosition.createFromParentAndOffset( root , 0 ), range );
  222. expect( loggedEvents ).to.deep.equal( [ 'move:0:3:3' ] );
  223. } );
  224. } );
  225. describe( 'convertRemove', () => {
  226. it( 'should fire event for removed range', () => {
  227. root.appendChildren( new ModelText( 'foo' ) );
  228. doc.graveyard.appendChildren( new ModelText( 'bar' ) );
  229. const range = ModelRange.createFromParentsAndOffsets( doc.graveyard, 0, doc.graveyard, 3 );
  230. const loggedEvents = [];
  231. dispatcher.on( 'remove', ( evt, data ) => {
  232. const log = 'remove:' + data.sourcePosition.path + ':' + data.item.offsetSize;
  233. loggedEvents.push( log );
  234. } );
  235. dispatcher.convertRemove( ModelPosition.createFromParentAndOffset( root , 3 ), range );
  236. expect( loggedEvents ).to.deep.equal( [ 'remove:3:3' ] );
  237. } );
  238. } );
  239. describe( 'convertRename', () => {
  240. it( 'should fire rename event with correct name, consumable, and renamed element and it\'s old name in data', ( done ) => {
  241. const oldName = 'oldName';
  242. const element = new ModelElement( oldName );
  243. element.name = 'newName';
  244. dispatcher.on( 'rename', ( evt, data, consumable ) => {
  245. expect( evt.name ).to.equal( 'rename:newName:oldName' );
  246. expect( data.element ).to.equal( element );
  247. expect( data.oldName ).to.equal( oldName );
  248. expect( consumable.test( data.element, 'rename' ) ).to.be.true;
  249. done();
  250. } );
  251. dispatcher.convertRename( element, oldName );
  252. } );
  253. } );
  254. describe( 'convertAttribute', () => {
  255. it( 'should fire event for every item in passed range', () => {
  256. root.appendChildren( [
  257. new ModelText( 'foo', { bold: true } ),
  258. new ModelElement( 'image', { bold: true } ),
  259. new ModelElement( 'paragraph', { bold: true, class: 'nice' }, new ModelText( 'xx', { bold: true, italic: true } ) )
  260. ] );
  261. const range = ModelRange.createIn( root );
  262. const loggedEvents = [];
  263. dispatcher.on( 'addAttribute', ( evt, data, consumable ) => {
  264. const itemId = data.item.name ? data.item.name : '$text:' + data.item.data;
  265. const key = data.attributeKey;
  266. const value = data.attributeNewValue;
  267. const log = 'addAttribute:' + key + ':' + value + ':' + itemId + ':' + data.range.start.path + ':' + data.range.end.path;
  268. loggedEvents.push( log );
  269. expect( evt.name ).to.equal( 'addAttribute:' + key + ':' + ( data.item.name || '$text' ) );
  270. expect( consumable.consume( data.item, 'addAttribute:' + key ) ).to.be.true;
  271. } );
  272. dispatcher.convertAttribute( 'addAttribute', range, 'bold', null, true );
  273. expect( loggedEvents ).to.deep.equal( [
  274. 'addAttribute:bold:true:$text:foo:0:3',
  275. 'addAttribute:bold:true:image:3:4',
  276. 'addAttribute:bold:true:paragraph:4:5',
  277. 'addAttribute:bold:true:$text:xx:4,0:4,2'
  278. ] );
  279. } );
  280. it( 'should not fire events for already consumed parts of model', () => {
  281. root.appendChildren( [
  282. new ModelElement( 'element', null, new ModelElement( 'inside' ) )
  283. ] );
  284. sinon.spy( dispatcher, 'fire' );
  285. dispatcher.on( 'removeAttribute:attr:element', ( evt, data, consumable ) => {
  286. consumable.consume( data.item.getChild( 0 ), 'removeAttribute:attr' );
  287. } );
  288. const range = ModelRange.createIn( root );
  289. dispatcher.convertAttribute( 'removeAttribute', range, 'attr', 'value', null );
  290. expect( dispatcher.fire.calledWith( 'removeAttribute:attr:element' ) ).to.be.true;
  291. expect( dispatcher.fire.calledWith( 'removeAttribute:attr:inside' ) ).to.be.false;
  292. } );
  293. } );
  294. describe( 'convertSelection', () => {
  295. beforeEach( () => {
  296. dispatcher.off( 'selection' );
  297. root.appendChildren( new ModelText( 'foobar' ) );
  298. doc.selection.setRanges( [
  299. new ModelRange( new ModelPosition( root, [ 1 ] ), new ModelPosition( root, [ 3 ] ) ),
  300. new ModelRange( new ModelPosition( root, [ 4 ] ), new ModelPosition( root, [ 5 ] ) )
  301. ] );
  302. } );
  303. it( 'should fire selection event', () => {
  304. sinon.spy( dispatcher, 'fire' );
  305. dispatcher.convertSelection( doc.selection );
  306. expect( dispatcher.fire.calledWith(
  307. 'selection',
  308. { selection: sinon.match.instanceOf( doc.selection.constructor ) }
  309. ) ).to.be.true;
  310. } );
  311. it( 'should prepare correct list of consumable values', () => {
  312. doc.enqueueChanges( () => {
  313. doc.batch()
  314. .setAttribute( ModelRange.createIn( root ), 'bold', true )
  315. .setAttribute( ModelRange.createFromParentsAndOffsets( root, 4, root, 5 ), 'italic', true );
  316. } );
  317. dispatcher.on( 'selection', ( evt, data, consumable ) => {
  318. expect( consumable.test( data.selection, 'selection' ) ).to.be.true;
  319. expect( consumable.test( data.selection, 'selectionAttribute:bold' ) ).to.be.true;
  320. expect( consumable.test( data.selection, 'selectionAttribute:italic' ) ).to.be.null;
  321. } );
  322. dispatcher.convertSelection( doc.selection );
  323. } );
  324. it( 'should fire attributes events for selection', () => {
  325. sinon.spy( dispatcher, 'fire' );
  326. doc.enqueueChanges( () => {
  327. doc.batch()
  328. .setAttribute( ModelRange.createIn( root ), 'bold', true )
  329. .setAttribute( ModelRange.createFromParentsAndOffsets( root, 4, root, 5 ), 'italic', true );
  330. } );
  331. dispatcher.convertSelection( doc.selection );
  332. expect( dispatcher.fire.calledWith( 'selectionAttribute:bold' ) ).to.be.true;
  333. expect( dispatcher.fire.calledWith( 'selectionAttribute:italic' ) ).to.be.false;
  334. } );
  335. it( 'should not fire attributes events if attribute has been consumed', () => {
  336. sinon.spy( dispatcher, 'fire' );
  337. dispatcher.on( 'selection', ( evt, data, consumable ) => {
  338. consumable.consume( data.selection, 'selectionAttribute:bold' );
  339. } );
  340. doc.enqueueChanges( () => {
  341. doc.batch()
  342. .setAttribute( ModelRange.createIn( root ), 'bold', true )
  343. .setAttribute( ModelRange.createFromParentsAndOffsets( root, 4, root, 5 ), 'italic', true );
  344. } );
  345. dispatcher.convertSelection( doc.selection );
  346. expect( dispatcher.fire.calledWith( 'selectionAttribute:bold' ) ).to.be.false;
  347. } );
  348. } );
  349. } );