This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

some

Summary

Determines whether the specified callback function returns true for any element of an array.

Syntax

some( callbackfn [, thisArg ])
callbackfn
Required. A function that accepts up to three arguments. The some method calls the callbackfn function for each element in array1 until the callbackfn returns true , or until the end of the array.
thisArg
Optional. An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.

Return Value

true if the callbackfn function returns true for any array element; otherwise, false.

Examples

The following example uses the some method to find out if any elements in an array are even.

// The callback function.
function CheckIfEven(value, index, ar) {
    if (value % 2 == 0) {
        return true;
    }
}

var numbers = [1, 15, 4, 10, 11, 22];

var evens = numbers.some(CheckIfEven);
document.write(evens);

// Output:
// true

The following example shows how to use the thisArg parameter, which specifies an object to which the this keyword can refer. It checks whether any of the numbers in an array are outside the range provided by an object passed

// Create a function that returns true if the value is
// outside the range.
var isOutsideRange = function (value) {
    return value < this.minimum || value > this.maximum;
}

// Create an array of numbers.
var numbers = [6, 12, 16, 22, -12];

// The range object is to be the 'this' object.
var range = { minimum: 10, maximum: 20 };

document.write(numbers.some(isOutsideRange, range));

// Output: true

Remarks

The some method calls the callbackfn function on each array element, in ascending index order, until the callbackfn function returns true. If an element that causes callbackfn to return true is found, the some method immediately returns true. If the callback does not return true on any element, the some method returns false.

The callback function is not called for missing elements of the array.

In addition to array objects, the some method can be used by any object that has a length property and that has numerically indexed property names.

Note – You can use the every Method (Array) to check whether the callback function returns true for all the elements of an array.

The syntax of the callback function is as follows:

function callbackfn(value, index, array1)

You can declare the callback function with up to three parameters.

The following table lists the callback function parameters.

Callback parameterDefinition
valueThe value of the array element.
indexThe numeric index of the array element.
array1The array object that contains the element.

The array object can be modified by the callback function.

The following table describes the results of modifying the array object after the some method starts.

Condition after the some method startsElement passed to callback function?
Element is added beyond the original length of the array.No.
Element is added to fill in a missing element of the array.Yes, if that index has not yet been passed to the callback function.
Element is changed.Yes, if that element has not yet been passed to the callback function.
Element is deleted from the array.No, unless that element has already been passed to the callback function.

Exceptions

If the callbackfn argument is not a function object, a TypeError exception is thrown.

See also

Specification

[15.4.4.17 Array.prototype.some ( callbackfn , thisArg )] ECMAScript® Language Specification Standard ECMA-262 5.1 Edition / June 2011

Attributions

  • Microsoft Developer Network: Article