Introduced CKEDITOR.dom.nodeList#toArray method

CHANGES.md

@@ -21,6 +21,10 @@ Fixed Issues:
 * [#644](https://github.com/ckeditor/ckeditor-dev/issues/644): Fixed: The [`range.extractContents`](http://docs.ckeditor.com/#!/api/CKEDITOR.dom.range-method-extractContents) returns incorrect result when multiple nodes are selected.
 * [#684](https://github.com/ckeditor/ckeditor-dev/issues/684): Fixed: The [`elementPath.contains`](http://docs.ckeditor.com/#!/api/CKEDITOR.dom.elementPath-method-contains) incorrectly excludes last element instead of root when `fromTop` parameter is set to true.
 
+Other Changes:
+
+* [#751](https://github.com/ckeditor/ckeditor-dev/issues/751): Added [CKEDITOR.dom.nodeList.toArray](https://docs.ckeditor.com/#!/api/CKEDITOR.dom.nodeList-method-toArray) method which returns array representation of a [nodeList](https://docs.ckeditor.com/#!/api/CKEDITOR.dom.nodeList).
+
 ## CKEditor 4.7.1
 
 New Features:

core/dom/nodelist.js

@@ -39,5 +39,16 @@ CKEDITOR.dom.nodeList.prototype = {
 
 		var $node = this.$[ index ];
 		return $node ? new CKEDITOR.dom.node( $node ) : null;
+	},
+
+	/**
+	 * Returns node list as an array.
+	 *
+	 * @returns {CKEDITOR.dom.node[]}
+	 */
+	toArray: function() {
+		return CKEDITOR.tools.array.map( this.$, function( nativeEl ) {
+			return new CKEDITOR.dom.node( nativeEl );
+		} );
 	}
 };

tests/core/dom/nodeList.html

@@ -0,0 +1,6 @@
+<div id="playground">
+	<span id="el1">foo</span>
+	<span id="el2">foo</span>
+	<span id="el3">foo</span>
+	<span>foo</span>
+</div>

tests/core/dom/nodeList.js

@@ -0,0 +1,27 @@
+/* bender-tags: editor,dom */
+
+( function() {
+	'use strict';
+
+	bender.test( {
+		'test nodeList.toArray()': function() {
+			var list = CKEDITOR.document.find( '#playground span[id]' ),
+				ret = list.toArray();
+
+			assert.isArray( ret );
+			assert.areSame( 3, ret.length, 'Array length' );
+
+			for ( var i = 0; i < ret.length; i++ ) {
+				assert.areSame( list.getItem( i ), ret[ i ], 'Item ' + i );
+			}
+		},
+
+		'test nodeList.toArray() empty list': function() {
+			var ret = CKEDITOR.document.find( '#nonExistingId__' ).toArray();
+
+			assert.isArray( ret );
+			assert.areSame( 0, ret.length, 'Array length' );
+		}
+	} );
+
+} )();