Element[n] throws TypeError

[wmnnd]

I expected the equivalent of JQuery's .eq(n) to be #[n] in opal-jquery.
However, only .at(n) seems to work at the moment and #[n] throws a TypeError:

require "opal-jquery"
Element.find("body").append(Element.parse("<a>test 1</a><a test 2</a>"))
elements = Element.find("a")
puts elements.length
puts elements.at(0) # <= works fine
puts elements[0] # <= "TypeError: n.toLowerCase is not a function"

For your convenience, the code on opalrb.org/try: http://ur1.ca/i454e

[wmnnd]

I see, the reason for this is that #[key] gives you access to an element's attributes. Could there be a better way to avoid the inconsistencies between Array-like behavior with #at and Hash-like behavior with #[]?

[elia]

I remember it has been discussed. iirc we picked the 80% case (which is attr) and made array access more explicit (#at) or available after conversion with #to_a

[wmnnd]

Okay, that makes sense. Then the problem that remains is that there is no documentation on this. The Github readme links to http://opalrb.org/jquery but that page doesn't exist.
Are there currently any plans for improving the documentation of opal-jquery? Is there a way to help out?

[elia]

Sure! Recently I started publishing opal side API docs (http://opalrb.org/docs/api/). Currently there's just core and stdlib but my plan is to publish there docs for all opal libs (a la rdoc.info)

You can grab the rails task from opal-master. Let me know if you need anything, some help is really appreciated :)

[elia]

Closing, I'll be glad to merge PRs improving api documentation, that would be enough (I'll deal with generating yardocs myself)