When there can be errors?

[axelpale]

Documentation quality improvement that makes the lib more accessible for new users: The documentation lacks information about the type and content of the err object and when it is returned instead of null. As a user of the library, I should learn that from the documentation, not by looking the source code.