explicit return values, why and how does this work

[koin612]

explicit return values, why and how does this work

[YuriGor]

Hi, looks like you mixing docs for eachDeep and filterDeep.

eachDeep will not care about returned value unless it's exactly boolean false.
In this case eachDeep will skip current children if any, so it's kind of 'break' in for loop, but local for current depth level.
This is similar to convention of Lodash each method.

filterDeep similar to Lodash or native array filter method expects true or false from predicate to decide keep current value or not.
Because filterDeep case is much more complex, I extended this convention and also accept undefined as possible return result. If "truthy" reply will be "yes" and "falsey" response will be "no", undefined means "Don't know yet"

In case of undefined current value will be preserved in result only in case some children values will also be preserved. If finally in result such value will be childless - it will be cleared out.
filterDeep deep doesn't care too much about true or false result data type, 0 or null will also work as false. It only cares about undefined as separate from false reply, so undefined is not falsey from filterDeep point of view.

If you are not sure yet you can read about Truthy and Falsy values in JS.

Note: if in some case you function will not return something - it will mean function will still return undefined implicitly.
I guess this is your point of confusion. So you can of coarse return just result of evaluation of some boolean value, you don't need to return exactly true or false, in case of eachDeep just make sure your false result is really boolen, not undefined or 0 wich in boolean expressions are considered as false, but if you check it with === operator - it will be different.
And in case of filterDeep you can return any truthy/falsy values, but be carefull with undefined because it's a separate reply.

To have better idea how deepdash works with complex nested data - I recomment first to learn how Lodash / JS array forEach and filter methods work. They work similar, but Lodash also supports objects, not only arrays, and in Lodash there is return false ==> break convention exists, while native JS forEach doesn't support it.