/*! * VisualEditor DataModel SurfaceFragment tests. * * @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt * @license The MIT License (MIT); see LICENSE.txt */ QUnit.module( 've.dm.SurfaceFragment' ); /* Tests */ QUnit.test( 'constructor', 8, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface ); // Default range and autoSelect assert.strictEqual( fragment.getSurface(), surface, 'surface reference is stored' ); assert.strictEqual( fragment.getDocument(), doc, 'document reference is stored' ); assert.deepEqual( fragment.getRange(), new ve.Range( 0, 0 ), 'range is taken from surface' ); assert.strictEqual( fragment.willAutoSelect(), true, 'auto select by default' ); assert.strictEqual( fragment.isNull(), false, 'valid fragment is not null' ); // Invalid range and autoSelect fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( -100, 100 ), 'truthy' ); assert.equal( fragment.getRange().from, 0, 'range is clamped between 0 and document length' ); assert.equal( fragment.getRange().to, 61, 'range is clamped between 0 and document length' ); assert.strictEqual( fragment.willAutoSelect(), false, 'noAutoSelect values are boolean' ); } ); QUnit.test( 'onTransact', 1, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment1 = new ve.dm.SurfaceFragment( surface, new ve.Range( 1, 56 ) ), fragment2 = new ve.dm.SurfaceFragment( surface, new ve.Range( 2, 4 ) ); fragment1.removeContent(); assert.deepEqual( fragment2.getRange(), new ve.Range( 1, 1 ), 'fragment ranges are auto-translated when transactions are processed' ); } ); QUnit.test( 'adjustRange', 3, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 20, 21 ) ), adjustedFragment = fragment.adjustRange( -19, 35 ); assert.ok( fragment !== adjustedFragment, 'adjustRange produces a new fragment' ); assert.deepEqual( fragment.getRange(), new ve.Range( 20, 21 ), 'old fragment is not changed' ); assert.deepEqual( adjustedFragment.getRange(), new ve.Range( 1, 56 ), 'new range is used' ); } ); QUnit.test( 'collapseRange', 3, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 20, 21 ) ), collapsedFragment = fragment.collapseRange(); assert.ok( fragment !== collapsedFragment, 'collapseRange produces a new fragment' ); assert.deepEqual( fragment.getRange(), new ve.Range( 20, 21 ), 'old fragment is not changed' ); assert.deepEqual( collapsedFragment.getRange(), new ve.Range( 20, 20 ), 'new range is used' ); } ); QUnit.test( 'expandRange (closest)', 1, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 20, 21 ) ); assert.strictEqual( fragment.expandRange( 'closest', 'invalid type' ).isNull(), true, 'closest with invalid type results in null fragment' ); } ); QUnit.test( 'expandRange (word)', 1, function ( assert ) { var i, doc, surface, fragment, newFragment, range, word, cases = [ { phrase: 'the quick brown fox', range: new ve.Range( 6, 13 ), expected: 'quick brown', msg: 'range starting and ending in latin words' }, { phrase: 'the quick brown fox', range: new ve.Range( 18, 12 ), expected: 'brown fox', msg: 'backwards range starting and ending in latin words' }, { phrase: 'the quick brown fox', range: new ve.Range( 7, 7 ), expected: 'quick', msg: 'zero-length range' } ]; QUnit.expect( cases.length*2 ); for ( i = 0; i < cases.length; i++ ) { doc = new ve.dm.Document( cases[i].phrase.split('') ); surface = new ve.dm.Surface( doc ); fragment = new ve.dm.SurfaceFragment( surface, cases[i].range ); newFragment = fragment.expandRange( 'word' ); range = newFragment.getRange(); word = cases[i].phrase.substring( range.start, range.end ); assert.strictEqual( word, cases[i].expected, cases[i].msg + ': text' ); assert.strictEqual( cases[i].range.isBackwards(), range.isBackwards(), cases[i].msg + ': range direction' ); } } ); QUnit.test( 'removeContent', 2, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 1, 56 ) ), expectedData = ve.copyArray( ve.dm.example.data.slice( 0, 1 ) ) .concat( ve.copyArray( ve.dm.example.data.slice( 4, 5 ) ) ) .concat( ve.copyArray( ve.dm.example.data.slice( 55 ) ) ); ve.setProp( expectedData[0], 'internal', 'changed', 'content', 1 ); fragment.removeContent(); assert.deepEqual( doc.getData(), expectedData, 'removing content drops fully covered nodes and strips partially covered ones' ); assert.deepEqual( fragment.getRange(), new ve.Range( 1, 1 ), 'removing content results in a zero-length fragment' ); } ); QUnit.test( 'insertContent', 3, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 1, 4 ) ); fragment.insertContent( ['1', '2', '3'] ); assert.deepEqual( doc.getData( new ve.Range( 1, 4 ) ), ['1', '2', '3'], 'inserting content replaces selection with new content' ); assert.deepEqual( fragment.getRange(), new ve.Range( 4, 4 ), 'inserting content results in a zero-length fragment' ); fragment.insertContent( '321' ); assert.deepEqual( doc.getData( new ve.Range( 4, 7 ) ), ['3', '2', '1'], 'strings get converted into data when inserting content' ); } ); QUnit.test( 'wrapNodes/unwrapNodes', 10, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), originalDoc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 55, 61 ) ); // Make 2 paragraphs into 2 lists of 1 item each fragment.wrapNodes( [{ 'type': 'list', 'attributes': { 'style': 'bullet' } }, { 'type': 'listItem' }] ); assert.deepEqual( doc.getData( new ve.Range( 55, 69 ) ), [ { 'type': 'list', 'attributes': { 'style': 'bullet' }, 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'listItem', 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'paragraph' }, 'l', { 'type': '/paragraph' }, { 'type': '/listItem' }, { 'type': '/list' }, { 'type': 'list', 'attributes': { 'style': 'bullet' }, 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'listItem', 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'paragraph' }, 'm', { 'type': '/paragraph' }, { 'type': '/listItem' }, { 'type': '/list' } ], 'wrapping nodes can add multiple levels of wrapping to multiple elements' ); assert.deepEqual( fragment.getRange(), new ve.Range( 55, 69 ), 'new range contains wrapping elements' ); fragment.unwrapNodes( 0, 2 ); assert.deepEqual( doc.getData(), originalDoc.getData(), 'unwrapping 2 levels restores document to original state' ); assert.deepEqual( fragment.getRange(), new ve.Range( 55, 61 ), 'range after unwrapping is same as original range' ); // Make a 1 paragraph into 1 list with 1 item fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 9, 12 ) ); fragment.wrapNodes( [{ 'type': 'list', 'attributes': { 'style': 'bullet' } }, { 'type': 'listItem' }] ); assert.deepEqual( doc.getData( new ve.Range( 9, 16 ) ), [ { 'type': 'list', 'attributes': { 'style': 'bullet' }, 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'listItem', 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'paragraph' }, 'd', { 'type': '/paragraph' }, { 'type': '/listItem' }, { 'type': '/list' } ], 'wrapping nodes can add multiple levels of wrapping to a single element' ); assert.deepEqual( fragment.getRange(), new ve.Range( 9, 16 ), 'new range contains wrapping elements' ); fragment.unwrapNodes( 0, 2 ); assert.deepEqual( doc.getData(), originalDoc.getData(), 'unwrapping 2 levels restores document to original state' ); assert.deepEqual( fragment.getRange(), new ve.Range( 9, 12 ), 'range after unwrapping is same as original range' ); fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 8, 34 ) ); fragment.unwrapNodes( 3, 1 ); assert.deepEqual( fragment.getData(), doc.getData( new ve.Range( 5, 29 ) ), 'unwrapping multiple outer nodes and an inner node' ); assert.deepEqual( fragment.getRange(), new ve.Range( 5, 29 ), 'new range contains inner elements' ); } ); QUnit.test( 'rewrapNodes', 4, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 43, 55 ) ), expectedDoc = ve.dm.example.createExampleDocument(), expectedSurface = new ve.dm.Surface( expectedDoc ), expectedFragment = new ve.dm.SurfaceFragment( expectedSurface, new ve.Range( 43, 55 ) ), created = { 'changed': { 'created': 1 } }, expectedData; // set up wrapped nodes in example document fragment.wrapNodes( [{ 'type': 'list', 'attributes': { 'style': 'bullet' } }, { 'type': 'listItem' }] ); expectedFragment.wrapNodes( [{ 'type': 'list', 'attributes': { 'style': 'bullet' } }, { 'type': 'listItem' }] ); // range is now 43, 59 // Compare a rewrap operation with its equivalent unwrap + wrap // This type of test can only exist if the intermediate state is valid fragment.rewrapNodes( 2, [{ 'type': 'definitionList' }, { 'type': 'definitionListItem', 'attributes': { 'style': 'term' } }] ); expectedFragment.unwrapNodes( 0, 2 ); expectedFragment.wrapNodes( [{ 'type': 'definitionList' }, { 'type': 'definitionListItem', 'attributes': { 'style': 'term' } }] ); assert.deepEqual( doc.getData(), expectedDoc.getData(), 'rewrapping multiple nodes via a valid intermediate state produces the same document as unwrapping then wrapping' ); assert.deepEqual( fragment.getRange(), expectedFragment.getRange(), 'new range contains rewrapping elements' ); // Rewrap paragrphs as headings // The intermediate stage (plain text attached to the document) would be invalid // if performed as an unwrap and a wrap expectedData = ve.copyArray( doc.getData() ); fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 59, 65 ) ); fragment.rewrapNodes( 1, [ { 'type': 'heading', 'attributes': { 'level': 1 } } ] ); expectedData.splice( 59, 1, { 'type': 'heading', 'attributes': { 'level': 1 }, 'internal': created } ); expectedData.splice( 61, 1, { 'type': '/heading' } ); expectedData.splice( 62, 1, { 'type': 'heading', 'attributes': { 'level': 1 }, 'internal': created } ); expectedData.splice( 64, 1, { 'type': '/heading' } ); assert.deepEqual( doc.getData(), expectedData, 'rewrapping paragraphs as headings' ); assert.deepEqual( fragment.getRange(), new ve.Range( 59, 65 ), 'new range contains rewrapping elements' ); } ); QUnit.test( 'wrapAllNodes', 10, function ( assert ) { var doc = ve.dm.example.createExampleDocument(), originalDoc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 55, 61 ) ), expectedData = ve.copyArray( doc.getData() ); // Make 2 paragraphs into 1 lists of 1 item with 2 paragraphs fragment.wrapAllNodes( [{ 'type': 'list', 'attributes': { 'style': 'bullet' } }, { 'type': 'listItem' }] ); assert.deepEqual( doc.getData( new ve.Range( 55, 65 ) ), [ { 'type': 'list', 'attributes': { 'style': 'bullet' }, 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'listItem', 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'paragraph' }, 'l', { 'type': '/paragraph' }, { 'type': 'paragraph' }, 'm', { 'type': '/paragraph' }, { 'type': '/listItem' }, { 'type': '/list' } ], 'wrapping nodes can add multiple levels of wrapping to multiple elements' ); assert.deepEqual( fragment.getRange(), new ve.Range( 55, 65 ), 'new range contains wrapping elements' ); fragment.unwrapNodes( 0, 2 ); assert.deepEqual( doc.getData(), originalDoc.getData(), 'unwrapping 2 levels restores document to original state' ); assert.deepEqual( fragment.getRange(), new ve.Range( 55, 61 ), 'range after unwrapping is same as original range' ); // Make a 1 paragraph into 1 list with 1 item fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 9, 12 ) ); fragment.wrapAllNodes( [{ 'type': 'list', 'attributes': { 'style': 'bullet' } }, { 'type': 'listItem' }] ); assert.deepEqual( doc.getData( new ve.Range( 9, 16 ) ), [ { 'type': 'list', 'attributes': { 'style': 'bullet' }, 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'listItem', 'internal': { 'changed': { 'created': 1 } } }, { 'type': 'paragraph' }, 'd', { 'type': '/paragraph' }, { 'type': '/listItem' }, { 'type': '/list' } ], 'wrapping nodes can add multiple levels of wrapping to a single element' ); assert.deepEqual( fragment.getRange(), new ve.Range( 9, 16 ), 'new range contains wrapping elements' ); fragment.unwrapNodes( 0, 2 ); assert.deepEqual( doc.getData(), originalDoc.getData(), 'unwrapping 2 levels restores document to original state' ); assert.deepEqual( fragment.getRange(), new ve.Range( 9, 12 ), 'range after unwrapping is same as original range' ); fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 5, 37 ) ); assert.throws( function() { fragment.unwrapNodes( 0, 20 ); }, /cannot unwrap by greater depth/, 'error thrown trying to unwrap more nodes that it is possible to contain' ); expectedData.splice( 5, 4 ); expectedData.splice( 29, 4 ); fragment.unwrapNodes( 0, 4 ); assert.deepEqual( doc.getData(), expectedData, 'unwrapping 4 levels (table, tableSection, tableRow and tableCell)' ); } ); QUnit.test( 'rewrapAllNodes', 6, function ( assert ) { var expectedData, doc = ve.dm.example.createExampleDocument(), originalDoc = ve.dm.example.createExampleDocument(), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 5, 37 ) ), expectedDoc = ve.dm.example.createExampleDocument(), expectedSurface = new ve.dm.Surface( expectedDoc ), expectedFragment = new ve.dm.SurfaceFragment( expectedSurface, new ve.Range( 5, 37 ) ), created = { 'changed': { 'created' : 1 } }; // Compare a rewrap operation with its equivalent unwrap + wrap // This type of test can only exist if the intermediate state is valid fragment.rewrapAllNodes( 4, [{ 'type': 'list', 'attributes': { 'style': 'bullet' } }, { 'type': 'listItem' }] ); expectedFragment.unwrapNodes( 0, 4 ); expectedFragment.wrapAllNodes( [{ 'type': 'list', 'attributes': { 'style': 'bullet' } }, { 'type': 'listItem' }] ); assert.deepEqual( doc.getData(), expectedDoc.getData(), 'rewrapping multiple nodes via a valid intermediate state produces the same document as unwrapping then wrapping' ); assert.deepEqual( fragment.getRange(), expectedFragment.getRange(), 'new range contains rewrapping elements' ); // Reverse of first test fragment.rewrapAllNodes( 2, [ { 'type': 'table', }, { 'type': 'tableSection', 'attributes': { 'style': 'body' } }, { 'type': 'tableRow' }, { 'type': 'tableCell', 'attributes': { 'style': 'data' } } ] ); expectedData = originalDoc.getData(); expectedData[5].internal = created; expectedData[6].internal = created; expectedData[7].internal = created; expectedData[8].internal = created; assert.deepEqual( doc.getData(), expectedData, 'rewrapping multiple nodes via a valid intermediate state produces the same document as unwrapping then wrapping' ); assert.deepEqual( fragment.getRange(), new ve.Range( 5, 37 ), 'new range contains rewrapping elements' ); // Rewrap a heading as a paragraph // The intermediate stage (plain text attached to the document) would be invalid // if performed as an unwrap and a wrap fragment = new ve.dm.SurfaceFragment( surface, new ve.Range( 0, 5 ) ); fragment.rewrapAllNodes( 1, [ { 'type': 'paragraph' } ] ); expectedData.splice( 0, 1, { 'type': 'paragraph', 'internal': created } ); expectedData.splice( 4, 1, { 'type': '/paragraph' } ); assert.deepEqual( doc.getData(), expectedData, 'rewrapping a heading as a paragraph' ); assert.deepEqual( fragment.getRange(), new ve.Range( 0, 5 ), 'new range contains rewrapping elements' ); } ); function runIsolateTest( assert, type, range, expected, label ) { var doc = ve.dm.example.createExampleDocument( 'isolationData' ), surface = new ve.dm.Surface( doc ), fragment = new ve.dm.SurfaceFragment( surface, range ), data; data = ve.copyArray( doc.getFullData() ); fragment.isolateAndUnwrap( type ); expected( data ); assert.deepEqual( doc.getFullData(), data, label ); } QUnit.test( 'isolateAndUnwrap', 4, function ( assert ) { var rebuilt = { 'changed': { 'rebuilt': 1 } }, createdAndRebuilt = { 'changed': { 'created': 1, 'rebuilt': 1 } }; runIsolateTest( assert, 'MWheading', new ve.Range( 12, 20 ), function( data ) { data[0].internal = rebuilt; data.splice( 11, 0, { 'type': '/list' } ); data.splice( 12, 1 ); data.splice( 20, 1, { 'type': 'list', 'attributes': { 'style': 'bullet' }, 'internal': createdAndRebuilt }); }, 'isolating paragraph in list item "Item 2" for MWheading'); runIsolateTest( assert, 'heading', new ve.Range( 12, 20 ), function( data ) { data.splice( 11, 0, { 'type': 'listItem' } ); data.splice( 12, 1 ); data.splice( 20, 1, { 'type': '/listItem' }); }, 'isolating paragraph in list item "Item 2" for heading'); runIsolateTest( assert, 'MWheading', new ve.Range( 89, 97 ), function( data ) { data[75].internal = rebuilt; data[76].internal = rebuilt; data[77].internal = rebuilt; data.splice( 88, 1, { 'type': '/tableRow' }, { 'type': '/tableSection' }, { 'type': '/table' } ); data.splice( 99, 1, { 'type': 'table', 'internal': createdAndRebuilt }, { 'type': 'tableSection', 'attributes': { 'style': 'body' }, 'internal': createdAndRebuilt }, { 'type': 'tableRow', 'internal': createdAndRebuilt } ); }, 'isolating "Cell 2" for MWheading'); runIsolateTest( assert, 'MWheading', new ve.Range( 202, 212 ), function( data ) { data[186].internal = rebuilt; data[187].internal = rebuilt; data[188].internal = rebuilt; data.splice( 201, 1, { 'type': '/list' }, { 'type': '/listItem' }, { 'type': '/list' } ); data.splice( 214, 1, { 'type': 'list', 'attributes': { 'style': 'bullet' }, 'internal': createdAndRebuilt }, { 'type': 'listItem', 'internal': createdAndRebuilt }, { 'type': 'list', 'attributes': { 'style': 'number' }, 'internal': createdAndRebuilt } ); }, 'isolating paragraph in list item "Nested 2" for MWheading'); } );