componentEmits.spec.ts 9.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421
  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 } from '../src'
  5. import { isEmitListener } from '../src/componentEmits'
  6. import { makeRender } from './_utils'
  7. const define = makeRender<any>()
  8. describe.todo('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. onFoo: () => [fn1, fn2],
  124. })
  125. expect(fn1).toHaveBeenCalledTimes(1)
  126. expect(fn1).toHaveBeenCalledWith(1)
  127. expect(fn2).toHaveBeenCalledTimes(1)
  128. expect(fn2).toHaveBeenCalledWith(1)
  129. })
  130. test.todo('warning for undeclared event (array)', () => {
  131. // TODO: warning
  132. })
  133. test.todo('warning for undeclared event (object)', () => {
  134. // TODO: warning
  135. })
  136. test('should not warn if has equivalent onXXX prop', () => {
  137. define({
  138. props: ['onFoo'],
  139. emits: [],
  140. render() {},
  141. setup(_: any, { emit }: any) {
  142. emit('foo')
  143. },
  144. }).render()
  145. expect(
  146. `Component emitted event "foo" but it is neither declared`,
  147. ).not.toHaveBeenWarned()
  148. })
  149. test.todo('validator warning', () => {
  150. // TODO: warning validator
  151. })
  152. // NOTE: not supported mixins
  153. // test.todo('merging from mixins', () => {})
  154. // #2651
  155. // test.todo(
  156. // 'should not attach normalized object when mixins do not contain emits',
  157. // () => {},
  158. // )
  159. test('.once', () => {
  160. const { render } = define({
  161. render() {},
  162. emits: {
  163. foo: null,
  164. bar: null,
  165. },
  166. setup(_: any, { emit }: any) {
  167. emit('foo')
  168. emit('foo')
  169. emit('bar')
  170. emit('bar')
  171. },
  172. })
  173. const fn = vi.fn()
  174. const barFn = vi.fn()
  175. render({
  176. get onFooOnce() {
  177. return fn
  178. },
  179. get onBarOnce() {
  180. return barFn
  181. },
  182. })
  183. expect(fn).toHaveBeenCalledTimes(1)
  184. expect(barFn).toHaveBeenCalledTimes(1)
  185. })
  186. test('.once with normal listener of the same name', () => {
  187. const { render } = define({
  188. render() {},
  189. emits: {
  190. foo: null,
  191. },
  192. setup(_: any, { emit }: any) {
  193. emit('foo')
  194. emit('foo')
  195. },
  196. })
  197. const onFoo = vi.fn()
  198. const onFooOnce = vi.fn()
  199. render({
  200. get onFoo() {
  201. return onFoo
  202. },
  203. get onFooOnce() {
  204. return onFooOnce
  205. },
  206. })
  207. expect(onFoo).toHaveBeenCalledTimes(2)
  208. expect(onFooOnce).toHaveBeenCalledTimes(1)
  209. })
  210. test('.number modifier should work with v-model on component', () => {
  211. const { render } = define({
  212. render() {},
  213. setup(_: any, { emit }: any) {
  214. emit('update:modelValue', '1')
  215. emit('update:foo', '2')
  216. },
  217. })
  218. const fn1 = vi.fn()
  219. const fn2 = vi.fn()
  220. render({
  221. modelValue() {
  222. return null
  223. },
  224. modelModifiers() {
  225. return { number: true }
  226. },
  227. ['onUpdate:modelValue']() {
  228. return fn1
  229. },
  230. foo() {
  231. return null
  232. },
  233. fooModifiers() {
  234. return { number: true }
  235. },
  236. ['onUpdate:foo']() {
  237. return fn2
  238. },
  239. })
  240. expect(fn1).toHaveBeenCalledTimes(1)
  241. expect(fn1).toHaveBeenCalledWith(1)
  242. expect(fn2).toHaveBeenCalledTimes(1)
  243. expect(fn2).toHaveBeenCalledWith(2)
  244. })
  245. test('.trim modifier should work with v-model on component', () => {
  246. const { render } = define({
  247. render() {},
  248. setup(_: any, { emit }: any) {
  249. emit('update:modelValue', ' one ')
  250. emit('update:foo', ' two ')
  251. },
  252. })
  253. const fn1 = vi.fn()
  254. const fn2 = vi.fn()
  255. render({
  256. modelValue() {
  257. return null
  258. },
  259. modelModifiers() {
  260. return { trim: true }
  261. },
  262. ['onUpdate:modelValue']() {
  263. return fn1
  264. },
  265. foo() {
  266. return null
  267. },
  268. fooModifiers() {
  269. return { trim: true }
  270. },
  271. 'onUpdate:foo'() {
  272. return fn2
  273. },
  274. })
  275. expect(fn1).toHaveBeenCalledTimes(1)
  276. expect(fn1).toHaveBeenCalledWith('one')
  277. expect(fn2).toHaveBeenCalledTimes(1)
  278. expect(fn2).toHaveBeenCalledWith('two')
  279. })
  280. test('.trim and .number modifiers should work with v-model on component', () => {
  281. const { render } = define({
  282. render() {},
  283. setup(_: any, { emit }: any) {
  284. emit('update:modelValue', ' +01.2 ')
  285. emit('update:foo', ' 1 ')
  286. },
  287. })
  288. const fn1 = vi.fn()
  289. const fn2 = vi.fn()
  290. render({
  291. modelValue() {
  292. return null
  293. },
  294. modelModifiers() {
  295. return { trim: true, number: true }
  296. },
  297. ['onUpdate:modelValue']() {
  298. return fn1
  299. },
  300. foo() {
  301. return null
  302. },
  303. fooModifiers() {
  304. return { trim: true, number: true }
  305. },
  306. ['onUpdate:foo']() {
  307. return fn2
  308. },
  309. })
  310. expect(fn1).toHaveBeenCalledTimes(1)
  311. expect(fn1).toHaveBeenCalledWith(1.2)
  312. expect(fn2).toHaveBeenCalledTimes(1)
  313. expect(fn2).toHaveBeenCalledWith(1)
  314. })
  315. test('only trim string parameter when work with v-model on component', () => {
  316. const { render } = define({
  317. render() {},
  318. setup(_: any, { emit }: any) {
  319. emit('update:modelValue', ' foo ', { bar: ' bar ' })
  320. },
  321. })
  322. const fn = vi.fn()
  323. render({
  324. modelValue() {
  325. return null
  326. },
  327. modelModifiers() {
  328. return { trim: true }
  329. },
  330. ['onUpdate:modelValue']() {
  331. return fn
  332. },
  333. })
  334. expect(fn).toHaveBeenCalledTimes(1)
  335. expect(fn).toHaveBeenCalledWith('foo', { bar: ' bar ' })
  336. })
  337. test('isEmitListener', () => {
  338. const options = {
  339. get click() {
  340. return null
  341. },
  342. get 'test-event'() {
  343. return null
  344. },
  345. get fooBar() {
  346. return null
  347. },
  348. get FooBaz() {
  349. return null
  350. },
  351. }
  352. expect(isEmitListener(options, 'onClick')).toBe(true)
  353. expect(isEmitListener(options, 'onclick')).toBe(false)
  354. expect(isEmitListener(options, 'onBlick')).toBe(false)
  355. // .once listeners
  356. expect(isEmitListener(options, 'onClickOnce')).toBe(true)
  357. expect(isEmitListener(options, 'onclickOnce')).toBe(false)
  358. // kebab-case option
  359. expect(isEmitListener(options, 'onTestEvent')).toBe(true)
  360. // camelCase option
  361. expect(isEmitListener(options, 'onFooBar')).toBe(true)
  362. // PascalCase option
  363. expect(isEmitListener(options, 'onFooBaz')).toBe(true)
  364. })
  365. test('does not emit after unmount', async () => {
  366. const fn = vi.fn()
  367. const { app } = define({
  368. emits: ['closing'],
  369. setup(_: any, { emit }: any) {
  370. onBeforeUnmount(async () => {
  371. await nextTick()
  372. emit('closing', true)
  373. })
  374. },
  375. render() {},
  376. }).render({
  377. get onClosing() {
  378. return fn
  379. },
  380. })
  381. await nextTick()
  382. app.unmount()
  383. await nextTick()
  384. expect(fn).not.toHaveBeenCalled()
  385. })
  386. // NOTE: not supported mixins
  387. // test.todo('merge string array emits', async () => {})
  388. // test.todo('merge object emits', async () => {})
  389. })