treewalker.js 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229
  1. /**
  2. * @license Copyright (c) 2003-2016, CKSource - Frederico Knabben. All rights reserved.
  3. * For licensing, see LICENSE.md.
  4. */
  5. /* bender-tags: treemodel */
  6. 'use strict';
  7. import Document from '/ckeditor5/core/treemodel/document.js';
  8. import Element from '/ckeditor5/core/treemodel/element.js';
  9. import Text from '/ckeditor5/core/treemodel/text.js';
  10. import TreeWalker from '/ckeditor5/core/treemodel/treewalker.js';
  11. import Position from '/ckeditor5/core/treemodel/position.js';
  12. import Range from '/ckeditor5/core/treemodel/range.js';
  13. import CKEditorError from '/ckeditor5/core/ckeditorerror.js';
  14. describe( 'range iterator', () => {
  15. let doc, expectedItems, expectedItemsMerged, root, img1, paragraph, b, a, r, img2, x;
  16. before( () => {
  17. doc = new Document();
  18. root = doc.createRoot( 'root' );
  19. // root
  20. // |- img1
  21. // |- p
  22. // |- B
  23. // |- A
  24. // |- R
  25. // |
  26. // |- img2
  27. // |
  28. // |- X
  29. b = new Text( 'b', { bold: true } );
  30. a = new Text( 'a', { bold: true } );
  31. r = new Text( 'r' );
  32. img2 = new Element( 'img2' );
  33. x = new Text( 'x' );
  34. paragraph = new Element( 'p', [], [ b, a, r, img2, x ] );
  35. img1 = new Element( 'img1' );
  36. root.insertChildren( 0, [ img1, paragraph ] );
  37. expectedItems = [
  38. { type: 'ELEMENT_START', item: img1 },
  39. { type: 'ELEMENT_END', item: img1 },
  40. { type: 'ELEMENT_START', item: paragraph },
  41. { type: 'CHARACTER', text: 'b', attrs: [ [ 'bold', true ] ] },
  42. { type: 'CHARACTER', text: 'a', attrs: [ [ 'bold', true ] ] },
  43. { type: 'CHARACTER', text: 'r', attrs: [] },
  44. { type: 'ELEMENT_START', item: img2 },
  45. { type: 'ELEMENT_END', item: img2 },
  46. { type: 'CHARACTER', text: 'x', attrs: [] },
  47. { type: 'ELEMENT_END', item: paragraph }
  48. ];
  49. expectedItemsMerged = [
  50. { type: 'ELEMENT_START', item: img1 },
  51. { type: 'ELEMENT_END', item: img1 },
  52. { type: 'ELEMENT_START', item: paragraph },
  53. { type: 'TEXT', text: 'ba', attrs: [ [ 'bold', true ] ] },
  54. { type: 'TEXT', text: 'r', attrs: [] },
  55. { type: 'ELEMENT_START', item: img2 },
  56. { type: 'ELEMENT_END', item: img2 },
  57. { type: 'TEXT', text: 'x', attrs: [] },
  58. { type: 'ELEMENT_END', item: paragraph }
  59. ];
  60. } );
  61. function expectItem( item, expected ) {
  62. expect( item.done ).to.be.false;
  63. if ( item.value.type == 'TEXT' || item.value.type == 'CHARACTER' ) {
  64. let text = item.value.item.text || item.value.item.character;
  65. let attrs = item.value.item._attrs || item.value.item.first._attrs;
  66. expect( text ).to.equal( expected.text );
  67. expect( Array.from( attrs ) ).to.deep.equal( expected.attrs );
  68. expect( item.value.length ).to.equal( text.length );
  69. } else {
  70. expect( item.value.type ).to.equal( expected.type );
  71. expect( item.value.item ).to.equal( expected.item );
  72. if ( item.value.type == 'ELEMENT_START' ) {
  73. expect( item.value.length ).to.equal( 1 );
  74. } else {
  75. expect( item.value.length ).to.be.undefined;
  76. }
  77. }
  78. if ( item.value.type == 'TEXT' ) {
  79. expect( item.value.previousPosition ).to.deep.equal( Position.createBefore( item.value.item.first ) );
  80. } else if ( item.value.type == 'ELEMENT_END' ) {
  81. expect( item.value.previousPosition ).to.deep.equal(
  82. Position.createFromParentAndOffset( item.value.item, item.value.item.getChildCount() ) );
  83. } else {
  84. expect( item.value.previousPosition ).to.deep.equal( Position.createBefore( item.value.item ) );
  85. }
  86. if ( item.value.type == 'TEXT' ) {
  87. expect( item.value.nextPosition ).to.deep.equal( Position.createAfter( item.value.item.last ) );
  88. } else if ( item.value.type == 'ELEMENT_START' ) {
  89. expect( item.value.nextPosition ).to.deep.equal( Position.createFromParentAndOffset( item.value.item, 0 ) );
  90. } else {
  91. expect( item.value.nextPosition ).to.deep.equal( Position.createAfter( item.value.item ) );
  92. }
  93. }
  94. it( 'should return next position', () => {
  95. let iterator = new TreeWalker( { position: new Position( root, [ 0 ] ) } ); // beginning of root
  96. let i, len;
  97. for ( i = 0, len = expectedItems.length; i < len; i++ ) {
  98. expectItem( iterator.next(), expectedItems[ i ] );
  99. }
  100. expect( iterator.next() ).to.have.property( 'done' ).that.is.true;
  101. } );
  102. it( 'should return previous position', () => {
  103. let iterator = new TreeWalker( { position: new Position( root, [ 2 ] ) } ); // ending of root
  104. for ( let i = expectedItems.length - 1; i >= 0; i-- ) {
  105. expectItem( iterator.previous(), expectedItems[ i ] );
  106. }
  107. expect( iterator.previous() ).to.have.property( 'done' ).that.is.true;
  108. } );
  109. it( 'should return next position in the boundaries', () => {
  110. let start = new Position( root, [ 1, 0 ] ); // p, 0
  111. let end = new Position( root, [ 1, 3, 0 ] ); // img, 0
  112. let iterator = new TreeWalker( { boundaries: new Range( start, end ) } );
  113. let i, len;
  114. for ( i = 3, len = expectedItems.length; i < 7; i++ ) {
  115. expectItem( iterator.next(), expectedItems[ i ] );
  116. }
  117. expect( iterator.next() ).to.have.property( 'done' ).that.is.true;
  118. } );
  119. it( 'should return previous position in the boundaries', () => {
  120. let start = new Position( root, [ 1, 0 ] ); // p, 0
  121. let end = new Position( root, [ 1, 3, 0 ] ); // img, 0
  122. let iterator = new TreeWalker( { boundaries: new Range( start, end ), position: end } );
  123. let i, len;
  124. for ( i = 6, len = expectedItems.length; i > 2; i-- ) {
  125. expectItem( iterator.previous(), expectedItems[ i ] );
  126. }
  127. expect( iterator.previous() ).to.have.property( 'done' ).that.is.true;
  128. } );
  129. it( 'should merge characters when iterating over the range using next', () => {
  130. let start = new Position( root, [ 1 ] );
  131. let end = new Position( root, [ 1, 4 ] );
  132. let range = new Range( start, end );
  133. let iterator = new TreeWalker( { boundaries: range, position: range.start, mergeCharacters: true } );
  134. let i;
  135. for ( i = 2; i <= 6; i++ ) {
  136. expectItem( iterator.next(), expectedItemsMerged[ i ] );
  137. }
  138. expect( iterator.next() ).to.have.property( 'done' ).that.is.true;
  139. } );
  140. it( 'should merge characters when iterating over the range using previous', () => {
  141. let start = new Position( root, [ 1 ] );
  142. let end = new Position( root, [ 1, 4 ] );
  143. let range = new Range( start, end );
  144. let iterator = new TreeWalker( { boundaries: range, position: range.end, mergeCharacters: true } );
  145. for ( let i = 6; i >= 2; i-- ) {
  146. expectItem( iterator.previous(), expectedItemsMerged[ i ] );
  147. }
  148. expect( iterator.previous() ).to.have.property( 'done' ).that.is.true;
  149. } );
  150. it( 'should respect boundaries when iterating using next and merging characters', () => {
  151. let start = new Position( root, [ 1, 0 ] );
  152. let end = new Position( root, [ 1, 1 ] );
  153. let range = new Range( start, end );
  154. let iterator = new TreeWalker( { boundaries: range, position: range.start, mergeCharacters: true } );
  155. let val = iterator.next();
  156. expect( val.done ).to.be.false;
  157. expect( val.value.item.text ).to.equal( 'b' );
  158. val = iterator.next();
  159. expect( val.done ).to.be.true;
  160. } );
  161. it( 'should respect boundaries when iterating using previous and merging characters', () => {
  162. let start = new Position( root, [ 1, 1 ] );
  163. let end = new Position( root, [ 1, 2 ] );
  164. let range = new Range( start, end );
  165. let iterator = new TreeWalker( { boundaries: range, position: range.end, mergeCharacters: true } );
  166. let val = iterator.previous();
  167. expect( val.done ).to.be.false;
  168. expect( val.value.item.text ).to.equal( 'a' );
  169. val = iterator.previous();
  170. expect( val.done ).to.be.true;
  171. } );
  172. it( 'should throw if neither boundaries nor starting position is set', () => {
  173. expect( () => {
  174. new TreeWalker();
  175. } ).to.throw( CKEditorError, /^tree-walker-no-start-position/ );
  176. expect( () => {
  177. new TreeWalker( {} );
  178. } ).to.throw( CKEditorError, /^tree-walker-no-start-position/ );
  179. expect( () => {
  180. new TreeWalker( { mergeCharacters: true } );
  181. } ).to.throw( CKEditorError, /^tree-walker-no-start-position/ );
  182. } );
  183. } );