Finalize API

Let’s agree on a basic API and make an RFC so everyone can express their thoughts.

Proposed Wrapper API

method	status	notes
attributes	keep
classes	keep
exists	keep
contains	keep
destroy	keep
emitted	keep
find	keep
findAll	keep
html	keep
name	keep
trigger	keep	now returns nextTick. So you can do await wrapper.find('#button').trigger('click'). Nice!
setChecked	keep	see trigger
setSelected	keep	see trigger
setValue	keep	see trigger
vm	keep
element	keep

Wrapper API - Deprecations

method	status	explanation
emittedByOrder	deprecate	emitted serves this purpose
get	deprecate	This was added recently. similar to find - can we combine them?
is	deprecate	just use native tagName property
isEmpty	deprecate	Available via custom matcher, difficult to get 100% right
isVisible	deprecate	Available via custom matcher, difficult to get 100% right
isVueInstance	deprecate
props	deprecate	Anti-pattern. Test what a prop does, not its presence or value.
setData	deprecate	Anti-pattern. Use data mounting option to set a specific state.
setMethods	deprecate	Anti-pattern. Vue does not support arbitrarily changing methods, nor should VTU
setProps	deprecate	See setData, setMethods
text	deprecate	use toContain

Mounting Options - Proposed API

method	status	explanation
data	keep
slots	keep
scopedSlots	deprecate	Slots are scoped by default in Vue 3. Use slots.
context	deprecate	No longer needed
stubs	keep
provide	keep
mixins	new	attach mixins by app.mixin, since you no longer attach these to Vue.prototype
plugins	new	attach mixins by app.mixin, since you no longer attach these to Vue.prototype

[lmiller1990]

That should be easy to implement - we just have setValue check the element type, then call setSelected, setChecked etc under the hood. Not sure is there is some complexity I’m missing.

I think this should be a (separate) RFC to the deprecation ones. A smaller, more simple API is definitely attractive to me.

[lmiller1990]

Sounds good