update to match intended implementation and add documentation for method

Enyo-DCO-1.1-Signed-Off-By: Cole Davis (cole.davis@lge.com)
add unit tests and correct documentation

Enyo-DCO-1.1-Signed-Off-By: Cole Davis (cole.davis@lge.com)
Merge pull request #769 from enyojs/BHV-10713-coledavis

Fix for: BHV-10713