# @lamansky/some

> A better Array.prototype.some(). Supports iterables, whitelist testing, and more.

Latest version **1.0.0** (published 2018-05-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install @lamansky/some
pnpm add @lamansky/some
yarn add @lamansky/some
bun add @lamansky/some
```

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2018-05-23 |
| First published | 2018-05-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=6.0.0 |
| Dependencies | 2 |
| Unpacked size | 3.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | John Lamansky |
| Maintainers | lamansky |
| Keywords | iterable, array, some, test |

## Links

- npm: https://www.npmjs.com/package/@lamansky/some
- Repository: https://github.com/lamansky/some
- Issues: https://github.com/lamansky/some/issues
- npm.io page: https://npm.io/package/@lamansky/some

## Dependencies (2)

- [ffn](https://npm.io/package/ffn.md) ^2.1.0
- [sbo](https://npm.io/package/sbo.md) ^1.1.0

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads
- [aws-elasticsearch-connector](https://npm.io/package/aws-elasticsearch-connector.md) — 37.4K weekly downloads

## Recent versions

- 1.0.0 (latest) — 2018-05-23

## README

# some

A better `Array.prototype.some()`. Supports iterables, whitelist testing, and more.

## Installation

Requires [Node.js](https://nodejs.org/) 6.0.0 or above.

```bash
npm i @lamansky/some
```

## API

The module exports a single function.

### Parameters

1. Bindable: `iter` (iterable)
2. Optional: `test` (function, array, or any): If a function is provided, iterated values will be evaluated on whether `test` returns `true` when passed the value. If an array is provided, iterated values will be evaluated on whether they are contained in the array. If some other value is provided, iterated values will be evaluated on whether they strictly equal `test`. If `test` is omitted, iterated values will be evaluated on whether they are truthy.

### Return Value

Returns `true` if any one of the iterated values of `iter` passes `test`; otherwise returns `false`.

## Example

```javascript
const some = require('@lamansky/some')

const arr = [1, 2, 3]

some(arr, n => n % 2 === 0) // true
some(arr, 1) // true
some(arr, [3, 4]) // true

some(arr, n => n > 3) // false
some(arr, 4) // false
some(arr, [4, 5]) // false

// Supports the bind operator
arr::some(n => n % 2 === 0) // true
```

## Related

* [every](https://github.com/lamansky/every)

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