componentEmits.spec.ts 9.6 KB

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