JSPM

array-has-value

1.0.2
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
    • 0
  • Score
    100M100P100Q34356F
  • License ISC

Checks if the given array has the search item (Type: string | number | boolean | object | array | null | undefined) based on the given options.

Package Exports

  • array-has-value
  • array-has-value/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (array-has-value) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

array-has-value

NPM version NPM downloads Known Vulnerabilities

Description

This package checks if a value (searchItem: string | number | boolean | object | array | null | undefined) is in an array (sourceArray: array) and returns true if it is, else it returns false. By default, the search is case-sensitive and strictly typed with number. The search is only at the top level of the array.

  • To make the search case-insensitive, set the caseSensitive to false ({ caseSensitive: false }).
  • To consider number string as number, set the strictType to false ({ strictType: false }).

Install

npm install array-has-value

arrayHasValue(sourceArray, searchItem, opts)

  • sourceArray | type: array | default: none | required
  • searchItem | type: any | default: none | required
  • opts | type: object | optional
  • opts.caseSensitive | type: boolean | default: true | optional
  • opts.strictType | type: boolean | default: true | optional
  • returns | type: boolean

Usage

Example: With Default Options

String
const arrayHasValue = require("array-has-value");

const arr = [ "Hello", "world" ];

arrayHasValue(arr, "hello"); // returns false 

const arrayHasValue = require("array-has-value");

const arr = [ "Hello", "world" ];

arrayHasValue(arr, "Hello"); // returns true
Number
const arrayHasValue = require("array-has-value");

const arr = [ "40", "world" ];

arrayHasValue(arr, 40); // returns false 

const arrayHasValue = require("array-has-value");

const arr = [ 40, "world" ];

arrayHasValue(arr, 40); // returns true
Object
const arrayHasValue = require("array-has-value");

const arr = [ { name: "John" }, "world" ];

arrayHasValue(arr, { name: "John" }); // returns true 

const arrayHasValue = require("array-has-value");

const arr = [ { name: "John" }, "world" ];

arrayHasValue(arr, { name: "john" }); // returns false
Array
const arrayHasValue = require("array-has-value");

const arr = [ [ "Hello", 10 ], "world" ];

arrayHasValue(arr, [ "Hello", 10 ]); // returns true 

const arrayHasValue = require("array-has-value");

const arr = [ [ "Hello", 10 ], "world" ];

arrayHasValue(arr, [ "hello", 10 ]); // returns false 

const arrayHasValue = require("array-has-value");

const arr = [ [ "Hello", "10" ], "world" ];

arrayHasValue(arr, [ "Hello", 10 ]); // returns false
Boolean
const arrayHasValue = require("array-has-value");

const arr = [ true, "40", "world" ];

arrayHasValue(arr, true); // returns true 

const arrayHasValue = require("array-has-value");

const arr = [ 40, "world" ];

arrayHasValue(arr, true); // returns false
Null
const arrayHasValue = require("array-has-value");

const arr = [ null, "40", "world" ];

arrayHasValue(arr, null); // returns true 

const arrayHasValue = require("array-has-value");

const arr = [ 40, "world" ];

arrayHasValue(arr, null); // returns false
Undefined
const arrayHasValue = require("array-has-value");

const arr = [ undefined, "40", "world" ];

arrayHasValue(arr, undefined); // returns true 

const arrayHasValue = require("array-has-value");

const arr = [ 40, "world" ];

arrayHasValue(arr, undefined); // returns false

Example: With Custom Options

String | caseSensitive: false
const arrayHasValue = require("array-has-value");

const arr = [ "Hello", "world" ];

arrayHasValue(arr, "hello", { caseSensitive: false }); // returns true
Number | strictType: false
const arrayHasValue = require("array-has-value");

const arr = [ "40", "world" ];

arrayHasValue(arr, 40, { strictType: false }); // returns true
Object | caseSensitive: false
const arrayHasValue = require("array-has-value");

const arr = [ { name: "John" }, "world" ];

arrayHasValue(arr, { name: "john" }, { caseSensitive: false }); // returns true
Object | caseSensitive: false | strictType: false
const arrayHasValue = require("array-has-value");

const arr = [ { name: "John", age: "10" }, "world" ];
const searchItem = { name: "john", age: 10 };
const opts = { caseSensitive: false, strictType: false };

arrayHasValue(arr, searchItem, opts); // returns true
Array | caseSensitive: false
const arrayHasValue = require("array-has-value");

const arr = [ [ "Hello", 10 ], "world" ];

arrayHasValue(arr, [ "hello", 10 ], { caseSensitive: false }); // returns true
Array | strictType: false
const arrayHasValue = require("array-has-value");

const arr = [ [ "Hello", "10"], "world" ];

arrayHasValue(arr, [ "Hello", 10 ], { strictType: false }); // returns true
Array | caseSensitive: false | strictType: false
const arrayHasValue = require("array-has-value");

const arr = [ [ "Hello", "10" ], "world" ];
const searchItem = [ "hello", 10 ];
const opts = { caseSensitive: false, strictType: false }

arrayHasValue(arr, searchItem, opts); // returns true