# find-index-x

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

Latest version **3.1.2** (published 2019-08-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install find-index-x
pnpm add find-index-x
yarn add find-index-x
bun add find-index-x
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.1.2 |
| Published | 2019-08-28 |
| First published | 2017-03-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=8.11.4 |
| Dependencies | 5 |
| Unpacked size | 267.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Graham Fairweather |
| Maintainers | xotic750 |
| Keywords | es6, findIndex, module, javascript, nodejs, browser |

## Links

- npm: https://www.npmjs.com/package/find-index-x
- Repository: https://github.com/Xotic750/find-index-x
- Issues: https://github.com/Xotic750/find-index-x/issues
- npm.io page: https://npm.io/package/find-index-x

## Dependencies (5)

- [attempt-x](https://npm.io/package/attempt-x.md) ^2.1.2
- [to-length-x](https://npm.io/package/to-length-x.md) ^4.2.2
- [to-object-x](https://npm.io/package/to-object-x.md) ^2.2.1
- [assert-is-function-x](https://npm.io/package/assert-is-function-x.md) ^3.1.2
- [split-if-boxed-bug-x](https://npm.io/package/split-if-boxed-bug-x.md) ^2.1.2

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 3.1.2 (latest) — 2019-08-28
- 3.1.1 — 2019-08-20
- 3.1.0 — 2019-08-14
- 3.0.17 — 2019-07-31
- 3.0.16 — 2019-07-27
- 3.0.15 — 2019-07-27
- 3.0.14 — 2019-07-26
- 3.0.13 — 2019-07-25
- 3.0.12 — 2019-07-24
- 3.0.11 — 2019-07-24
- 3.0.10 — 2019-07-22
- 3.0.9 — 2019-07-21
- 3.0.8 — 2019-07-19
- 3.0.7 — 2019-07-18
- 3.0.6 — 2019-07-18
- … 13 more at https://npm.io/package/find-index-x/versions

## README

<a
  href="https://travis-ci.org/Xotic750/find-index-x"
  title="Travis status">
<img
  src="https://travis-ci.org/Xotic750/find-index-x.svg?branch=master"
  alt="Travis status" height="18">
</a>
<a
  href="https://david-dm.org/Xotic750/find-index-x"
  title="Dependency status">
<img src="https://david-dm.org/Xotic750/find-index-x/status.svg"
  alt="Dependency status" height="18"/>
</a>
<a
  href="https://david-dm.org/Xotic750/find-index-x?type=dev"
  title="devDependency status">
<img src="https://david-dm.org/Xotic750/find-index-x/dev-status.svg"
  alt="devDependency status" height="18"/>
</a>
<a
  href="https://badge.fury.io/js/find-index-x"
  title="npm version">
<img src="https://badge.fury.io/js/find-index-x.svg"
  alt="npm version" height="18">
</a>
<a
  href="https://www.jsdelivr.com/package/npm/find-index-x"
  title="jsDelivr hits">
<img src="https://data.jsdelivr.com/v1/package/npm/find-index-x/badge?style=rounded"
  alt="jsDelivr hits" height="18">
</a>
<a
  href="https://bettercodehub.com/results/Xotic750/find-index-x"
  title="bettercodehub score">
<img src="https://bettercodehub.com/edge/badge/Xotic750/find-index-x?branch=master"
  alt="bettercodehub score" height="18">
</a>
<a
  href="https://coveralls.io/github/Xotic750/find-index-x?branch=master"
  title="Coverage Status">
<img src="https://coveralls.io/repos/github/Xotic750/find-index-x/badge.svg?branch=master"
  alt="Coverage Status" height="18">
</a>

<a name="module_find-index-x"></a>

## find-index-x

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

<a name="exp_module_find-index-x--module.exports"></a>

### `module.exports` ⇒ <code>number</code> ⏏

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**: <code>number</code> - Returns index of positively tested element, otherwise -1.  
**Throws**:

- <code>TypeError</code> If array is `null` or `undefined`-
- <code>TypeError</code> If `callback` is not a function.

| Param     | Type                  | Description                                                                                             |
| --------- | --------------------- | ------------------------------------------------------------------------------------------------------- |
| array     | <code>Array</code>    | The array to search.                                                                                    |
| callback  | <code>function</code> | Function to execute on each value in the array, taking three arguments: `element`, `index` and `array`. |
| [thisArg] | <code>\*</code>       | 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
```

---
_Source: https://npm.io/package/find-index-x · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._