jQuery grep() Method

The $.grep() method is a utility used to **filter** a JavaScript array by searching for elements that meet a specific condition. It is very similar to the native Array.filter() method in modern JavaScript.

---

Basic Syntax

The method takes three arguments: the array, a filter function, and an optional "invert" boolean.

$.grep(array, function(element, index) {
    // Return true to keep the element
    // Return false to remove it
}, invert);

---

Example: Filtering Numbers

Suppose you have an array of ages and you only want to keep those that are 18 or older.

var ages = [12, 25, 18, 5, 40, 31];

var adults = $.grep(ages, function(val, i) {
    return val >= 18;
});

// Result: [25, 18, 40, 31]
console.log(adults);

---

Using the "Invert" Parameter

If you pass true as the third argument, the logic is reversed. Elements that **fail** the condition will be kept, and those that pass will be removed.

var numbers = [1, 5, 10, 15, 20];

// Return only numbers that are NOT greater than 9
var smallNumbers = $.grep(numbers, function(n) {
    return n > 9;
}, true); // The 'true' here inverts the logic

// Result: [1, 5]

---

Practical Example: Object Search

Calculating or finding specific objects within a dataset is a common task in dashboard development.

var inventory = [
    { name: "Laptop", stock: 5 },
    { name: "Mouse", stock: 0 },
    { name: "Monitor", stock: 12 }
];

// Find only items that are out of stock
var outOfStock = $.grep(inventory, function(item) {
    return item.stock === 0;
});

// Result: [{ name: "Mouse", stock: 0 }]

---

Key Points to Remember

• $.grep() is for filtering arrays with custom logic.
• The callback must return true to keep an item.
• The invert parameter flips the logic of the filter.
• It works on any JavaScript array (not just DOM elements).
• It is faster and cleaner than writing custom for loops for searching.