← Back to Index

.filter()

Reduce the set of matched elements to those that match the selector or pass the function's test.

Examples

1. Filter by selector

$('li').filter('.active').css('color', 'red');

Result

// Only matching elements are modified
<li class="active" style="color: red;">...</li>
<li>...</li>

2. Filter by function

$('li').filter((index) => index % 2 === 0).addClass('even');

Result

<li class="even">Item 0</li>
<li>Item 1</li>
<li class="even">Item 2</li>

Parameters

Parameter	Type	Description
selector	string | function | element | SR	A string containing a selector expression to match elements against, or a function to test each element, or an element/SR object to match.

Returns: A new SR object containing the filtered elements.