mediawiki-extensions-Visual.../modules/ve/test/dm/ve.dm.BranchNode.test.js
Timo Tijhof 88f6089952 Kranitor #1: On-boarding
'''Kranitor commits''' are commits by Krinkle with his janitor hat on.
Must never contain functional changes mixed with miscellaneous changes.

.gitignore:
 * Add .DS_Store to the ignore list so that browsing the directories
   on Mac OS X, will not add these files to the list of untracked
   files.
 * Fix missing newline at end of file

.jshintrc
 * raises -> throws
 * +module (QUnit.module)
 * remove 'Node' (as of node-jshint 1.7.2 this is now part of
   'browser:true', as it should be)

Authors:
 * Adding myself

MWExtension/VisualEditor.php
 * Fix default value of wgVisualEditorParsoidURL to not
   point to the experimental instance in WMF Labs.

Issues:
 * ve.ce.TextNode:
  - Fix TODO: Don't perform a useless clone of an already-jQuerified object.
  - Use .html() to set html content instead of encapsulating between
    two strings. This is slightly faster but more importantly safer,
    and prevents situations where the resulting jQuery collection
    actually contains 2 elements instead of 1, thus messing up
    what .contents() is iterating over.
 * ve.ce.Document.test.js
  - Fix: ReferenceError: assert is not defined
 * ve.dm.Document.test.js
  - Fix: ReferenceError: assert is not defined
 * ve.dm.Transaction.test.js
  - Fix: ReferenceError: assert is not defined
 * ve.dm.TransactionProcessor.test.js
  - Fix: ReferenceError: assert is not defined
 * ext.visualEditor.viewPageTarget
  - Missing dependency on 'mediawiki.Title'

Code conventions / Misc cleanup
 * Various JSHint warnings.
 * Whitespace
 * jQuery(): Use '<tag>' for element creation,
   use '<valid><xml/></valid>' for parsing
 * Use the default operator instead of ternary when the condition and
   first value are the same.
   x = foo ? foo : bar; -> x = foo || bar;
   Because contrary to some programming language (PHP...), in JS the
   default operator does not enforce a boolean result but returns the
   original value, hence it being called the 'default' operator, as
   opposed to the 'or' operator.
 * No need to call addClass() twice, it takes a space-separated list
   (jQuery splits by space and adds if needed)
 * Use .on( event[, selector], fn ) instead of the deprecated
   routers to it such as .bind(), .delegate() and .live().
   All these three are now built-in and fully compatible with .on()
 * Add 'XXX:' comments for suspicious code that I don't want to change
   as part of a clean up commit.
 * Remove unused variables (several var x = this; where x was not
   used anywhere, possibly from boilerplate copy/paste)
 * Follows-up Trevor's commit that converts test suites to the new
   QUnit format. Also removed the globals since we no longer use those
   any more.

Change-Id: I7e37c9bff812e371c7f65a6fd85d9e2af3e0a22f
2012-07-27 14:40:00 -07:00

142 lines
4.5 KiB
JavaScript

