@stdlib/assert-contains 0.2.2 → 0.3.0

package/NOTICE

@@ -1 +1 @@
-Copyright (c) 2016-2024 The Stdlib Authors.
+Copyright (c) 2016-2026 The Stdlib Authors.

package/README.md

@@ -29,7 +29,7 @@ limitations under the License.
   <p>To join us in bringing numerical computing to the web, get started by checking us out on <a href="https://github.com/stdlib-js/stdlib">GitHub</a>, and please consider <a href="https://opencollective.com/stdlib">financially supporting stdlib</a>. We greatly appreciate your continued support!</p>
 </details>
 
-# Contains
+# contains
 
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
 
@@ -59,16 +59,23 @@ npm install @stdlib/assert-contains
 var contains = require( '@stdlib/assert-contains' );
 ```
 
-#### contains( val, searchValue\[, position] )
+#### contains( value, searchValue\[, position] )
 
-Tests if `val` contains a search value. When `val` is a `string`, the function checks whether the characters of a search string are found in the input string.
+Tests if `value` contains a search value.
+
+```javascript
+var v = contains( [ 1, 2, 3 ], 2 );
+// returns true
+```
+
+When `value` is a string, the function checks whether the characters of a search string are found in the input string.
 
 ```javascript
 var v = contains( 'Hello World', 'World' );
 // returns true
 ```
 
-When `val` is an `array-like` object, but not a `string`, the function checks whether the input value contains an element strictly equal to the specified search value.
+When `value` is an array-like object, but not a string, the function checks whether the input value contains an element which is the [same value][@stdlib/assert/is-same-value] as the specified search value.
 
 ```javascript
 var arr = [ null, NaN, 2, 'abc', {} ];
