While building an application, we might be having a scenario where we are using an array and we want to check if that array contains a specific value or object. That’s where Javascript Array Method includes() comes into the play.
Table of Contents
Usage
Javascript array method includes() checks whether an array contains an element.
Syntax
arr.includes(valueToFind[, fromIndex])
includes()
accepts two arguments.
- valueToFind : it’s the value that we want to search.
- fromIndex(optional) It’s the position from which the search will start.
Return Value
It returns the boolean value.
If the supplied value(valueToFind) is within a javascript array, it’ll return true, otherwise false.
Now let’s see an example of javascript array includes() method.
JavaScript Array includes() example
An element is within an array
var array1=["apple","banana","coconut"];
console.log(array1.includes('coconut'))
Here in the above example, you can see that coconut is within an array called array1. Hence that output would be true.
An element is not within an array
var array1=["apple","banana","coconut"];
console.log(array1.includes('dog'))
In this example, you can see that dog is not within an array called array1. Hence that output would be false.
Using fromIndex | Optional second argument of includes() method
If fromIndex is greater than or equal to the length of the array, It’ll not search the array and it’ll return false.
var array1=["apple","banana","coconut"];
console.log(array1.includes('banana',20))
As you can see in this example, we are searching for “banana” and fromIndex is 20. so it’ll return false because fromIndex is greater than the length of the array.
If fromIndex is less than or equal to the index of the item for which we are searching and if that item is available in the array, it’ll return true.
For example:
var array1=["apple","banana","coconut"];
console.log(array1.includes('banana',0)); //OUTPUT: true
console.log(array1.includes('banana',1)); //OUTPUT: true
console.log(array1.includes('banana',2)); //OUTPUT: false
As you can see in the above code, For the first sentence fromIndex is 0, which is less than the index of item “banana“, Hence the output is true.
Note: Here we’ve searched for banana and it’s available in an array, that’s why the output is true. but if we would have something like this:
array1.includes('banana1',0)
, it would have return false because banana1 is not available in the array.
Case Sensitive
In the case of finding string or character, includes() function is case-sensitive.
For example:
var array1=["apple","banana","coconut"];
console.log(array1.includes('Banana')); //OUTPUT: false
console.log(array1.includes('BANANA')); //OUTPUT: false
console.log(array1.includes('banaNA')); //OUTPUT: false
In this example, Banana, BANANA and banaNA are not the same as banana, all the example will return false.
Javascript Array Contains Object
To check if an array includes an object, we can use one of the following methods.
Using javascript filter method
Javascript filter
methods return a new array with all array elements that pass the specified conditions.
var array1=[
{ name: "apple" },
{ name: "banana" },
{ name: "coconut" }
];
var newArray=array1.filter(x=> x.name=='apple');
if(newArray.length > 0){
console.log('Object is in javascript array');
}
else{
console.log('Object is not in javascript array');
}
As filter
function returns a new array, we’ll need to check the length of the new array to check if the object is in javascript array.
That’s why in the above code we’ve checked the length of newArray. and based on that log is displayed.
Using javascript some method
Javascript some
method returns a boolean value if any of the elements in the array pass the specified condition.
var array1=[
{ name: "apple" },
{ name: "banana" },
{ name: "coconut" }
];
if(array1.some(x=> x.name=='apple')){
console.log('Object is in javascript array');
}
else{
console.log('Object is not in javascript array');
}
And here javascript some
method returns a boolean value, so we can directly use in if
loop to check if javascript contains an object as shown in the above code.
Also Read:
- JavaScript Date Methods
- JavaScript Console Methods
- HTML DOM Events
- Angular File Upload Example
- Angular CRUD operation Example