add test of getItem to ensure that it returns proper values in an error scenario.
add comments to undocumented methods.