/**
* VisualEditor data model BranchNode tests.
*
* @copyright 2011-2012 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
QUnit.module( 've.dm.BranchNode' );
/* Stubs */
ve.dm.BranchNodeStub = function ( children, attributes ) {
// Inheritance
ve.dm.BranchNode.call( this, 'branch-stub', children, attributes );
};
ve.dm.BranchNodeStub.rules = {
'isWrapped': true,
'isContent': false,
'canContainContent': false,
'childNodeTypes': null
};
ve.dm.BranchNodeStub.converters = null;
ve.extendClass( ve.dm.BranchNodeStub, ve.dm.BranchNode );
ve.dm.nodeFactory.register( 'branch-stub', ve.dm.BranchNodeStub );
/* Tests */
QUnit.test( 'canHaveChildren', 1, function ( assert ) {
var node = new ve.dm.BranchNodeStub();
assert.equal( node.canHaveChildren(), true );
} );
QUnit.test( 'canHaveGrandchildren', 1, function ( assert ) {
var node = new ve.dm.BranchNodeStub();
assert.equal( node.canHaveGrandchildren(), true );
} );
QUnit.test( 'setRoot', 3, function ( assert ) {
var node1 = new ve.dm.BranchNodeStub(),
node2 = new ve.dm.BranchNodeStub( [node1] ),
node3 = new ve.dm.BranchNodeStub( [node2] ),
node4 = new ve.dm.BranchNodeStub();
node3.setRoot( node4 );
assert.strictEqual( node3.getRoot(), node4 );
assert.strictEqual( node2.getRoot(), node4 );
assert.strictEqual( node1.getRoot(), node4 );
} );
QUnit.test( 'setDocument', 3, function ( assert ) {
var node1 = new ve.dm.BranchNodeStub(),
node2 = new ve.dm.BranchNodeStub( [node1] ),
node3 = new ve.dm.BranchNodeStub( [node2] ),
node4 = new ve.dm.BranchNodeStub();
node3.setDocument( node4 );
assert.strictEqual( node3.getDocument(), node4 );
assert.strictEqual( node2.getDocument(), node4 );
assert.strictEqual( node1.getDocument(), node4 );
} );
QUnit.test( 'push', 3, function ( assert ) {
var node1 = new ve.dm.BranchNodeStub(),
node2 = new ve.dm.BranchNodeStub(),
node3 = new ve.dm.BranchNodeStub( [node1] );
node3.on( 'splice', function () {
// Will be called 1 time
assert.ok( true, 'splice was emitted' );
} );
assert.strictEqual( node3.push( node2 ), 2 );
assert.deepEqual( node3.getChildren(), [node1, node2] );
} );
QUnit.test( 'pop', 3, function ( assert ) {
var node1 = new ve.dm.BranchNodeStub(),
node2 = new ve.dm.BranchNodeStub(),
node3 = new ve.dm.BranchNodeStub( [node1, node2] );
node3.on( 'splice', function () {
// Will be called 1 time
assert.ok( true, 'splice was emitted' );
} );
assert.strictEqual( node3.pop(), node2 );
assert.deepEqual( node3.getChildren(), [node1] );
} );
QUnit.test( 'unshift', 3, function ( assert ) {
var node1 = new ve.dm.BranchNodeStub(),
node2 = new ve.dm.BranchNodeStub(),
node3 = new ve.dm.BranchNodeStub( [node1] );
node3.on( 'splice', function () {
// Will be called 1 time
assert.ok( true, 'splice was emitted' );
} );
assert.strictEqual( node3.unshift( node2 ), 2 );
assert.deepEqual( node3.getChildren(), [node2, node1] );
} );
QUnit.test( 'shift', 3, function ( assert ) {
var node1 = new ve.dm.BranchNodeStub(),
node2 = new ve.dm.BranchNodeStub(),
node3 = new ve.dm.BranchNodeStub( [node1, node2] );
node3.on( 'splice', function() {
// Will be called 1 time
assert.ok( true, 'splice was emitted' );
} );
assert.strictEqual( node3.shift(), node1 );
assert.deepEqual( node3.getChildren(), [node2] );
} );
QUnit.test( 'splice', 9, function ( assert ) {
var node1 = new ve.dm.BranchNodeStub(),
node2 = new ve.dm.BranchNodeStub(),
node3 = new ve.dm.BranchNodeStub(),
node4 = new ve.dm.BranchNodeStub( [node1, node2] );
node4.on( 'splice', function () {
// Will be called 3 times
assert.ok( true, 'splice was emitted' );
} );
// Insert branch
assert.deepEqual( node4.splice( 1, 0, node3 ), [] );
assert.deepEqual( node4.getChildren(), [node1, node3, node2] );
// Remove branch
assert.deepEqual( node4.splice( 1, 1 ), [node3] );
assert.deepEqual( node4.getChildren(), [node1, node2] );
// Remove branch and insert branch
assert.deepEqual( node4.splice( 1, 1, node3 ), [node2] );
assert.deepEqual( node4.getChildren(), [node1, node3] );
} );
QUnit.test( 'getOffsetFromNode', 4, function ( assert ) {
var node1 = new ve.dm.BranchNodeStub(),
node2 = new ve.dm.BranchNodeStub(),
node3 = new ve.dm.BranchNodeStub( [node1, node2] ),
node4 = new ve.dm.BranchNodeStub( [node3] );
assert.strictEqual( node4.getOffsetFromNode( node1 ), 1 );
assert.strictEqual( node4.getOffsetFromNode( node2 ), 3 );
assert.strictEqual( node4.getOffsetFromNode( node3 ), 0 );
assert.strictEqual( node4.getOffsetFromNode( node4 ), 0 );
} );