🕷️ Crawler Inspector

URL Lookup

Direct Parameter Lookup

Raw Queries and Responses

1. Shard Calculation

Query:
Response:
Calculated Shard: 53 (from laksa166)

2. Crawled Status Check

Query:
Response:

3. Robots.txt Check

Query:
Response:

4. Spam/Ban Check

Query:
Response:

5. Seen Status Check

ℹ️ Skipped - page is already crawled

📄
INDEXABLE
CRAWLED
4 hours ago
🤖
ROBOTS ALLOWED

Page Info Filters

FilterStatusConditionDetails
HTTP statusPASSdownload_http_code = 200HTTP 200
Age cutoffPASSdownload_stamp > now() - 6 MONTH0 months ago
History dropPASSisNull(history_drop_reason)No drop reason
Spam/banPASSfh_dont_index != 1 AND ml_spam_score = 0ml_spam_score=0
CanonicalPASSmeta_canonical IS NULL OR = '' OR = src_unparsedNot set

Page Details

PropertyValue
URLhttps://api.jquery.com/is/
Last Crawled2026-04-14 06:06:31 (4 hours ago)
First Indexed2013-08-16 07:08:12 (12 years ago)
HTTP Status Code200
Meta Title.is() | jQuery API Documentation
Meta Descriptionnull
Meta Canonicalnull
Boilerpipe Text
.is( selector ) Returns: Boolean Description: Check the current matched set of elements against a selector, element, or jQuery object and return true if at least one of these elements matches the given arguments. version added: 1.0 .is( selector ) selector A string containing a selector expression to match elements against. version added: 1.6 .is( function ) function A function used as a test for every element in the set. It accepts two arguments, index , which is the element's index in the jQuery collection, and element , which is the DOM element. Within the function, this refers to the current DOM element. version added: 1.6 .is( selection ) selection An existing jQuery object to match the current set of elements against. version added: 1.6 .is( elements ) elements One or more elements to match the current set of elements against. Unlike other filtering methods, .is() does not create a new jQuery object. Instead, it allows you to test the contents of a jQuery object without modification. This is often useful inside callbacks, such as event handlers. Suppose you have a list, with two of its items containing a child element: 1 2 3 4 5 < ul > < li > list < strong > item 1 </ strong > </ li > < li > < span > list item 2 </ span > </ li > < li > list item 3 </ li > </ ul > You can attach a click handler to the <ul> element, and then limit the code to be triggered only when a list item itself, not one of its children, is clicked: 1 2 3 4 5 6 $( "ul" ).on( "click" , function ( event ) { var target = $( event.target ); if ( target.is( "li" ) ) { target.css( "background-color" , "red" ); } }); Now, when the user clicks on the word "list" in the first item or anywhere in the third item, the clicked list item will be given a red background. However, when the user clicks on item 1 in the first item or anywhere in the second item, nothing will occur, because in those cases the target of the event would be <strong> or <span> , respectively. Using a Function The second form of this method evaluates expressions related to elements based on a function rather than a selector. For each element, if the function returns true , .is() returns true as well. For example, given a somewhat more involved HTML snippet: 1 2 3 4 5 6 7 8 < ul > < li > < strong > list </ strong > item 1 - one strong tag </ li > < li > < strong > list </ strong > item < strong > 2 </ strong > - two < span > strong tags </ span > </ li > < li > list item 3 </ li > < li > list item 4 </ li > < li > list item 5 </ li > </ ul > You can attach a click handler to every <li> that evaluates the number of <strong> elements within the clicked <li> at that time like so: 1 2 3 4 5 6 7 8 9 10 11 $( "li" ).on( "click" , function ( ) { var li = $( this ), isWithTwo = li.is( function ( ) { return $( "strong" , this ).length === 2 ; }); if ( isWithTwo ) { li.css( "background-color" , "green" ); } else { li.css( "background-color" , "red" ); } }); Examples: Example 1 Shows a few ways is() can be used inside an event handler. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 <!doctype html > < html lang = "en" > < head > < meta charset = "utf-8" > < title > is demo </ title > < style > div { width : 60px ; height : 60px ; margin : 5px ; float : left; border : 4px outset; background : green; text-align : center; font-weight : bolder; cursor : pointer; } .blue { background : blue; } .red { background : red; } span { color : white; font-size : 16px ; } p { color : red; font-weight : bolder; background : yellow; margin : 3px ; clear : left; display : none; } </ style > < script src = "https://code.jquery.com/jquery-4.0.0.js" > </ script > </ head > < body > < div > </ div > < div class = "blue" > </ div > < div > </ div > < div class = "red" > </ div > < div > < br /> < span > Peter </ span > </ div > < div class = "blue" > </ div > < p > &nbsp; </ p > < script > $( "div" ).one( "click" , function ( ) { if ( $( this ).is( ":first-child" ) ) { $( "p" ).text( "It's the first div." ); } else if ( $( this ).is( ".blue,.red" ) ) { $( "p" ).text( "It's a blue or red div." ); } else if ( $( this ).is( ":contains('Peter')" ) ) { $( "p" ).text( "It's Peter!" ); } else { $( "p" ).html( "It's nothing <em>special</em>." ); } $( "p" ).hide().slideDown( "slow" ); $( this ).css({ "border-style" : "inset" , cursor : "default" }); }); </ script > </ body > </ html > Demo: Example 2 Returns true, because the parent of the input is a form element. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 <!doctype html > < html lang = "en" > < head > < meta charset = "utf-8" > < title > is demo </ title > < style > div { color : red; } </ style > < script src = "https://code.jquery.com/jquery-4.0.0.js" > </ script > </ head > < body > < form > < input type = "checkbox" > </ form > < div > </ div > < script > var isFormParent = $( "input[type='checkbox']" ).parent().is( "form" ); $( "div" ).text( "isFormParent = " + isFormParent ); </ script > </ body > </ html > Demo: Example 3 Returns false, because the parent of the input is a p element. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 <!doctype html > < html lang = "en" > < head > < meta charset = "utf-8" > < title > is demo </ title > < style > div { color : red; } </ style > < script src = "https://code.jquery.com/jquery-4.0.0.js" > </ script > </ head > < body > < form > < p > < input type = "checkbox" > </ p > </ form > < div > </ div > < script > var isFormParent = $( "input[type='checkbox']" ).parent().is( "form" ); $( "div" ).text( "isFormParent = " + isFormParent ); </ script > </ body > </ html > Demo: Example 4 Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 <!doctype html > < html lang = "en" > < head > < meta charset = "utf-8" > < title > is demo </ title > < style > li { cursor : pointer; } </ style > < script src = "https://code.jquery.com/jquery-4.0.0.js" > </ script > </ head > < body > < ul id = "browsers" > < li > Chrome </ li > < li > Safari </ li > < li > Firefox </ li > < li > Opera </ li > </ ul > < script > var alt = $( "#browsers li:nth-child(2n)" ).css( "background" , "#0ff" ); $( "li" ).on( "click" , function ( ) { var li = $( this ); if ( li.is( alt ) ) { li.slideUp(); } else { li.css( "background" , "red" ); } }); </ script > </ body > </ html > Demo: Example 5 An alternate way to achieve the above example using an element rather than a jQuery object. Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 <!doctype html > < html lang = "en" > < head > < meta charset = "utf-8" > < title > is demo </ title > < style > li { cursor : pointer; } </ style > < script src = "https://code.jquery.com/jquery-4.0.0.js" > </ script > </ head > < body > < ul id = "browsers" > < li > Chrome </ li > < li > Safari </ li > < li > Firefox </ li > < li > Opera </ li > </ ul > < script > var alt = $( "#browsers li:nth-child(2n)" ).css( "background" , "#0ff" ); $( "li" ).on( "click" , function ( ) { if ( alt.is( this ) ) { $( this ).slideUp(); } else { $( this ).css( "background" , "red" ); } }); </ script > </ body > </ html > Demo:
Markdown
- [jQuery](https://jquery.com/ "jQuery") - [jQuery UI](https://jqueryui.com/ "jQuery UI") - [jQuery Mobile](https://jquerymobile.com/ "jQuery Mobile") - [Sizzle](https://sizzlejs.com/ "Sizzle") - [QUnit](https://qunitjs.com/ "QUnit") - [Plugins](https://plugins.jquery.com/) - [Contribute](https://contribute.jquery.org/) - [CLA](https://cla.openjsf.org/) - [Style Guides](https://contribute.jquery.org/style-guide/) - [Bug Triage](https://contribute.jquery.org/triage/) - [Code](https://contribute.jquery.org/code/) - [Documentation](https://contribute.jquery.org/documentation/) - [Web Sites](https://contribute.jquery.org/web-sites/) - [Events](https://events.jquery.org/) - [Support](https://jquery.com/support/) - [Learning Center](https://learn.jquery.com/) - [Chat](https://jquery.com/support/) - [Stack Overflow](https://stackoverflow.com/tags/jquery/info) - [Report a bug](https://contribute.jquery.org/bug-reports/) - [OpenJS Foundation](https://openjsf.org/) - [Join](https://openjsf.org/join) - [Members](https://openjsf.org/members) - [jQuery Team](https://jquery.com/team) - [Governance](https://openjsf.org/governance) - [Conduct](https://code-of-conduct.openjsf.org/) - [Projects](https://openjsf.org/projects) ## [jQuery API Documentation](https://jquery.com/ "jQuery API Documentation") Navigation - [Download](https://jquery.com/download/) - [API Documentation](https://api.jquery.com/) - [Blog](https://blog.jquery.com/) - [Plugins](https://plugins.jquery.com/) - [Browser Support](https://jquery.com/browser-support/) - [Version Support](https://jquery.com/support/) # .is() *** Categories: [Traversing](https://api.jquery.com/category/traversing/) \> [Filtering](https://api.jquery.com/category/traversing/filtering/) ## .is( selector )Returns: [Boolean](http://api.jquery.com/Types/#Boolean) **Description:** Check the current matched set of elements against a selector, element, or jQuery object and return `true` if at least one of these elements matches the given arguments. - #### version added: [1\.0](https://api.jquery.com/category/version/1.0/)[.is( selector )](https://api.jquery.com/is/#is-selector) - **selector** Type: [Selector](http://api.jquery.com/Types/#Selector) A string containing a selector expression to match elements against. - #### version added: [1\.6](https://api.jquery.com/category/version/1.6/)[.is( function )](https://api.jquery.com/is/#is-function) - **function** Type: [Function](http://api.jquery.com/Types/#Function)( [Integer](http://api.jquery.com/Types/#Integer) index, [Element](http://api.jquery.com/Types/#Element) element ) =\> [Boolean](http://api.jquery.com/Types/#Boolean) A function used as a test for every element in the set. It accepts two arguments, `index`, which is the element's index in the jQuery collection, and `element`, which is the DOM element. Within the function, `this` refers to the current DOM element. - #### version added: [1\.6](https://api.jquery.com/category/version/1.6/)[.is( selection )](https://api.jquery.com/is/#is-selection) - **selection** Type: [jQuery](http://api.jquery.com/Types/#jQuery) An existing jQuery object to match the current set of elements against. - #### version added: [1\.6](https://api.jquery.com/category/version/1.6/)[.is( elements )](https://api.jquery.com/is/#is-elements) - **elements** Type: [Element](http://api.jquery.com/Types/#Element) One or more elements to match the current set of elements against. Unlike other filtering methods, `.is()` does not create a new jQuery object. Instead, it allows you to test the contents of a jQuery object without modification. This is often useful inside callbacks, such as event handlers. Suppose you have a list, with two of its items containing a child element: | | | |---|---| | 1 2 3 4 5 | | You can attach a click handler to the \<ul\> element, and then limit the code to be triggered only when a list item itself, not one of its children, is clicked: | | | |---|---| | 1 2 3 4 5 6 | | Now, when the user clicks on the word "list" in the first item or anywhere in the third item, the clicked list item will be given a red background. However, when the user clicks on item 1 in the first item or anywhere in the second item, nothing will occur, because in those cases the target of the event would be `<strong>` or `<span>`, respectively. #### Using a Function The second form of this method evaluates expressions related to elements based on a function rather than a selector. For each element, if the function returns `true`, `.is()` returns `true` as well. For example, given a somewhat more involved HTML snippet: | | | |---|---| | 1 2 3 4 5 6 7 8 | | You can attach a click handler to every `<li>` that evaluates the number of `<strong>` elements within the clicked `<li>` at that time like so: | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 | | ## Examples: ### Example 1 Shows a few ways is() can be used inside an event handler. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 | | #### Demo: ### Example 2 Returns true, because the parent of the input is a form element. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | | #### Demo: ### Example 3 Returns false, because the parent of the input is a p element. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | | #### Demo: ### Example 4 Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | | #### Demo: ### Example 5 An alternate way to achieve the above example using an element rather than a jQuery object. Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 | | #### Demo: - [Ajax](https://api.jquery.com/category/ajax/) - [Global Ajax Event Handlers](https://api.jquery.com/category/ajax/global-ajax-event-handlers/) - [Helper Functions](https://api.jquery.com/category/ajax/helper-functions/) - [Low-Level Interface](https://api.jquery.com/category/ajax/low-level-interface/) - [Shorthand Methods](https://api.jquery.com/category/ajax/shorthand-methods/) - [Attributes](https://api.jquery.com/category/attributes/) - [Callbacks Object](https://api.jquery.com/category/callbacks-object/) - [Core](https://api.jquery.com/category/core/) - [CSS](https://api.jquery.com/category/css/) - [Data](https://api.jquery.com/category/data/) - [Deferred Object](https://api.jquery.com/category/deferred-object/) - [Deprecated](https://api.jquery.com/category/deprecated/) - [Deprecated 1.3](https://api.jquery.com/category/deprecated/deprecated-1.3/) - [Deprecated 1.7](https://api.jquery.com/category/deprecated/deprecated-1.7/) - [Deprecated 1.8](https://api.jquery.com/category/deprecated/deprecated-1.8/) - [Deprecated 1.9](https://api.jquery.com/category/deprecated/deprecated-1.9/) - [Deprecated 1.10 & 2.0](https://api.jquery.com/category/deprecated/deprecated-1.10-and-2.0/) - [Deprecated 3.0](https://api.jquery.com/category/deprecated/deprecated-3.0/) - [Deprecated 3.2](https://api.jquery.com/category/deprecated/deprecated-3.2/) - [Deprecated 3.3](https://api.jquery.com/category/deprecated/deprecated-3.3/) - [Deprecated 3.4](https://api.jquery.com/category/deprecated/deprecated-3.4/) - [Deprecated 3.5](https://api.jquery.com/category/deprecated/deprecated-3.5/) - [Deprecated 3.7](https://api.jquery.com/category/deprecated/deprecated-3.7/) - [Dimensions](https://api.jquery.com/category/dimensions/) - [Effects](https://api.jquery.com/category/effects/) - [Basics](https://api.jquery.com/category/effects/basics/) - [Custom](https://api.jquery.com/category/effects/custom-effects/) - [Fading](https://api.jquery.com/category/effects/fading/) - [Sliding](https://api.jquery.com/category/effects/sliding/) - [Events](https://api.jquery.com/category/events/) - [Browser Events](https://api.jquery.com/category/events/browser-events/) - [Document Loading](https://api.jquery.com/category/events/document-loading/) - [Event Handler Attachment](https://api.jquery.com/category/events/event-handler-attachment/) - [Event Object](https://api.jquery.com/category/events/event-object/) - [Form Events](https://api.jquery.com/category/events/form-events/) - [Keyboard Events](https://api.jquery.com/category/events/keyboard-events/) - [Mouse Events](https://api.jquery.com/category/events/mouse-events/) - [Forms](https://api.jquery.com/category/forms/) - [Internals](https://api.jquery.com/category/internals/) - [Manipulation](https://api.jquery.com/category/manipulation/) - [Class Attribute](https://api.jquery.com/category/manipulation/class-attribute/) - [Copying](https://api.jquery.com/category/manipulation/copying/) - [DOM Insertion, Around](https://api.jquery.com/category/manipulation/dom-insertion-around/) - [DOM Insertion, Inside](https://api.jquery.com/category/manipulation/dom-insertion-inside/) - [DOM Insertion, Outside](https://api.jquery.com/category/manipulation/dom-insertion-outside/) - [DOM Removal](https://api.jquery.com/category/manipulation/dom-removal/) - [DOM Replacement](https://api.jquery.com/category/manipulation/dom-replacement/) - [General Attributes](https://api.jquery.com/category/manipulation/general-attributes/) - [Style Properties](https://api.jquery.com/category/manipulation/style-properties/) - [Miscellaneous](https://api.jquery.com/category/miscellaneous/) - [Collection Manipulation](https://api.jquery.com/category/miscellaneous/collection-manipulation/) - [Data Storage](https://api.jquery.com/category/miscellaneous/data-storage/) - [DOM Element Methods](https://api.jquery.com/category/miscellaneous/dom-element-methods/) - [Setup Methods](https://api.jquery.com/category/miscellaneous/setup-methods/) - [Offset](https://api.jquery.com/category/offset/) - [Properties](https://api.jquery.com/category/properties/) - [Properties of jQuery Object Instances](https://api.jquery.com/category/properties/jquery-object-instance-properties/) - [Properties of the Global jQuery Object](https://api.jquery.com/category/properties/global-jquery-object-properties/) - [Removed](https://api.jquery.com/category/removed/) - [Selectors](https://api.jquery.com/category/selectors/) - [Attribute](https://api.jquery.com/category/selectors/attribute-selectors/) - [Basic](https://api.jquery.com/category/selectors/basic-css-selectors/) - [Basic Filter](https://api.jquery.com/category/selectors/basic-filter-selectors/) - [Child Filter](https://api.jquery.com/category/selectors/child-filter-selectors/) - [Content Filter](https://api.jquery.com/category/selectors/content-filter-selector/) - [Form](https://api.jquery.com/category/selectors/form-selectors/) - [Hierarchy](https://api.jquery.com/category/selectors/hierarchy-selectors/) - [jQuery Extensions](https://api.jquery.com/category/selectors/jquery-selector-extensions/) - [Visibility Filter](https://api.jquery.com/category/selectors/visibility-filter-selectors/) - [Traversing](https://api.jquery.com/category/traversing/) - [Filtering](https://api.jquery.com/category/traversing/filtering/) - [Miscellaneous Traversing](https://api.jquery.com/category/traversing/miscellaneous-traversal/) - [Tree Traversal](https://api.jquery.com/category/traversing/tree-traversal/) - [Utilities](https://api.jquery.com/category/utilities/) - [Version](https://api.jquery.com/category/version/) - [Version 1.0](https://api.jquery.com/category/version/1.0/) - [Version 1.0.4](https://api.jquery.com/category/version/1.0.4/) - [Version 1.1](https://api.jquery.com/category/version/1.1/) - [Version 1.1.2](https://api.jquery.com/category/version/1.1.2/) - [Version 1.1.3](https://api.jquery.com/category/version/1.1.3/) - [Version 1.1.4](https://api.jquery.com/category/version/1.1.4/) - [Version 1.2](https://api.jquery.com/category/version/1.2/) - [Version 1.2.3](https://api.jquery.com/category/version/1.2.3/) - [Version 1.2.6](https://api.jquery.com/category/version/1.2.6/) - [Version 1.3](https://api.jquery.com/category/version/1.3/) - [Version 1.4](https://api.jquery.com/category/version/1.4/) - [Version 1.4.1](https://api.jquery.com/category/version/1.4.1/) - [Version 1.4.2](https://api.jquery.com/category/version/1.4.2/) - [Version 1.4.3](https://api.jquery.com/category/version/1.4.3/) - [Version 1.4.4](https://api.jquery.com/category/version/1.4.4/) - [Version 1.5](https://api.jquery.com/category/version/1.5/) - [Version 1.5.1](https://api.jquery.com/category/version/1.5.1/) - [Version 1.6](https://api.jquery.com/category/version/1.6/) - [Version 1.7](https://api.jquery.com/category/version/1.7/) - [Version 1.8](https://api.jquery.com/category/version/1.8/) - [Version 1.9](https://api.jquery.com/category/version/1.9/) - [Version 1.11 & 2.1](https://api.jquery.com/category/version/1.11-and-2.1/) - [Version 1.12 & 2.2](https://api.jquery.com/category/version/1.12-and-2.2/) - [Version 3.0](https://api.jquery.com/category/version/3.0/) - [Version 3.1](https://api.jquery.com/category/version/3.1/) - [Version 3.2](https://api.jquery.com/category/version/3.2/) - [Version 3.3](https://api.jquery.com/category/version/3.3/) - [Version 3.4](https://api.jquery.com/category/version/3.4/) - [Version 3.5](https://api.jquery.com/category/version/3.5/) - [Version 3.6](https://api.jquery.com/category/version/3.6/) - [Version 3.7](https://api.jquery.com/category/version/3.7/) - [Version 4.0](https://api.jquery.com/category/version/4.0/) ### Books - [![Learning jQuery 4th Edition by Karl Swedberg and Jonathan Chaffer](https://api.jquery.com/wp-content/themes/jquery/content/books/learning-jquery-4th-ed.jpg) Learning jQuery Fourth Edition Karl Swedberg and Jonathan Chaffer](https://www.packtpub.com/en-us/product/learning-jquery-fourth-edition-9781782163152) - [![jQuery in Action by Bear Bibeault, Yehuda Katz, and Aurelio De Rosa](https://api.jquery.com/wp-content/themes/jquery/content/books/jquery-in-action.jpg) jQuery in Action Bear Bibeault, Yehuda Katz, and Aurelio De Rosa](https://www.manning.com/books/jquery-in-action-third-edition) - [![jQuery Succinctly by Cody Lindley](https://api.jquery.com/wp-content/themes/jquery/content/books/jquery-succinctly.jpg) jQuery Succinctly Cody Lindley](https://www.syncfusion.com/ebooks/jquery) - [Learning Center](https://learn.jquery.com/) - [Chat](https://jquery.com/support/) - [Twitter](https://twitter.com/jquery) - [GitHub](https://github.com/jquery) Copyright 2026 [OpenJS Foundation](https://openjsf.org/) and jQuery contributors. All rights reserved. See [jQuery License](https://jquery.com/license/) for more information. The [OpenJS Foundation](https://openjsf.org/) has registered trademarks and uses trademarks. For a list of trademarks of the [OpenJS Foundation](https://openjsf.org/), please see our [Trademark Policy](https://trademark-policy.openjsf.org/) and [Trademark List](https://trademark-list.openjsf.org/). Trademarks and logos not indicated on the [list of OpenJS Foundation trademarks](https://trademark-list.openjsf.org/) are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them. OpenJS Foundation [Terms of Use](https://terms-of-use.openjsf.org/), [Privacy](https://privacy-policy.openjsf.org/), [Code of Conduct](https://code-of-conduct.openjsf.org/), and [Cookie](https://www.linuxfoundation.org/cookies) Policies also apply. [Web hosting by Digital Ocean](https://www.digitalocean.com/) \| [CDN by Fastly](https://www.fastly.com/) \| [Powered by WordPress](https://wordpress.org/)
Readable Markdown
## .is( selector )Returns: [Boolean](http://api.jquery.com/Types/#Boolean) **Description:** Check the current matched set of elements against a selector, element, or jQuery object and return `true` if at least one of these elements matches the given arguments. - #### version added: [1\.0](https://api.jquery.com/category/version/1.0/)[.is( selector )](https://api.jquery.com/is/#is-selector) - **selector** A string containing a selector expression to match elements against. - #### version added: [1\.6](https://api.jquery.com/category/version/1.6/)[.is( function )](https://api.jquery.com/is/#is-function) - **function** A function used as a test for every element in the set. It accepts two arguments, `index`, which is the element's index in the jQuery collection, and `element`, which is the DOM element. Within the function, `this` refers to the current DOM element. - #### version added: [1\.6](https://api.jquery.com/category/version/1.6/)[.is( selection )](https://api.jquery.com/is/#is-selection) - **selection** An existing jQuery object to match the current set of elements against. - #### version added: [1\.6](https://api.jquery.com/category/version/1.6/)[.is( elements )](https://api.jquery.com/is/#is-elements) - **elements** One or more elements to match the current set of elements against. Unlike other filtering methods, `.is()` does not create a new jQuery object. Instead, it allows you to test the contents of a jQuery object without modification. This is often useful inside callbacks, such as event handlers. Suppose you have a list, with two of its items containing a child element: | | | |---|---| | 1 2 3 4 5 | | You can attach a click handler to the \<ul\> element, and then limit the code to be triggered only when a list item itself, not one of its children, is clicked: | | | |---|---| | 1 2 3 4 5 6 | | Now, when the user clicks on the word "list" in the first item or anywhere in the third item, the clicked list item will be given a red background. However, when the user clicks on item 1 in the first item or anywhere in the second item, nothing will occur, because in those cases the target of the event would be `<strong>` or `<span>`, respectively. #### Using a Function The second form of this method evaluates expressions related to elements based on a function rather than a selector. For each element, if the function returns `true`, `.is()` returns `true` as well. For example, given a somewhat more involved HTML snippet: | | | |---|---| | 1 2 3 4 5 6 7 8 | | You can attach a click handler to every `<li>` that evaluates the number of `<strong>` elements within the clicked `<li>` at that time like so: | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 | | ## Examples: ### Example 1 Shows a few ways is() can be used inside an event handler. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 | | #### Demo: ### Example 2 Returns true, because the parent of the input is a form element. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | | #### Demo: ### Example 3 Returns false, because the parent of the input is a p element. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | | #### Demo: ### Example 4 Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | | #### Demo: ### Example 5 An alternate way to achieve the above example using an element rather than a jQuery object. Checks against an existing collection of alternating list elements. Blue, alternating list elements slide up while others turn red. | | | |---|---| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 | | #### Demo:
Shard53 (laksa)
Root Hash657907979407719853
Unparsed URLcom,jquery!api,/is/ s443