- $.grep(). Finds the elements of an array which satisfy a filter function. The original array is not affected.
- $filter(). Reduce the set of matched elements to those that match the selector or pass the function’s test.
- $.map(). applies a function to each item in the array, thus returning a modified array
In other words, $.grep() removes items from an array as necessary so that all remaining items pass a provided test; .filter() constructs a new jQuery object from a subset of the matching elements.
Also, filter is intended to be used with html elements, and that is why it is a chainable function that returns a jQuery object and it accepts filters like “:even”, “:odd” or “:visible” etc. You can’t do that with the grep function, which is intended to be a utility function for arrays.
Suppose you have data like this:
$.grep() method removes items from an array as necessary so that all remaining items pass a provided test.
The test is a function that is passed an array item and the index of the item within the array. Only if the test returns true will the item be in the result array.
And you can perform multiple tests.
jQuery’s .filter() method constructs a new jQuery object from a subset of the matching elements.
The parameter for filter can take any one of the following:
- A selector
- A function where you will provide a test, similar to that of grep
- An element
- A jQuery object.
For a common example, you can use the filter to color the even items in a list:
And you receive back the entire array. And when you view the returned value game by calling
console.log(JSON.stringify(games)) you see:
When you want to apply a change to the array and return a modified array, use $.map(). The syntax used inside the function block is identical to the syntax used with $.grep(). The only difference is that you receive a modified array, not a filtered one.
The translation function you provide is called for each top-level element in the array or object and is passed two arguments: The element’s value and its index or key within the array or object.
The function can return:
- the translated value, which will be mapped to the resulting array
undefined, to remove the item
- an array of values, which will be flattened into the full array
This means you can do both filtering and do some additional changes to the array. For example, you could get a list of the products in the Grocery category. When the product matches a Grocery category, then you can add a new field named myProductIndex whose value is the offset to the item from my product array. And if it does not match, return null.
In fact, the myData.product array has changed for the Grocery items with those products having a new field. And groceryIndices includes the indices to the offset in my product array:
Then later, I can go back to my product array and find each grocery item with the new field. Use the value ( the index parameter is the index in the groceryIndices array).
Where the console writes:
You have seen how you can use grep, filter, and map to get the items you want from within JSON data.
- grep provides a clean way of getting the data from the items you want.
- filter provides ways to change the display and give you access to the entire array after your filtering
- map provides you with a way to get the data, change it, and then reuse the data as needed.
Sample code for this post on jQuery is available in DevDays GitHub repository. See https://github.com/devdays/single-page-app/tree/master/jQuery
- How to filter a Multi-dimension JSON object with jQuery.grep()
- jQuery: $.grep and $.map example and syntax