ℹ️ Skipped - page is already crawled
| Filter | Status | Condition | Details |
|---|---|---|---|
| HTTP status | PASS | download_http_code = 200 | HTTP 200 |
| Age cutoff | PASS | download_stamp > now() - 6 MONTH | 0 months ago |
| History drop | PASS | isNull(history_drop_reason) | No drop reason |
| Spam/ban | PASS | fh_dont_index != 1 AND ml_spam_score = 0 | ml_spam_score=0 |
| Canonical | PASS | meta_canonical IS NULL OR = '' OR = src_unparsed | Not set |
| Property | Value |
|---|---|
| URL | https://api.jquery.com/is/ |
| Last Crawled | 2026-04-14 06:06:31 (4 hours ago) |
| First Indexed | 2013-08-16 07:08:12 (12 years ago) |
| HTTP Status Code | 200 |
| Meta Title | .is() | jQuery API Documentation |
| Meta Description | null |
| Meta Canonical | null |
| 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
>
</
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 Fourth Edition Karl Swedberg and Jonathan Chaffer](https://www.packtpub.com/en-us/product/learning-jquery-fourth-edition-9781782163152)
- [ jQuery in Action Bear Bibeault, Yehuda Katz, and Aurelio De Rosa](https://www.manning.com/books/jquery-in-action-third-edition)
- [ 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: |
| Shard | 53 (laksa) |
| Root Hash | 657907979407719853 |
| Unparsed URL | com,jquery!api,/is/ s443 |