@@ -100,7 +107,7 @@ v = contains( [ true, NaN, false ], true, 1 );
 // returns false
 ```
 
-If not provided an `array-like` object, the function throws an error.
+If not provided an array-like object, the function throws an error.
 
 <!-- run throws: true -->
 
@@ -128,8 +135,8 @@ var v = contains( 'hello', 'e', 2.5 );
 
 ## Notes
 
--   For `strings`, the function is modeled after [String.prototype.includes][mdn-includes], part of the ECMAScript 6 specification. This function is different from a call to `String.prototype.includes.call` insofar as type-checking is performed for all arguments.
--   The function does **not** distinguish between positive and negative zero.
+-   For strings, the function is modeled after [String.prototype.includes][mdn-includes], part of the ECMAScript 6 specification. This function is different from a call to `String.prototype.includes.call` insofar as type-checking is performed for all arguments.
+-   The function **does** distinguish between positive and negative zero (see [`@stdlib/assert-is-same-value`][@stdlib/assert/is-same-value]).
 -   If `position < 0`, the search is performed for the entire input array or string.
 
 </section>
@@ -202,7 +209,7 @@ See [LICENSE][stdlib-license].
 
 ## Copyright
 
-Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
+Copyright &copy; 2016-2026. The Stdlib [Authors][stdlib-authors].
 
 </section>
 
@@ -215,8 +222,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/assert-contains.svg
 [npm-url]: https://npmjs.org/package/@stdlib/assert-contains
 
-[test-image]: https://github.com/stdlib-js/assert-contains/actions/workflows/test.yml/badge.svg?branch=v0.2.2
-[test-url]: https://github.com/stdlib-js/assert-contains/actions/workflows/test.yml?query=branch:v0.2.2
+[test-image]: https://github.com/stdlib-js/assert-contains/actions/workflows/test.yml/badge.svg?branch=v0.3.0
+[test-url]: https://github.com/stdlib-js/assert-contains/actions/workflows/test.yml?query=branch:v0.3.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/assert-contains/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/assert-contains?branch=main
@@ -228,8 +235,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 -->
 
-[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
-[chat-url]: https://app.gitter.im/#/room/#stdlib-js_stdlib:gitter.im
+[chat-image]: https://img.shields.io/badge/zulip-join_chat-brightgreen.svg
+[chat-url]: https://stdlib.zulipchat.com
 
 [stdlib]: https://github.com/stdlib-js/stdlib
 
@@ -250,6 +257,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 [mdn-includes]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/includes
 
+[@stdlib/assert/is-same-value]: https://www.npmjs.com/package/@stdlib/assert-is-same-value
+
 </section>
 
 <!-- /.links -->

package/dist/index.js

@@ -1,4 +1,4 @@
-"use strict";var o=function(r,e){return function(){return e||r((e={exports:{}}).exports,e),e.exports}};var g=o(function(h,m){"use strict";var v=require("@stdlib/assert-is-collection"),w=require("@stdlib/assert-is-integer").isPrimitive,s=require("@stdlib/assert-is-string").isPrimitive,f=require("@stdlib/assert-is-nan").isPrimitive,a=require("@stdlib/string-format");function d(r,e,n){var u,t,i;if(!v(r)&&!s(r))throw new TypeError(a("invalid argument. First argument must be array-like. Value: `%s`.",r));if(arguments.length<2)throw new Error("insufficient arguments. Must provide a search value.");if(arguments.length>2){if(!w(n))throw new TypeError(a("invalid argument. Third argument must be an integer. Value: `%s`.",n));t=n,t<0&&(t=0)}else t=0;if(s(r)){if(!s(e))throw new TypeError(a("invalid argument. Second argument must be a string. Value: `%s`.",e));return r.indexOf(e,t)!==-1}if(u=r.length,f(e)){for(i=t;i<u;i++)if(f(r[i]))return!0;return!1}for(i=t;i<u;i++)if(r[i]===e)return!0;return!1}m.exports=d});var l=g();module.exports=l;
+"use strict";var g=function(e,r){return function(){return r||e((r={exports:{}}).exports,r),r.exports}};var m=g(function(q,u){"use strict";var o=require("@stdlib/assert-is-collection"),f=require("@stdlib/assert-is-integer").isPrimitive,s=require("@stdlib/assert-is-string").isPrimitive,v=require("@stdlib/array-base-index-of-same-value"),a=require("@stdlib/string-format");function d(e,r,t){var n,i;if(n=s(e),!o(e)&&!n)throw new TypeError(a("invalid argument. First argument must be array-like. Value: `%s`.",e));if(arguments.length<2)throw new Error("insufficient arguments. Must provide a search value.");if(arguments.length>2){if(!f(t))throw new TypeError(a("invalid argument. Third argument must be an integer. Value: `%s`.",t));i=t,i<0&&(i=0)}else i=0;if(n){if(!s(r))throw new TypeError(a("invalid argument. Second argument must be a string. Value: `%s`.",r));return e.indexOf(r,i)!==-1}return v(e,r,i)!==-1}u.exports=d});var w=m();module.exports=w;
 /**
 * @license Apache-2.0
 *

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../lib/main.js", "../lib/index.js"],
-  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isCollection = require( '@stdlib/assert-is-collection' );\nvar isInteger = require( '@stdlib/assert-is-integer' ).isPrimitive;\nvar isString = require( '@stdlib/assert-is-string' ).isPrimitive;\nvar isnan = require( '@stdlib/assert-is-nan' ).isPrimitive;\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Tests if an array-like value contains a search value.\n*\n* @param {(Collection|string)} val - input value\n* @param {*} searchValue - search value\n* @param {integer} [position=0] - position at which to start searching for `searchValue`\n* @throws {TypeError} first argument must be array-like\n* @throws {Error} must provide a search value\n* @throws {TypeError} second argument must be a string when the first argument is a string\n* @throws {TypeError} third argument must be an integer\n* @returns {boolean} boolean indicating whether one value contains another\n*\n* @example\n* var bool = contains( 'last man standing', 'stand' );\n* // returns true\n*\n* @example\n* var bool = contains( [ 1, 2, 3, 4 ], 2 );\n* // returns true\n*\n* @example\n* var bool = contains( 'presidential election', 'president' );\n* // returns true\n*\n* @example\n* var bool = contains( [ NaN, 2, 3, 4 ], NaN );\n* // returns true\n*\n* @example\n* var bool = contains( 'javaScript', 'js' );\n* // returns false\n*\n* @example\n* var bool = contains( [ 1, 2, 3, {} ], {} );\n* // returns false\n*\n* @example\n* var bool = contains( 'Hidden Treasures', '' );\n* // returns true\n*/\nfunction contains( val, searchValue, position ) {\n\tvar len;\n\tvar pos;\n\tvar i;\n\tif ( !isCollection( val ) && !isString( val ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. First argument must be array-like. Value: `%s`.', val ) );\n\t}\n\tif ( arguments.length < 2 ) {\n\t\tthrow new Error( 'insufficient arguments. Must provide a search value.' );\n\t}\n\tif ( arguments.length > 2 ) {\n\t\tif ( !isInteger( position ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Third argument must be an integer. Value: `%s`.', position ) );\n\t\t}\n\t\tpos = position;\n\t\tif ( pos < 0 ) {\n\t\t\tpos = 0;\n\t\t}\n\t} else {\n\t\tpos = 0;\n\t}\n\tif ( isString( val ) ) {\n\t\tif ( !isString( searchValue ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Second argument must be a string. Value: `%s`.', searchValue ) );\n\t\t}\n\t\treturn val.indexOf( searchValue, pos ) !== -1;\n\t}\n\tlen = val.length;\n\tif ( isnan( searchValue ) ) {\n\t\tfor ( i = pos; i < len; i++ ) {\n\t\t\tif ( isnan( val[ i ] ) ) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t}\n\tfor ( i = pos; i < len; i++ ) {\n\t\tif ( val[ i ] === searchValue ) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\n\n// EXPORTS //\n\nmodule.exports = contains;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* Test if an array-like value contains another value.\n*\n* @module @stdlib/assert-contains\n*\n* @example\n* var contains = require( '@stdlib/assert-contains' );\n*\n* var bool = contains( 'Hello World', 'World' );\n* // returns true\n*\n* bool = contains( 'Hello World', 'world' );\n* // returns false\n*\n* bool = contains( [ 1, 2, 3, 4 ], 2 );\n* // returns true\n*\n* bool = contains( [ NaN, 2, 3, 4 ], NaN );\n* // returns true\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
-  "mappings": "uGAAA,IAAAA,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAe,QAAS,8BAA+B,EACvDC,EAAY,QAAS,2BAA4B,EAAE,YACnDC,EAAW,QAAS,0BAA2B,EAAE,YACjDC,EAAQ,QAAS,uBAAwB,EAAE,YAC3CC,EAAS,QAAS,uBAAwB,EA6C9C,SAASC,EAAUC,EAAKC,EAAaC,EAAW,CAC/C,IAAIC,EACAC,EACA,EACJ,GAAK,CAACV,EAAcM,CAAI,GAAK,CAACJ,EAAUI,CAAI,EAC3C,MAAM,IAAI,UAAWF,EAAQ,oEAAqEE,CAAI,CAAE,EAEzG,GAAK,UAAU,OAAS,EACvB,MAAM,IAAI,MAAO,sDAAuD,EAEzE,GAAK,UAAU,OAAS,EAAI,CAC3B,GAAK,CAACL,EAAWO,CAAS,EACzB,MAAM,IAAI,UAAWJ,EAAQ,oEAAqEI,CAAS,CAAE,EAE9GE,EAAMF,EACDE,EAAM,IACVA,EAAM,EAER,MACCA,EAAM,EAEP,GAAKR,EAAUI,CAAI,EAAI,CACtB,GAAK,CAACJ,EAAUK,CAAY,EAC3B,MAAM,IAAI,UAAWH,EAAQ,mEAAoEG,CAAY,CAAE,EAEhH,OAAOD,EAAI,QAASC,EAAaG,CAAI,IAAM,EAC5C,CAEA,GADAD,EAAMH,EAAI,OACLH,EAAOI,CAAY,EAAI,CAC3B,IAAM,EAAIG,EAAK,EAAID,EAAK,IACvB,GAAKN,EAAOG,EAAK,CAAE,CAAE,EACpB,MAAO,GAGT,MAAO,EACR,CACA,IAAM,EAAII,EAAK,EAAID,EAAK,IACvB,GAAKH,EAAK,CAAE,IAAMC,EACjB,MAAO,GAGT,MAAO,EACR,CAKAR,EAAO,QAAUM,IC3EjB,IAAIM,EAAO,IAKX,OAAO,QAAUA",
-  "names": ["require_main", "__commonJSMin", "exports", "module", "isCollection", "isInteger", "isString", "isnan", "format", "contains", "val", "searchValue", "position", "len", "pos", "main"]
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isCollection = require( '@stdlib/assert-is-collection' );\nvar isInteger = require( '@stdlib/assert-is-integer' ).isPrimitive;\nvar isString = require( '@stdlib/assert-is-string' ).isPrimitive;\nvar indexOfSameValue = require( '@stdlib/array-base-index-of-same-value' );\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Tests if an array-like value contains a search value.\n*\n* @param {(Collection|string)} value - input value\n* @param {*} searchValue - search value\n* @param {integer} [position=0] - position at which to start searching for `searchValue`\n* @throws {TypeError} first argument must be array-like\n* @throws {Error} must provide a search value\n* @throws {TypeError} second argument must be a string when the first argument is a string\n* @throws {TypeError} third argument must be an integer\n* @returns {boolean} boolean indicating whether one value contains another\n*\n* @example\n* var bool = contains( 'last man standing', 'stand' );\n* // returns true\n*\n* @example\n* var bool = contains( [ 1, 2, 3, 4 ], 2 );\n* // returns true\n*\n* @example\n* var bool = contains( 'presidential election', 'president' );\n* // returns true\n*\n* @example\n* var bool = contains( [ NaN, 2, 3, 4 ], NaN );\n* // returns true\n*\n* @example\n* var bool = contains( 'javaScript', 'js' );\n* // returns false\n*\n* @example\n* var bool = contains( [ 1, 2, 3, {} ], {} );\n* // returns false\n*\n* @example\n* var bool = contains( 'Hidden Treasures', '' );\n* // returns true\n*/\nfunction contains( value, searchValue, position ) {\n\tvar isStr;\n\tvar pos;\n\n\tisStr = isString( value );\n\tif ( !isCollection( value ) && !isStr ) {\n\t\tthrow new TypeError( format( 'invalid argument. First argument must be array-like. Value: `%s`.', value ) );\n\t}\n\tif ( arguments.length < 2 ) {\n\t\tthrow new Error( 'insufficient arguments. Must provide a search value.' );\n\t}\n\tif ( arguments.length > 2 ) {\n\t\tif ( !isInteger( position ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Third argument must be an integer. Value: `%s`.', position ) );\n\t\t}\n\t\tpos = position;\n\t\tif ( pos < 0 ) {\n\t\t\tpos = 0;\n\t\t}\n\t} else {\n\t\tpos = 0;\n\t}\n\tif ( isStr ) {\n\t\tif ( !isString( searchValue ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Second argument must be a string. Value: `%s`.', searchValue ) );\n\t\t}\n\t\treturn value.indexOf( searchValue, pos ) !== -1;\n\t}\n\treturn indexOfSameValue( value, searchValue, pos ) !== -1;\n}\n\n\n// EXPORTS //\n\nmodule.exports = contains;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* Test if an array-like value contains another value.\n*\n* @module @stdlib/assert-contains\n*\n* @example\n* var contains = require( '@stdlib/assert-contains' );\n*\n* var bool = contains( 'Hello World', 'World' );\n* // returns true\n*\n* bool = contains( 'Hello World', 'world' );\n* // returns false\n*\n* bool = contains( [ 1, 2, 3, 4 ], 2 );\n* // returns true\n*\n* bool = contains( [ NaN, 2, 3, 4 ], NaN );\n* // returns true\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
+  "mappings": "uGAAA,IAAAA,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAe,QAAS,8BAA+B,EACvDC,EAAY,QAAS,2BAA4B,EAAE,YACnDC,EAAW,QAAS,0BAA2B,EAAE,YACjDC,EAAmB,QAAS,wCAAyC,EACrEC,EAAS,QAAS,uBAAwB,EA6C9C,SAASC,EAAUC,EAAOC,EAAaC,EAAW,CACjD,IAAIC,EACAC,EAGJ,GADAD,EAAQP,EAAUI,CAAM,EACnB,CAACN,EAAcM,CAAM,GAAK,CAACG,EAC/B,MAAM,IAAI,UAAWL,EAAQ,oEAAqEE,CAAM,CAAE,EAE3G,GAAK,UAAU,OAAS,EACvB,MAAM,IAAI,MAAO,sDAAuD,EAEzE,GAAK,UAAU,OAAS,EAAI,CAC3B,GAAK,CAACL,EAAWO,CAAS,EACzB,MAAM,IAAI,UAAWJ,EAAQ,oEAAqEI,CAAS,CAAE,EAE9GE,EAAMF,EACDE,EAAM,IACVA,EAAM,EAER,MACCA,EAAM,EAEP,GAAKD,EAAQ,CACZ,GAAK,CAACP,EAAUK,CAAY,EAC3B,MAAM,IAAI,UAAWH,EAAQ,mEAAoEG,CAAY,CAAE,EAEhH,OAAOD,EAAM,QAASC,EAAaG,CAAI,IAAM,EAC9C,CACA,OAAOP,EAAkBG,EAAOC,EAAaG,CAAI,IAAM,EACxD,CAKAX,EAAO,QAAUM,IC9DjB,IAAIM,EAAO,IAKX,OAAO,QAAUA",
+  "names": ["require_main", "__commonJSMin", "exports", "module", "isCollection", "isInteger", "isString", "indexOfSameValue", "format", "contains", "value", "searchValue", "position", "isStr", "pos", "main"]
 }

package/docs/types/index.d.ts

@@ -27,13 +27,13 @@ import { ArrayLike } from '@stdlib/types/array';
 *
 * ## Notes
 *
-* -   When `val` is a string, the function checks whether the characters of the search string are found in the input string. The search is case-sensitive.
-* -   When `val` is an array-like object, the function checks whether the input array contains an element strictly equal to the specified search value.
+* -   When `value` is a string, the function checks whether the characters of the search string are found in the input string. The search is case-sensitive.
+* -   When `value` is an array-like object, the function checks whether the input array contains an element which is the same as the specified search value.
 * -   For strings, this function is modeled after `String.prototype.includes`, part of the ECMAScript 6 specification. This function is different from a call to `String.prototype.includes.call` insofar as type-checking is performed for all arguments.
-* -   The function does not distinguish between positive and negative zero.
+* -   The function does distinguish between positive and negative zero.
 * -   If `position < 0`, the search is performed for the entire input array or string.
 *
-* @param val - input value
+* @param value - input value
 * @param searchValue - search value
 * @param position - position at which to start searching for `searchValue` (default: 0)
 * @throws second argument must be a primitive string primitive when the first argument is a string
@@ -67,7 +67,7 @@ import { ArrayLike } from '@stdlib/types/array';
 * var bool = contains( 'Hidden Treasures', '' );
 * // returns true
 */
-declare function contains( val: ArrayLike<any>, searchValue: any, position?: number ): boolean;
+declare function contains( value: ArrayLike<unknown>, searchValue: unknown, position?: number ): boolean;
 
 
 // EXPORTS //

package/lib/main.js

@@ -23,7 +23,7 @@
 var isCollection = require( '@stdlib/assert-is-collection' );
 var isInteger = require( '@stdlib/assert-is-integer' ).isPrimitive;
 var isString = require( '@stdlib/assert-is-string' ).isPrimitive;
-var isnan = require( '@stdlib/assert-is-nan' ).isPrimitive;
+var indexOfSameValue = require( '@stdlib/array-base-index-of-same-value' );
 var format = require( '@stdlib/string-format' );
 
 
@@ -32,7 +32,7 @@ var format = require( '@stdlib/string-format' );
 /**
 * Tests if an array-like value contains a search value.
 *
-* @param {(Collection|string)} val - input value
+* @param {(Collection|string)} value - input value
 * @param {*} searchValue - search value
 * @param {integer} [position=0] - position at which to start searching for `searchValue`
 * @throws {TypeError} first argument must be array-like
@@ -69,12 +69,13 @@ var format = require( '@stdlib/string-format' );
 * var bool = contains( 'Hidden Treasures', '' );
 * // returns true
 */
-function contains( val, searchValue, position ) {
-	var len;
+function contains( value, searchValue, position ) {
+	var isStr;
 	var pos;
-	var i;
-	if ( !isCollection( val ) && !isString( val ) ) {
-		throw new TypeError( format( 'invalid argument. First argument must be array-like. Value: `%s`.', val ) );
+
+	isStr = isString( value );
+	if ( !isCollection( value ) && !isStr ) {
+		throw new TypeError( format( 'invalid argument. First argument must be array-like. Value: `%s`.', value ) );
 	}
 	if ( arguments.length < 2 ) {
 		throw new Error( 'insufficient arguments. Must provide a search value.' );
@@ -90,27 +91,13 @@ function contains( val, searchValue, position ) {
 	} else {
 		pos = 0;
 	}
-	if ( isString( val ) ) {
+	if ( isStr ) {
 		if ( !isString( searchValue ) ) {
 			throw new TypeError( format( 'invalid argument. Second argument must be a string. Value: `%s`.', searchValue ) );
 		}
-		return val.indexOf( searchValue, pos ) !== -1;
-	}
-	len = val.length;
-	if ( isnan( searchValue ) ) {
-		for ( i = pos; i < len; i++ ) {
-			if ( isnan( val[ i ] ) ) {
-				return true;
-			}
-		}
-		return false;
-	}
-	for ( i = pos; i < len; i++ ) {
-		if ( val[ i ] === searchValue ) {
-			return true;
-		}
+		return value.indexOf( searchValue, pos ) !== -1;
 	}
-	return false;
+	return indexOfSameValue( value, searchValue, pos ) !== -1;
 }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/assert-contains",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Test if an array-like value contains a search value.",
   "license": "Apache-2.0",
   "author": {
@@ -30,9 +30,9 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/assert-is-collection": "^0.2.1",
+    "@stdlib/array-base-index-of-same-value": "github:stdlib-js/array-base-index-of-same-value#main",
+    "@stdlib/assert-is-collection": "^0.2.2",
     "@stdlib/assert-is-integer": "^0.2.2",
-    "@stdlib/assert-is-nan": "^0.2.2",
     "@stdlib/assert-is-string": "^0.2.2",
     "@stdlib/string-format": "^0.2.2",
     "@stdlib/error-tools-fmtprodmsg": "^0.2.2"