Merge pull request #202 from zero21xxx/is-implementation

added: .is(selector) [zero21xxx]

Readme.md

@@ -201,6 +201,10 @@ $('.apple').addClass('red').removeClass().html()
 
 > See http://api.jquery.com/removeClass/ for more information.
 
+#### .is( selector )
+#### .is( function(index) )
+Checks the current list of elements and returns `true` if _any_ of the elements match the selector. If using a predicate function, the function is executed in the context of the selected element, so `this` refers to the current element.
+
 
 ### Traversing
 

lib/api/attributes.js

@@ -217,3 +217,11 @@ var removeClass = exports.removeClass = function(value) {
     ).join(' ');
   });
 };
+
+var is = exports.is = function (selector) {
+  if (selector) {
+    return this.filter(selector).length > 0;
+  }
+  return false;
+}
+

test/api.attributes.js

@@ -53,13 +53,13 @@ describe('$(...)', function() {
       $apple.attr('href', 'http://github.com/"><script>alert("XSS!")</script><br');
       expect($apple.html()).to.not.contain('<script>alert("XSS!")</script>');
     });
-    
+
     it('(key, value) : should coerce values to a string', function() {
       var $apple = $('.apple', fruits);
       $apple.attr('data-test', 1);
       expect($apple[0].attribs['data-test']).to.equal('1');
       expect($apple.attr('data-test')).to.equal('1');
-    });    
+    });
   });
 
   describe('.val', function() {
@@ -257,4 +257,28 @@ describe('$(...)', function() {
 
   });
 
+  describe('.is', function () {
+    it('() should return false', function  () {
+      expect($('li.apple', fruits).is()).to.be(false)
+    })
+    it('(true selector) should return true', function () {
+      expect($('#vegetables', vegetables).is('ul')).to.be(true)
+    })
+    it('(false selector) should return false', function () {
+      expect($('#vegetables', vegetables).is('div')).to.be(false)
+    })
+    it('(true predicate) should return true', function () {
+      var result = $('li', fruits).is(function() {
+        return this.hasClass('pear')
+      })
+      expect(result).to.be(true)
+    })
+    it('(false predicate) should return false', function () {
+      var result = $('li', fruits).last().is(function() {
+        return this.name === 'ul'
+      })
+      expect(result).to.be(false)
+    })
+  })
+
 });