[Bug 21066] Provide an event path API

https://www.w3.org/Bugs/Public/show_bug.cgi?id=21066

--- Comment #59 from Koji Ishii <kojiishi@gmail.com> ---
Must be very clear to people here, but what I learnt yesterday from our IDL guy
was that sequence<T> is always passed by value, while T[] is always passed by
reference as defined in http://www.w3.org/TR/WebIDL/#idl-sequence

So making the type "sequence<EventTarget>" rather than "EventTarget[]"
should imply that mutating that array won't have any effect on anything in my
understanding.

Do you prefer to be more verbose on that point rather than implying it from the
type? Or am I incorrect to assume that sequence<T> implies that?

Also anything else you think the suggested text above is missing?

I looked at Event IDL: https://dom.spec.whatwg.org/#interface-event
and most methods/attributes are not very verbose, but your advice for how to
make crystal clearer would be appreciated. Oftentimes what's not clear is not
clear for who wrote the text.

-- 
You are receiving this mail because:
You are the QA Contact for the bug.

Received on Wednesday, 14 January 2015 05:46:18 UTC