feat: add isNonEmptyArray (#289)

Close #279

src/index.d.ts

@@ -58,6 +58,11 @@ declare namespace RamdaAdjunct {
          */
         isNotArray(val: any): boolean;
 
+        /**
+         * Checks if input value is a non empty `Array`.
+         */
+        isNonEmptyArray(val: any): val is Array<any>;
+
         /**
          * Checks if input value is complement of `Boolean`.
          */

src/index.js

@@ -11,6 +11,7 @@ export { default as isNotNil } from './isNotNil';
 export { default as isArray } from './isArray';
 export { default as isEmptyArray } from './isEmptyArray';
 export { default as isNotArray } from './isNotArray';
+export { default as isNonEmptyArray } from './isNonEmptyArray';
 export { default as isBoolean } from './isBoolean';
 export { default as isNotBoolean } from './isNotBoolean';
 export { default as isNilOrEmpty } from './isNilOrEmpty';

src/isNonEmptyArray.js

@@ -0,0 +1,29 @@
+import { both } from 'ramda';
+
+import isNotEmpty from './isNotEmpty';
+import isArray from './isArray';
+
+/**
+ * Checks if input value is not an empty `Array`.
+ *
+ * @func isNonEmptyArray
+ * @memberOf RA
+ * @since {@link https://char0n.github.io/ramda-adjunct/2.4.0|v2.4.0}
+ * @category Type
+ * @sig * -> Boolean
+ * @param {*} val The value to test
+ * @return {Boolean}
+ * @see {@link RA.isEmptyArray|isEmptyArray}
+ * @example
+ *
+ * RA.isNonEmptyArray([42]); // => true
+ * RA.isNonEmptyArray([]); // => false
+ * RA.isNonEmptyArray({}); // => false
+ * RA.isNonEmptyArray(null); // => false
+ * RA.isNonEmptyArray(undefined); // => false
+ * RA.isNonEmptyArray(42); // => false
+ * RA.isNonEmptyArray('42'); // => false
+ */
+const isNonEmptyArray = both(isArray, isNotEmpty);
+
+export default isNonEmptyArray;

test/isNonEmptyArray.js

@@ -0,0 +1,24 @@
+import * as RA from '../src/index';
+import eq from './shared/eq';
+
+
+describe('isNonEmptyArray', function () {
+  it('tests a value to be a non empty `Array`', function () {
+    eq(RA.isNonEmptyArray([42]), true);
+    eq(RA.isNonEmptyArray(new Array('content')), true);
+
+    eq(RA.isNonEmptyArray([]), false);
+    eq(RA.isNonEmptyArray(new Array()), false);
+    eq(RA.isNonEmptyArray(new Array(42)), false);
+    eq(RA.isNonEmptyArray(Array.prototype), false);
+    eq(RA.isNonEmptyArray(void 0), false);
+    eq(RA.isNonEmptyArray({}), false);
+    eq(RA.isNonEmptyArray(null), false);
+    eq(RA.isNonEmptyArray(undefined), false);
+    eq(RA.isNonEmptyArray(42), false);
+    eq(RA.isNonEmptyArray('Array'), false);
+    eq(RA.isNonEmptyArray(true), false);
+    eq(RA.isNonEmptyArray(false), false);
+    eq(RA.isNonEmptyArray({ __proto__: Array.prototype }), false);
+  });
+});