Add 'includes' helper

[sanjeevkpandit]

• Closes Need an array helper contains or includes #36
• Add includes helper to check for the existence of the value in array strictly(value + data type).
• Can check non-strictly(value only) by sending third argument as false.
• Checks strictly by default.

Parameters:

params [array] The array. (Required)
params [mixed] The value to checked for existence in the array. (Required)
params [boolean] FALSE for non-strict checking. TRUE by default. (Optional)

Returns boolean

Usage:

var array = [1, 2, 3];
var value = 2;

{{includes array value}}        => true

value = '2'
{{includes array value}}        => false
{{includes array value true}}   => false
{{includes array value false}}  => true

// Since it returns a boolean, we can use it in any conditional helpers like:

{{#if (includes array value)}}
   <!-- Do something -->
{{/if}}

{{ifx (includes array value) 'Yes' 'No'}}

Test Cases:

includes
      ✓ should return true if array strictly includes the element after compilation
      ✓ should return false if array strictly does not include the element after compilation
      ✓ should return true if array non-strictly includes the element after compilation
      ✓ should return false if array non-strictly does not include the element after compilation
      ✓ should return false if array argument is not an array
      ✓ should return false if array argument is an empty array
      ✓ should return false if array argument is not an array
      ✓ should return false if array checks for existence of an empty string

[mesaugat]

small case true

[codecov-io]

Current coverage is 98.55%

Merging #37 into master will increase coverage by 0.07%

@@             master        #37   diff @@
==========================================
  Files             7          7          
  Lines           131        138     +7   
  Methods           0          0          
  Messages          0          0          
  Branches          0          0          
==========================================
+ Hits            129        136     +7   
  Misses            2          2          
  Partials          0          0          

Powered by Codecov. Last updated by e2ad3fd...ca687fb

[kabirbaidhya]

Can reduce the nested ifs a little bit:

if ((strict && array[index] === value) ||
    (!strict && array[index] == value)
) {
    return true;
}

[kabirbaidhya]

See this:

Merging #37 into master will decrease coverage by 0.60%

You need one or more tests

[kabirbaidhya]

Check this: https://codecov.io/gh/leapfrogtechnology/just-handlebars-helpers/src/9c3a7613cc4285965c24c1f15a426e4d6392cc41/src/helpers/conditionals.js#L282

[mesaugat]

Value to be checked