delta.js 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397
  1. /**
  2. * @license Copyright (c) 2003-2016, CKSource - Frederico Knabben. All rights reserved.
  3. * For licensing, see LICENSE.md.
  4. */
  5. /* bender-tags: treemodel, delta */
  6. 'use strict';
  7. import count from '/ckeditor5/utils/count.js';
  8. import Delta from '/ckeditor5/engine/treemodel/delta/delta.js';
  9. import Operation from '/ckeditor5/engine/treemodel/operation/operation.js';
  10. import AttributeOperation from '/ckeditor5/engine/treemodel/operation/attributeoperation.js';
  11. import InsertOperation from '/ckeditor5/engine/treemodel/operation/insertoperation.js';
  12. import MoveOperation from '/ckeditor5/engine/treemodel/operation/moveoperation.js';
  13. import NoOperation from '/ckeditor5/engine/treemodel/operation/nooperation.js';
  14. import ReinsertOperation from '/ckeditor5/engine/treemodel/operation/reinsertoperation.js';
  15. import RemoveOperation from '/ckeditor5/engine/treemodel/operation/removeoperation.js';
  16. import RootAttributeOperation from '/ckeditor5/engine/treemodel/operation/rootattributeoperation.js';
  17. import CKEditorError from '/ckeditor5/utils/ckeditorerror.js';
  18. import { registerDeserializer } from '/ckeditor5/engine/treemodel/delta/delta.js';
  19. import Document from '/ckeditor5/engine/treemodel/document.js';
  20. import Position from '/ckeditor5/engine/treemodel/position.js';
  21. import Range from '/ckeditor5/engine/treemodel/range.js';
  22. import treeModelTestUtils from '/tests/engine/treemodel/_utils/utils.js';
  23. // Some test examples of operations.
  24. class FooOperation extends Operation {
  25. constructor( string, baseVersion ) {
  26. super( baseVersion );
  27. this.string = string;
  28. }
  29. getReversed() {
  30. /* jshint ignore:start */
  31. return new BarOperation( this.string, this.baseVersion );
  32. /* jshint ignore:end */
  33. }
  34. }
  35. class BarOperation extends FooOperation {
  36. getReversed() {
  37. return new FooOperation( this.string, this.baseVersion );
  38. }
  39. }
  40. class FooDelta extends Delta {
  41. static get className() {
  42. return 'tets.delta.foo';
  43. }
  44. }
  45. class BarDelta extends Delta {
  46. static get className() {
  47. return 'tets.delta.bar';
  48. }
  49. }
  50. class FooBarDelta extends Delta {
  51. static get className() {
  52. return 'tets.delta.foobar';
  53. }
  54. }
  55. describe( 'Delta', () => {
  56. describe( 'constructor', () => {
  57. it( 'should create an delta with empty properties', () => {
  58. const delta = new Delta();
  59. expect( delta ).to.have.property( 'batch' ).that.is.null;
  60. expect( delta ).to.have.property( 'operations' ).that.a( 'array' ).and.have.length( 0 );
  61. } );
  62. } );
  63. describe( 'addOperation', () => {
  64. it( 'should add operation to the delta', () => {
  65. const delta = new Delta();
  66. const operation = {};
  67. delta.addOperation( operation );
  68. expect( delta.operations ).to.have.length( 1 );
  69. expect( delta.operations[ 0 ] ).to.equal( operation );
  70. } );
  71. it( 'should add delta property to the operation', () => {
  72. const delta = new Delta();
  73. const operation = {};
  74. delta.addOperation( operation );
  75. expect( operation.delta ).to.equal( delta );
  76. } );
  77. } );
  78. describe( 'iterator', () => {
  79. it( 'should iterate over delta operations', () => {
  80. const delta = new Delta();
  81. delta.addOperation( {} );
  82. delta.addOperation( {} );
  83. delta.addOperation( {} );
  84. const totalNumber = count( delta.operations );
  85. expect( totalNumber ).to.equal( 3 );
  86. } );
  87. } );
  88. describe( 'getReversed', () => {
  89. it( 'should return empty Delta if there are no operations in delta', () => {
  90. const delta = new Delta();
  91. let reversed = delta.getReversed();
  92. expect( reversed ).to.be.instanceof( Delta );
  93. expect( reversed.operations.length ).to.equal( 0 );
  94. } );
  95. it( 'should return Delta with all operations reversed and their order reversed', () => {
  96. const delta = new Delta();
  97. delta.addOperation( new FooOperation( 'a', 1 ) );
  98. delta.addOperation( new BarOperation( 'b', 2 ) );
  99. let reversed = delta.getReversed();
  100. expect( reversed ).to.be.instanceof( Delta );
  101. expect( reversed.operations.length ).to.equal( 2 );
  102. expect( reversed.operations[ 0 ] ).to.be.instanceOf( FooOperation );
  103. expect( reversed.operations[ 0 ].string ).to.equal( 'b' );
  104. expect( reversed.operations[ 1 ] ).to.be.instanceOf( BarOperation );
  105. expect( reversed.operations[ 1 ].string ).to.equal( 'a' );
  106. } );
  107. } );
  108. describe( 'toJSON', () => {
  109. let delta, root, doc;
  110. before( () => {
  111. registerDeserializer( FooDelta.className, FooDelta );
  112. } );
  113. beforeEach( () => {
  114. delta = new FooDelta();
  115. doc = new Document();
  116. root = doc.createRoot( 'root' );
  117. } );
  118. it( 'should return JSON representation for empty delta', () => {
  119. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  120. __class: FooDelta.className,
  121. batch: null,
  122. operations: []
  123. } );
  124. } );
  125. it( 'should create delta with AttributeOperation', () => {
  126. let operation = new AttributeOperation(
  127. new Range( new Position( root, [ 0 ] ), new Position( root, [ 1 ] ) ),
  128. 'foo',
  129. true,
  130. null,
  131. doc.version
  132. );
  133. delta.addOperation( operation );
  134. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  135. __class: FooDelta.className,
  136. batch: null,
  137. operations: [ treeModelTestUtils.jsonParseStringify( operation ) ]
  138. } );
  139. } );
  140. it( 'should create delta with InsertOperation', () => {
  141. let operation = new InsertOperation(
  142. new Position( root, [ 0 ] ),
  143. 'x',
  144. doc.version
  145. );
  146. delta.addOperation( operation );
  147. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  148. __class: FooDelta.className,
  149. batch: null,
  150. operations: [ treeModelTestUtils.jsonParseStringify( operation ) ]
  151. } );
  152. } );
  153. it( 'should create delta with MoveOperation', () => {
  154. let operation = new MoveOperation(
  155. new Position( root, [ 0, 0 ] ),
  156. 1,
  157. new Position( root, [ 1, 0 ] ),
  158. doc.version
  159. );
  160. delta.addOperation( operation );
  161. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  162. __class: FooDelta.className,
  163. batch: null,
  164. operations: [ treeModelTestUtils.jsonParseStringify( operation ) ]
  165. } );
  166. } );
  167. it( 'should create delta with NoOperation', () => {
  168. let operation = new NoOperation( 0 );
  169. delta.addOperation( operation );
  170. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  171. __class: FooDelta.className,
  172. batch: null,
  173. operations: [ treeModelTestUtils.jsonParseStringify( operation ) ]
  174. } );
  175. } );
  176. it( 'should create delta with ReinsertOperation', () => {
  177. let operation = new ReinsertOperation(
  178. new Position( doc.graveyard, [ 0 ] ),
  179. 2,
  180. new Position( root, [ 0 ] ),
  181. doc.version
  182. );
  183. delta.addOperation( operation );
  184. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  185. __class: FooDelta.className,
  186. batch: null,
  187. operations: [ treeModelTestUtils.jsonParseStringify( operation ) ]
  188. } );
  189. } );
  190. it( 'should create delta with RemoveOperation', () => {
  191. let operation = new RemoveOperation(
  192. new Position( root, [ 2 ] ),
  193. 2,
  194. doc.version
  195. );
  196. delta.addOperation( operation );
  197. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  198. __class: FooDelta.className,
  199. batch: null,
  200. operations: [ treeModelTestUtils.jsonParseStringify( operation ) ]
  201. } );
  202. } );
  203. it( 'should create delta with RootAttributeOperation', () => {
  204. let operation = new RootAttributeOperation( root, 'key', null, 'newValue', doc.version );
  205. delta.addOperation( operation );
  206. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  207. __class: FooDelta.className,
  208. batch: null,
  209. operations: [ treeModelTestUtils.jsonParseStringify( operation ) ]
  210. } );
  211. } );
  212. it( 'should remove batch reference', () => {
  213. delta.batch = { foo: 'bar' };
  214. expect( treeModelTestUtils.jsonParseStringify( delta ) ).to.deep.equal( {
  215. __class: FooDelta.className,
  216. batch: null,
  217. operations: []
  218. } );
  219. } );
  220. } );
  221. describe( 'fromJSON', () => {
  222. let delta, root, doc;
  223. before( () => {
  224. registerDeserializer( FooBarDelta.className, FooDelta );
  225. } );
  226. beforeEach( () => {
  227. delta = new FooBarDelta();
  228. doc = new Document();
  229. root = doc.createRoot( 'root' );
  230. } );
  231. it( 'should throw error for unregistered delta', () => {
  232. expect( () => {
  233. Delta.fromJSON( treeModelTestUtils.jsonParseStringify( new BarDelta() ), {} );
  234. } ).to.throw( CKEditorError, /^delta-fromjson-no-deserializer/ );
  235. } );
  236. it( 'should create delta with AttributeOperation', () => {
  237. delta.addOperation( new AttributeOperation(
  238. new Range( new Position( root, [ 0 ] ), new Position( root, [ 1 ] ) ),
  239. 'foo',
  240. true,
  241. null,
  242. doc.version
  243. ) );
  244. let deserialized = Delta.fromJSON( treeModelTestUtils.jsonParseStringify( delta ), doc );
  245. expect( deserialized ).to.deep.equal( delta );
  246. } );
  247. it( 'should create delta with InsertOperation', () => {
  248. delta.addOperation( new InsertOperation(
  249. new Position( root, [ 0 ] ),
  250. 'x',
  251. doc.version
  252. ) );
  253. let deserialized = Delta.fromJSON( treeModelTestUtils.jsonParseStringify( delta ), doc );
  254. expect( deserialized ).to.deep.equal( delta );
  255. } );
  256. it( 'should create delta with MoveOperation', () => {
  257. delta.addOperation( new MoveOperation(
  258. new Position( root, [ 0, 0 ] ),
  259. 1,
  260. new Position( root, [ 1, 0 ] ),
  261. doc.version
  262. ) );
  263. let deserialized = Delta.fromJSON( treeModelTestUtils.jsonParseStringify( delta ), doc );
  264. expect( deserialized ).to.deep.equal( delta );
  265. } );
  266. it( 'should create delta with NoOperation', () => {
  267. delta.addOperation( new NoOperation( 0 ) );
  268. let deserialized = Delta.fromJSON( treeModelTestUtils.jsonParseStringify( delta ), doc );
  269. expect( deserialized ).to.deep.equal( delta );
  270. } );
  271. it( 'should create delta with ReinsertOperation', () => {
  272. delta.addOperation( new ReinsertOperation(
  273. new Position( doc.graveyard, [ 0 ] ),
  274. 2,
  275. new Position( root, [ 0 ] ),
  276. doc.version
  277. ) );
  278. let deserialized = Delta.fromJSON( treeModelTestUtils.jsonParseStringify( delta ), doc );
  279. expect( deserialized ).to.deep.equal( delta );
  280. } );
  281. it( 'should create delta with RemoveOperation', () => {
  282. delta.addOperation( new RemoveOperation(
  283. new Position( root, [ 2 ] ),
  284. 2,
  285. doc.version
  286. ) );
  287. let deserialized = Delta.fromJSON( treeModelTestUtils.jsonParseStringify( delta ), doc );
  288. expect( deserialized ).to.deep.equal( delta );
  289. } );
  290. it( 'should create delta with RootAttributeOperation', () => {
  291. delta.addOperation( new RootAttributeOperation( root, 'key', null, 'newValue', doc.version ) );
  292. let deserialized = Delta.fromJSON( treeModelTestUtils.jsonParseStringify( delta ), doc );
  293. expect( deserialized ).to.deep.equal( delta );
  294. } );
  295. } );
  296. describe( 'registerDeserializer', () => {
  297. it( 'should add delta deserializer', ( done ) => {
  298. registerDeserializer( 'foo', deserializer );
  299. Delta.fromJSON( { __class: 'foo', operations: [] } );
  300. function deserializer() {
  301. done();
  302. }
  303. } );
  304. it( 'should throw error for adding already defined deserializer', () => {
  305. registerDeserializer( 'BAR', FooDelta );
  306. expect( () => {
  307. registerDeserializer( 'BAR', FooDelta );
  308. } ).to.throw( CKEditorError, /^delta-register-deserializer-defined/ );
  309. } );
  310. } );
  311. } );