Selector: add jQuery.uniqueSort; deprecate jQuery.unique

timmywil · timmywil · commit e1090c3d2b2a · 2015-05-04T15:27:12.000-07:00
Fixes gh-2228
diff --git a/src/selector-sizzle.js b/src/selector-sizzle.js
@@ -6,7 +6,7 @@ define([
 jQuery.find = Sizzle;
 jQuery.expr = Sizzle.selectors;
 jQuery.expr[":"] = jQuery.expr.pseudos;
-jQuery.unique = Sizzle.uniqueSort;
+jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort;
 jQuery.text = Sizzle.getText;
 jQuery.isXMLDoc = Sizzle.isXML;
 jQuery.contains = Sizzle.contains;
diff --git a/src/traversing.js b/src/traversing.js
@@ -85,7 +85,7 @@ jQuery.fn.extend({
 			}
 		}
 
-		return this.pushStack( matched.length > 1 ? jQuery.unique( matched ) : matched );
+		return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched );
 	},
 
 	// Determine the position of an element within the set
@@ -111,7 +111,7 @@ jQuery.fn.extend({
 
 	add: function( selector, context ) {
 		return this.pushStack(
-			jQuery.unique(
+			jQuery.uniqueSort(
 				jQuery.merge( this.get(), jQuery( selector, context ) )
 			)
 		);
@@ -182,7 +182,7 @@ jQuery.each({
 		if ( this.length > 1 ) {
 			// Remove duplicates
 			if ( !guaranteedUnique[ name ] ) {
-				jQuery.unique( matched );
+				jQuery.uniqueSort( matched );
 			}
 
 			// Reverse order for parents* and prev-derivatives
diff --git a/src/traversing/findFilter.js b/src/traversing/findFilter.js
@@ -72,7 +72,7 @@ jQuery.fn.extend({
 			jQuery.find( selector, self[ i ], ret );
 		}
 
-		return this.pushStack( len > 1 ? jQuery.unique( ret ) : ret );
+		return this.pushStack( len > 1 ? jQuery.uniqueSort( ret ) : ret );
 	},
 	filter: function( selector ) {
 		return this.pushStack( winnow(this, selector || [], false) );
diff --git a/test/unit/selector.js b/test/unit/selector.js
@@ -386,7 +386,7 @@ test( "jQuery.contains", function() {
 	ok( !jQuery.contains(document, detached), "document container (negative)" );
 });
 
-test("jQuery.unique", function() {
+test("jQuery.uniqueSort", function() {
 	expect( 14 );
 
 	function Arrayish( arr ) {
@@ -460,8 +460,8 @@ test("jQuery.unique", function() {
 
 	jQuery.each( tests, function( label, test ) {
 		var length = test.length || test.input.length;
-		deepEqual( jQuery.unique( test.input ).slice( 0, length ), test.expected, label + " (array)" );
-		deepEqual( jQuery.unique( new Arrayish(test.input) ).slice( 0, length ), test.expected, label + " (quasi-array)" );
+		deepEqual( jQuery.uniqueSort( test.input ).slice( 0, length ), test.expected, label + " (array)" );
+		deepEqual( jQuery.uniqueSort( new Arrayish(test.input) ).slice( 0, length ), test.expected, label + " (quasi-array)" );
 	});
 });
 
diff --git a/test/unit/traversing.js b/test/unit/traversing.js
@@ -696,7 +696,7 @@ test("sort direction", function() {
 
 	jQuery.each( methodDirections, function( method, reversed ) {
 		var actual = elems[ method ]().get(),
-			forward = jQuery.unique( [].concat( actual ) );
+			forward = jQuery.uniqueSort( [].concat( actual ) );
 		deepEqual( actual, reversed ? forward.reverse() : forward, "Correct sort direction for " + method );
 	});
 });

Original file line number	Diff line number	Diff line change
`@@ -85,7 +85,7 @@ jQuery.fn.extend({`
`85`	`85`	`}`
`86`	`86`	`}`
`87`	`87`
`88`		`- return this.pushStack( matched.length > 1 ? jQuery.unique( matched ) : matched );`
	`88`	`+ return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched );`
`89`	`89`	`},`
`90`	`90`
`91`	`91`	`// Determine the position of an element within the set`
`@@ -111,7 +111,7 @@ jQuery.fn.extend({`
`111`	`111`
`112`	`112`	`add: function( selector, context ) {`
`113`	`113`	`return this.pushStack(`
`114`		`- jQuery.unique(`
	`114`	`+ jQuery.uniqueSort(`
`115`	`115`	`jQuery.merge( this.get(), jQuery( selector, context ) )`
`116`	`116`	`)`
`117`	`117`	`);`
`@@ -182,7 +182,7 @@ jQuery.each({`
`182`	`182`	`if ( this.length > 1 ) {`
`183`	`183`	`// Remove duplicates`
`184`	`184`	`if ( !guaranteedUnique[ name ] ) {`
`185`		`- jQuery.unique( matched );`
	`185`	`+ jQuery.uniqueSort( matched );`
`186`	`186`	`}`
`187`	`187`
`188`	`188`	`// Reverse order for parents* and prev-derivatives`
Original file line number	Diff line number	Diff line change
`@@ -72,7 +72,7 @@ jQuery.fn.extend({`
`72`	`72`	`jQuery.find( selector, self[ i ], ret );`
`73`	`73`	`}`
`74`	`74`
`75`		`- return this.pushStack( len > 1 ? jQuery.unique( ret ) : ret );`
	`75`	`+ return this.pushStack( len > 1 ? jQuery.uniqueSort( ret ) : ret );`
`76`	`76`	`},`
`77`	`77`	`filter: function( selector ) {`
`78`	`78`	`return this.pushStack( winnow(this, selector \|\| [], false) );`