The Array.some() method returns a Boolean value based on whether or not at least one item in the provided array meets the supplied condition(s).

Syntax

array.some(callbackFunction(element[, index[, array]])[, thisArg])

The Array.some() method accepts a callback function as the first parameter.

Optional parameters include:

  • index which provides the index of the current element being processed in the array
  • array which is the current array being processed
  • thisArg which is the value to be used as this within the callback function

Real World Example

Let's imagine that a professor wants to quickly check whether or not anyone in their class got over 100% on their exam after their teaching assistant finished grading them:

const examScores = [88, 97, 59, 73, 77, 101, 95, 72, 84, 86, 81, 100, 69, 79, 91, 68, 76, 99];

examScores.some(score => score > 100); // returns true
// there's at least exam score greater than 100

The Traditional Alternative

Without the Array.some() method, the professor would probably need to write some code like this:

const examScores = [88, 97, 59, 73, 77, 101, 95, 72, 84, 86, 81, 100, 69, 79, 91, 68, 76, 99];

const checkExamScores = (examScores) => {

	let anyExamsOverOneHundred = false;
    
    for (let i = 0; i < examScores.length; i++) {
        if (examScores[i] > 100) {
            anyExamsOverOneHundred = true
        }
    }

	return anyExamsOverOneHundred;
}

checkExamScores(examScores);

Wrapping up βœ…

As seen in the examples above, the Array.some() method eliminates quite a bit of code when you simply need to check whether a condition has been met!

Stay Tuned πŸ“Ί

If you have any questions or improvements, or if you'd like to see additional examples, feel free to reach out to me anytime at tim@timwheeler.com. If you're enjoying my posts, please click here πŸ“¬ or subscribe below πŸ‘‡!