Update api.md

Rough documentation of 'then' method on elementArrayFinder. Test scripts that use this method can be quite confusing without the documentation of this method (essentially treating a finder as a promise).