Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/xotic750/find-index-x

Return the index of the first element in the array that satisfies the provided testing function.
https://github.com/xotic750/find-index-x

array browser ecmascript findindex nodejs

Last synced: 2 months ago
JSON representation

Return the index of the first element in the array that satisfies the provided testing function.

Awesome Lists containing this project

README

        


Travis status


Dependency status


devDependency status


npm version


jsDelivr hits


bettercodehub score


Coverage Status

## find-index-x

This method returns the index of the first element in the array that satisfies the provided testing function.

### `module.exports` ⇒ number

Like `findIndex`, this method returns an index in the array, if an element
in the array satisfies the provided testing function. Otherwise -1 is returned.

**Kind**: Exported member
**Returns**: number - Returns index of positively tested element, otherwise -1.
**Throws**:

- TypeError If array is `null` or `undefined`-
- TypeError If `callback` is not a function.

| Param | Type | Description |
| --------- | --------------------- | ------------------------------------------------------------------------------------------------------- |
| array | Array | The array to search. |
| callback | function | Function to execute on each value in the array, taking three arguments: `element`, `index` and `array`. |
| [thisArg] | \* | Object to use as `this` when executing `callback`. |

**Example**

```js
import findIndex from 'find-index-x';

function isPrime(element, index, array) {
let start = 2;
while (start <= Math.sqrt(element)) {
if (element % start < 1) {
return false;
}

start += 1;
}

return element > 1;
}

console.log(findIndex([4, 6, 8, 12, 14], isPrime)); // -1, not found
console.log(findIndex([4, 6, 7, 12, 13], isPrime)); // 2
```