componentEmits.spec.ts 9.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433
  1. // NOTE: this test cases are based on paclages/runtime-core/__tests__/componentEmits.spec.ts
  2. // Note: emits and listener fallthrough is tested in
  3. // ./rendererAttrsFallthrough.spec.ts.
  4. import {
  5. isEmitListener,
  6. nextTick,
  7. onBeforeUnmount,
  8. toHandlers,
  9. } from '@vue/runtime-dom'
  10. import { createComponent, defineVaporComponent } from '../src'
  11. import { makeRender } from './_utils'
  12. const define = makeRender()
  13. describe('component: emit', () => {
  14. test('trigger handlers', () => {
  15. const { render } = define({
  16. setup(_, { emit }) {
  17. emit('foo')
  18. emit('bar')
  19. emit('!baz')
  20. return []
  21. },
  22. })
  23. const onFoo = vi.fn()
  24. const onBar = vi.fn()
  25. const onBaz = vi.fn()
  26. render({
  27. onfoo: () => onFoo,
  28. onBar: () => onBar,
  29. ['on!baz']: () => onBaz,
  30. })
  31. expect(onFoo).not.toHaveBeenCalled()
  32. expect(onBar).toHaveBeenCalled()
  33. expect(onBaz).toHaveBeenCalled()
  34. })
  35. test('trigger dynamic emits', () => {
  36. const { render } = define({
  37. setup(_, { emit }) {
  38. emit('foo')
  39. emit('bar')
  40. emit('!baz')
  41. return []
  42. },
  43. })
  44. const onFoo = vi.fn()
  45. const onBar = vi.fn()
  46. const onBaz = vi.fn()
  47. render({
  48. onfoo: () => onFoo,
  49. onBar: () => onBar,
  50. ['on!baz']: () => onBaz,
  51. })
  52. expect(onFoo).not.toHaveBeenCalled()
  53. expect(onBar).toHaveBeenCalled()
  54. expect(onBaz).toHaveBeenCalled()
  55. })
  56. test('trigger camelCase handler', () => {
  57. const { render } = define({
  58. setup(_, { emit }) {
  59. emit('test-event')
  60. return []
  61. },
  62. })
  63. const fooSpy = vi.fn()
  64. render({ onTestEvent: () => fooSpy })
  65. expect(fooSpy).toHaveBeenCalled()
  66. })
  67. test('trigger kebab-case handler', () => {
  68. const { render } = define({
  69. setup(_, { emit }) {
  70. emit('test-event')
  71. return []
  72. },
  73. })
  74. const fooSpy = vi.fn()
  75. render({ ['onTest-event']: () => fooSpy })
  76. expect(fooSpy).toHaveBeenCalledTimes(1)
  77. })
  78. test('trigger mixed case handlers', () => {
  79. const { render } = define({
  80. setup(_, { emit }) {
  81. emit('test-event')
  82. emit('testEvent')
  83. return []
  84. },
  85. })
  86. const fooSpy = vi.fn()
  87. const barSpy = vi.fn()
  88. render(
  89. // v-on="{ testEvent: handler }"
  90. // will be compiled to
  91. // toHandlers({ testEvent: handler }, false, true)
  92. toHandlers(
  93. {
  94. 'test-event': fooSpy,
  95. testEvent: barSpy,
  96. },
  97. false,
  98. true,
  99. ),
  100. )
  101. expect(fooSpy).toHaveBeenCalledTimes(1)
  102. expect(barSpy).toHaveBeenCalledTimes(1)
  103. })
  104. // for v-model:foo-bar usage in DOM templates
  105. test('trigger hyphenated events for update:xxx events', () => {
  106. const { render } = define({
  107. setup(_, { emit }) {
  108. emit('update:fooProp')
  109. emit('update:barProp')
  110. return []
  111. },
  112. })
  113. const fooSpy = vi.fn()
  114. const barSpy = vi.fn()
  115. render({
  116. ['onUpdate:fooProp']: () => fooSpy,
  117. ['onUpdate:bar-prop']: () => barSpy,
  118. })
  119. expect(fooSpy).toHaveBeenCalled()
  120. expect(barSpy).toHaveBeenCalled()
  121. })
  122. test('should trigger array of listeners', async () => {
  123. const { render } = define({
  124. setup(_, { emit }) {
  125. emit('foo', 1)
  126. return []
  127. },
  128. })
  129. const fn1 = vi.fn()
  130. const fn2 = vi.fn()
  131. render({ onFoo: () => [fn1, fn2] })
  132. expect(fn1).toHaveBeenCalledTimes(1)
  133. expect(fn1).toHaveBeenCalledWith(1)
  134. expect(fn2).toHaveBeenCalledTimes(1)
  135. expect(fn2).toHaveBeenCalledWith(1)
  136. })
  137. test('warning for undeclared event (array)', () => {
  138. const { render } = define({
  139. emits: ['foo'],
  140. setup(_, { emit }) {
  141. emit('bar')
  142. return []
  143. },
  144. })
  145. render()
  146. expect(
  147. `Component emitted event "bar" but it is neither declared`,
  148. ).toHaveBeenWarned()
  149. })
  150. test('warning for undeclared event (object)', () => {
  151. const { render } = define({
  152. emits: {
  153. foo: null,
  154. },
  155. setup(_, { emit }) {
  156. emit('bar')
  157. return []
  158. },
  159. })
  160. render()
  161. expect(
  162. `Component emitted event "bar" but it is neither declared`,
  163. ).toHaveBeenWarned()
  164. })
  165. test('should not warn if has equivalent onXXX prop', () => {
  166. define({
  167. props: ['onFoo'],
  168. emits: [],
  169. setup(_, { emit }) {
  170. emit('foo')
  171. return []
  172. },
  173. }).render()
  174. expect(
  175. `Component emitted event "foo" but it is neither declared`,
  176. ).not.toHaveBeenWarned()
  177. })
  178. test('validator warning', () => {
  179. define({
  180. emits: {
  181. foo: (arg: number) => arg > 0,
  182. },
  183. setup(_, { emit }) {
  184. emit('foo', -1)
  185. return []
  186. },
  187. }).render()
  188. expect(`event validation failed for event "foo"`).toHaveBeenWarned()
  189. })
  190. test('.once', () => {
  191. const { render } = define({
  192. emits: {
  193. foo: null,
  194. bar: null,
  195. },
  196. setup(_, { emit }) {
  197. emit('foo')
  198. emit('foo')
  199. emit('bar')
  200. emit('bar')
  201. return []
  202. },
  203. })
  204. const fn = vi.fn()
  205. const barFn = vi.fn()
  206. render({
  207. onFooOnce: () => fn,
  208. onBarOnce: () => barFn,
  209. })
  210. expect(fn).toHaveBeenCalledTimes(1)
  211. expect(barFn).toHaveBeenCalledTimes(1)
  212. })
  213. test('.once with normal listener of the same name', () => {
  214. const { render } = define({
  215. emits: {
  216. foo: null,
  217. },
  218. setup(_, { emit }) {
  219. emit('foo')
  220. emit('foo')
  221. return []
  222. },
  223. })
  224. const onFoo = vi.fn()
  225. const onFooOnce = vi.fn()
  226. render({
  227. onFoo: () => onFoo,
  228. onFooOnce: () => onFooOnce,
  229. })
  230. expect(onFoo).toHaveBeenCalledTimes(2)
  231. expect(onFooOnce).toHaveBeenCalledTimes(1)
  232. })
  233. test('.number modifier should work with v-model on component', () => {
  234. const { render } = define({
  235. setup(_, { emit }) {
  236. emit('update:modelValue', '1')
  237. emit('update:foo', '2')
  238. return []
  239. },
  240. })
  241. const fn1 = vi.fn()
  242. const fn2 = vi.fn()
  243. render({
  244. modelValue: () => null,
  245. modelModifiers: () => ({ number: true }),
  246. ['onUpdate:modelValue']: () => fn1,
  247. foo: () => null,
  248. fooModifiers: () => ({ number: true }),
  249. ['onUpdate:foo']: () => fn2,
  250. })
  251. expect(fn1).toHaveBeenCalledTimes(1)
  252. expect(fn1).toHaveBeenCalledWith(1)
  253. expect(fn2).toHaveBeenCalledTimes(1)
  254. expect(fn2).toHaveBeenCalledWith(2)
  255. })
  256. test('.trim modifier should work with v-model on component', () => {
  257. const { render } = define({
  258. setup(_, { emit }) {
  259. emit('update:modelValue', ' one ')
  260. emit('update:foo', ' two ')
  261. return []
  262. },
  263. })
  264. const fn1 = vi.fn()
  265. const fn2 = vi.fn()
  266. render({
  267. modelValue() {
  268. return null
  269. },
  270. modelModifiers() {
  271. return { trim: true }
  272. },
  273. ['onUpdate:modelValue']() {
  274. return fn1
  275. },
  276. foo() {
  277. return null
  278. },
  279. fooModifiers() {
  280. return { trim: true }
  281. },
  282. 'onUpdate:foo'() {
  283. return fn2
  284. },
  285. })
  286. expect(fn1).toHaveBeenCalledTimes(1)
  287. expect(fn1).toHaveBeenCalledWith('one')
  288. expect(fn2).toHaveBeenCalledTimes(1)
  289. expect(fn2).toHaveBeenCalledWith('two')
  290. })
  291. test('.trim and .number modifiers should work with v-model on component', () => {
  292. const { render } = define({
  293. setup(_, { emit }) {
  294. emit('update:modelValue', ' +01.2 ')
  295. emit('update:foo', ' 1 ')
  296. return []
  297. },
  298. })
  299. const fn1 = vi.fn()
  300. const fn2 = vi.fn()
  301. render({
  302. modelValue() {
  303. return null
  304. },
  305. modelModifiers() {
  306. return { trim: true, number: true }
  307. },
  308. ['onUpdate:modelValue']() {
  309. return fn1
  310. },
  311. foo() {
  312. return null
  313. },
  314. fooModifiers() {
  315. return { trim: true, number: true }
  316. },
  317. ['onUpdate:foo']() {
  318. return fn2
  319. },
  320. })
  321. expect(fn1).toHaveBeenCalledTimes(1)
  322. expect(fn1).toHaveBeenCalledWith(1.2)
  323. expect(fn2).toHaveBeenCalledTimes(1)
  324. expect(fn2).toHaveBeenCalledWith(1)
  325. })
  326. test('only trim string parameter when work with v-model on component', () => {
  327. const { render } = define({
  328. setup(_, { emit }) {
  329. emit('update:modelValue', ' foo ', { bar: ' bar ' })
  330. return []
  331. },
  332. })
  333. const fn = vi.fn()
  334. render({
  335. modelValue() {
  336. return null
  337. },
  338. modelModifiers() {
  339. return { trim: true }
  340. },
  341. ['onUpdate:modelValue']() {
  342. return fn
  343. },
  344. })
  345. expect(fn).toHaveBeenCalledTimes(1)
  346. expect(fn).toHaveBeenCalledWith('foo', { bar: ' bar ' })
  347. })
  348. test('isEmitListener', () => {
  349. const options = {
  350. get click() {
  351. return null
  352. },
  353. get 'test-event'() {
  354. return null
  355. },
  356. get fooBar() {
  357. return null
  358. },
  359. get FooBaz() {
  360. return null
  361. },
  362. }
  363. expect(isEmitListener(options, 'onClick')).toBe(true)
  364. expect(isEmitListener(options, 'onclick')).toBe(false)
  365. expect(isEmitListener(options, 'onBlick')).toBe(false)
  366. // .once listeners
  367. expect(isEmitListener(options, 'onClickOnce')).toBe(true)
  368. expect(isEmitListener(options, 'onclickOnce')).toBe(false)
  369. // kebab-case option
  370. expect(isEmitListener(options, 'onTestEvent')).toBe(true)
  371. // camelCase option
  372. expect(isEmitListener(options, 'onFooBar')).toBe(true)
  373. // PascalCase option
  374. expect(isEmitListener(options, 'onFooBaz')).toBe(true)
  375. })
  376. test('does not emit after unmount', async () => {
  377. const fn = vi.fn()
  378. const Foo = defineVaporComponent({
  379. emits: ['closing'],
  380. setup(_, { emit }) {
  381. onBeforeUnmount(async () => {
  382. await nextTick()
  383. emit('closing', true)
  384. })
  385. return []
  386. },
  387. })
  388. const { app } = define(() =>
  389. createComponent(Foo, { onClosing: () => fn }),
  390. ).render()
  391. await nextTick()
  392. app.unmount()
  393. await nextTick()
  394. expect(fn).not.toHaveBeenCalled()
  395. })
  396. })