[{"data":1,"prerenderedAt":1631},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fautomatic-component-testing-with-vitest-and-testing-library":3,"series-context-\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library":1403},{"id":4,"title":5,"body":6,"contentId":1390,"date":1391,"description":1392,"extension":1393,"github":1394,"meetTheInstructor":1394,"meta":1395,"navigation":169,"part":189,"path":1396,"rawbody":1397,"robots":1394,"schemaOrg":1394,"seo":1398,"seriesSlug":1399,"sitemap":1400,"stem":1401,"subtitle":1394,"topics":1394,"__hash__":1402},"series\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fautomatic-component-testing-with-vitest-and-testing-library.md","Test de composants automatisé avec Vitest et Testing Library",{"type":7,"value":8,"toc":1384},"minimark",[9,40,57,63,68,81,117,128,134,259,270,280,333,336,340,343,357,396,408,484,489,599,603,610,623,1131,1153,1166,1169,1179,1185,1192,1195,1210,1213,1323,1327,1333,1366,1380],[10,11,12,13,17,18,21,22,31,32,39],"p",{},"Les ",[14,15,16],"strong",{},"tests"," sont une partie essentielle du développement logiciel. Ils garantissent que nos composants fonctionnent comme prévu et nous aident à détecter les bogues tôt dans le processus de développement. Dans cet article, nous allons explorer comment tester automatiquement les ",[14,19,20],{},"composants Vue.js"," en utilisant ",[23,24,28],"a",{"href":25,"rel":26},"https:\u002F\u002Fvitest.dev",[27],"nofollow",[14,29,30],{},"Vitest"," et ",[23,33,36],{"href":34,"rel":35},"https:\u002F\u002Ftesting-library.com",[27],[14,37,38],{},"Testing Library",".",[10,41,42,43,46,47,49,50,52,53,56],{},"Lorsque l'on travaille sur un projet ",[14,44,45],{},"Vite",", ",[14,48,30],{}," est le meilleur choix pour tester nos composants. C'est un exécuteur de tests optimisé pour Vite et il est très facile à utiliser. ",[14,51,38],{}," s'appuie sur ",[14,54,55],{},"Vue Test Utils"," et fournit un ensemble d'outils pour tester nos composants de manière centrée sur l'utilisateur.",[10,58,59,60,62],{},"Par exemple, ",[14,61,38],{}," nous encourage à tester le comportement de nos composants plutôt que leur implémentation. C'est un concept puissant qui nous permet de tester les composants d'une manière plus proche de l'expérience utilisateur et facilite le refactoring.",[64,65,67],"h2",{"id":66},"configuration-de-vitest","Configuration de Vitest",[10,69,70,71,31,73,75,76,80],{},"Pour commencer, nous devons installer ",[14,72,30],{},[14,74,38],{}," dans notre package ",[77,78,79],"code",{},"packages\u002Fhuchet-vue"," :",[82,83,89],"pre",{"className":84,"code":85,"filename":86,"language":87,"meta":88,"style":88},"language-bash shiki shiki-themes github-light github-light github-dark","pnpm add -D vitest @testing-library\u002Fvue jsdom\n","terminal","bash","",[77,90,91],{"__ignoreMap":88},[92,93,96,100,104,108,111,114],"span",{"class":94,"line":95},"line",1,[92,97,99],{"class":98},"snPdu","pnpm",[92,101,103],{"class":102},"sIIMD"," add",[92,105,107],{"class":106},"sBjJW"," -D",[92,109,110],{"class":102}," vitest",[92,112,113],{"class":102}," @testing-library\u002Fvue",[92,115,116],{"class":102}," jsdom\n",[10,118,119,120,123,124,127],{},"Étant donné que nous testons des composants frontend, nous avons besoin d'un environnement avec un ",[14,121,122],{},"DOM",". Pour éviter de lancer un vrai navigateur, qui est lent et gourmand en ressources, nous pouvons utiliser ",[14,125,126],{},"JSDOM",", une implémentation légère du DOM dans Node.js.",[10,129,130,131,80],{},"Pour faire fonctionner Vitest avec JSDOM, nous devons le configurer dans le fichier ",[77,132,133],{},"vite.config.ts",[82,135,139],{"className":136,"code":137,"filename":133,"language":138,"meta":88,"style":88},"language-ts shiki shiki-themes github-light github-light github-dark","\u002F\u002F\u002F \u003Creference types=\"vitest\" \u002F>\n\nimport { defineConfig } from 'vite'\n\nexport default defineConfig({\n  \u002F\u002F ...\n\n  test: {\n    globals: true,\n    environment: 'jsdom',\n  },\n})\n","ts",[77,140,141,164,171,187,192,207,213,218,224,236,247,253],{"__ignoreMap":88},[92,142,143,147,151,154,158,161],{"class":94,"line":95},[92,144,146],{"class":145},"sCsY4","\u002F\u002F\u002F \u003C",[92,148,150],{"class":149},"sovSZ","reference",[92,152,153],{"class":98}," types",[92,155,157],{"class":156},"s8jYJ","=",[92,159,160],{"class":102},"\"vitest\"",[92,162,163],{"class":145}," \u002F>\n",[92,165,167],{"class":94,"line":166},2,[92,168,170],{"emptyLinePlaceholder":169},true,"\n",[92,172,174,177,181,184],{"class":94,"line":173},3,[92,175,176],{"class":156},"import",[92,178,180],{"class":179},"sxrX7"," { defineConfig } ",[92,182,183],{"class":156},"from",[92,185,186],{"class":102}," 'vite'\n",[92,188,190],{"class":94,"line":189},4,[92,191,170],{"emptyLinePlaceholder":169},[92,193,195,198,201,204],{"class":94,"line":194},5,[92,196,197],{"class":156},"export",[92,199,200],{"class":156}," default",[92,202,203],{"class":98}," defineConfig",[92,205,206],{"class":179},"({\n",[92,208,210],{"class":94,"line":209},6,[92,211,212],{"class":145},"  \u002F\u002F ...\n",[92,214,216],{"class":94,"line":215},7,[92,217,170],{"emptyLinePlaceholder":169},[92,219,221],{"class":94,"line":220},8,[92,222,223],{"class":179},"  test: {\n",[92,225,227,230,233],{"class":94,"line":226},9,[92,228,229],{"class":179},"    globals: ",[92,231,232],{"class":106},"true",[92,234,235],{"class":179},",\n",[92,237,239,242,245],{"class":94,"line":238},10,[92,240,241],{"class":179},"    environment: ",[92,243,244],{"class":102},"'jsdom'",[92,246,235],{"class":179},[92,248,250],{"class":94,"line":249},11,[92,251,252],{"class":179},"  },\n",[92,254,256],{"class":94,"line":255},12,[92,257,258],{"class":179},"})\n",[260,261,264],"callout",{"color":262,"icon":263},"info","i-ph-info-duotone",[10,265,266,269],{},[77,267,268],{},"\u002F\u002F\u002F \u003Creference types=\"vitest\" \u002F>"," est crucial pour garantir que les bons types soient disponibles dans le fichier de configuration de Vite. Cela augmente le fichier de configuration de Vite avec les types de Vitest.",[10,271,272,273,276,277,279],{},"Dans le fichier ",[77,274,275],{},"package.json"," de ",[77,278,79],{},", ajoutez deux nouveaux scripts pour exécuter les tests :",[82,281,285],{"className":282,"code":283,"filename":275,"language":284,"meta":88,"style":88},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"scripts\": {\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\"\n  }\n}\n","json",[77,286,287,292,300,313,323,328],{"__ignoreMap":88},[92,288,289],{"class":94,"line":95},[92,290,291],{"class":179},"{\n",[92,293,294,297],{"class":94,"line":166},[92,295,296],{"class":106},"  \"scripts\"",[92,298,299],{"class":179},": {\n",[92,301,302,305,308,311],{"class":94,"line":173},[92,303,304],{"class":106},"    \"test\"",[92,306,307],{"class":179},": ",[92,309,310],{"class":102},"\"vitest run\"",[92,312,235],{"class":179},[92,314,315,318,320],{"class":94,"line":189},[92,316,317],{"class":106},"    \"test:watch\"",[92,319,307],{"class":179},[92,321,322],{"class":102},"\"vitest\"\n",[92,324,325],{"class":94,"line":194},[92,326,327],{"class":179},"  }\n",[92,329,330],{"class":94,"line":209},[92,331,332],{"class":179},"}\n",[10,334,335],{},"Le premier script exécute les tests une fois, et le second script exécute les tests en mode surveillance s'il ne détecte pas un environnement CI.",[64,337,339],{"id":338},"configuration-typescript","Configuration TypeScript",[10,341,342],{},"Nos fichiers de test forment un nouveau contexte TypeScript. Nous devons accéder à l'API Node.js mais pas à l'environnement du navigateur. Comme pour tout nouveau contexte TypeScript, nous le configurons via un nouveau fichier TSConfig.",[10,344,345,346,349,350,353,354,80],{},"Créez un fichier ",[77,347,348],{},"tsconfig.test.json"," qui étend ",[77,351,352],{},"tsconfig.node.json"," et inclut les fichiers ",[77,355,356],{},"test.ts",[82,358,360],{"className":282,"code":359,"filename":356,"language":284,"meta":88,"style":88},"{\n  \"extends\": \".\u002Ftsconfig.node.json\",\n  \"include\": [\"src\u002F**\u002F*.test.ts\"]\n}\n",[77,361,362,366,378,392],{"__ignoreMap":88},[92,363,364],{"class":94,"line":95},[92,365,291],{"class":179},[92,367,368,371,373,376],{"class":94,"line":166},[92,369,370],{"class":106},"  \"extends\"",[92,372,307],{"class":179},[92,374,375],{"class":102},"\".\u002Ftsconfig.node.json\"",[92,377,235],{"class":179},[92,379,380,383,386,389],{"class":94,"line":173},[92,381,382],{"class":106},"  \"include\"",[92,384,385],{"class":179},": [",[92,387,388],{"class":102},"\"src\u002F**\u002F*.test.ts\"",[92,390,391],{"class":179},"]\n",[92,393,394],{"class":94,"line":189},[92,395,332],{"class":179},[10,397,272,398,401,402,404,405,80],{},[77,399,400],{},"tsconfig.app.json",", nous excluons les fichiers ",[77,403,356],{},", de la même manière que nous avons exclu les fichiers ",[77,406,407],{},"story.vue",[82,409,412],{"className":410,"code":411,"filename":407,"language":284,"meta":88,"style":88},"language-json shiki shiki-themes github-light github-light github-dark has-diff","{\n  \"extends\": \"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\",\n  \"include\": [\n    \"src\u002F**\u002F*.ts\",\n    \"src\u002F**\u002F*.vue\"\n  ],\n  \"exclude\": [\n    \"src\u002F**\u002F*.story.vue\",\n    \"src\u002F**\u002F*.test.ts\" \u002F\u002F [!code ++]\n  ]\n}\n",[77,413,414,418,429,436,443,448,453,460,467,475,480],{"__ignoreMap":88},[92,415,416],{"class":94,"line":95},[92,417,291],{"class":179},[92,419,420,422,424,427],{"class":94,"line":166},[92,421,370],{"class":106},[92,423,307],{"class":179},[92,425,426],{"class":102},"\"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\"",[92,428,235],{"class":179},[92,430,431,433],{"class":94,"line":173},[92,432,382],{"class":106},[92,434,435],{"class":179},": [\n",[92,437,438,441],{"class":94,"line":189},[92,439,440],{"class":102},"    \"src\u002F**\u002F*.ts\"",[92,442,235],{"class":179},[92,444,445],{"class":94,"line":194},[92,446,447],{"class":102},"    \"src\u002F**\u002F*.vue\"\n",[92,449,450],{"class":94,"line":209},[92,451,452],{"class":179},"  ],\n",[92,454,455,458],{"class":94,"line":215},[92,456,457],{"class":106},"  \"exclude\"",[92,459,435],{"class":179},[92,461,462,465],{"class":94,"line":220},[92,463,464],{"class":102},"    \"src\u002F**\u002F*.story.vue\"",[92,466,235],{"class":179},[92,468,472],{"class":469,"line":226},[94,470,471],"diff","add",[92,473,474],{"class":102},"    \"src\u002F**\u002F*.test.ts\"",[92,476,477],{"class":94,"line":238},[92,478,479],{"class":179},"  ]\n",[92,481,482],{"class":94,"line":249},[92,483,332],{"class":179},[10,485,486,487,80],{},"Dans notre fichier TSConfig principal, nous ajoutons une référence au fichier ",[77,488,348],{},[82,490,492],{"className":410,"code":491,"filename":348,"language":284,"meta":88,"style":88},"{\n  \"files\": [],\n  \"references\": [\n    {\n      \"path\": \".\u002Ftsconfig.app.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.node.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.story.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.test.json\" \u002F\u002F [!code ++]\n    }\n  ]\n}\n",[77,493,494,498,506,513,518,528,533,537,546,550,554,563,567,572,583,589,594],{"__ignoreMap":88},[92,495,496],{"class":94,"line":95},[92,497,291],{"class":179},[92,499,500,503],{"class":94,"line":166},[92,501,502],{"class":106},"  \"files\"",[92,504,505],{"class":179},": [],\n",[92,507,508,511],{"class":94,"line":173},[92,509,510],{"class":106},"  \"references\"",[92,512,435],{"class":179},[92,514,515],{"class":94,"line":189},[92,516,517],{"class":179},"    {\n",[92,519,520,523,525],{"class":94,"line":194},[92,521,522],{"class":106},"      \"path\"",[92,524,307],{"class":179},[92,526,527],{"class":102},"\".\u002Ftsconfig.app.json\"\n",[92,529,530],{"class":94,"line":209},[92,531,532],{"class":179},"    },\n",[92,534,535],{"class":94,"line":215},[92,536,517],{"class":179},[92,538,539,541,543],{"class":94,"line":220},[92,540,522],{"class":106},[92,542,307],{"class":179},[92,544,545],{"class":102},"\".\u002Ftsconfig.node.json\"\n",[92,547,548],{"class":94,"line":226},[92,549,532],{"class":179},[92,551,552],{"class":94,"line":238},[92,553,517],{"class":179},[92,555,556,558,560],{"class":94,"line":249},[92,557,522],{"class":106},[92,559,307],{"class":179},[92,561,562],{"class":102},"\".\u002Ftsconfig.story.json\"\n",[92,564,565],{"class":94,"line":255},[92,566,532],{"class":179},[92,568,570],{"class":94,"line":569},13,[92,571,517],{"class":179},[92,573,576,578,580],{"class":574,"line":575},[94,470,471],14,[92,577,522],{"class":106},[92,579,307],{"class":179},[92,581,582],{"class":102},"\".\u002Ftsconfig.test.json\"",[92,584,586],{"class":94,"line":585},15,[92,587,588],{"class":179},"    }\n",[92,590,592],{"class":94,"line":591},16,[92,593,479],{"class":179},[92,595,597],{"class":94,"line":596},17,[92,598,332],{"class":179},[64,600,602],{"id":601},"écrire-notre-premier-test","Écrire notre premier test",[10,604,605,606,609],{},"Chaque composant est isolé et encapsulé dans son dossier dès le départ. Les tests suivront la même structure. Créez un fichier ",[77,607,608],{},"src\u002FButton\u002FButton.test.ts"," et écrivez notre premier test :",[82,611,613],{"className":84,"code":612,"filename":608,"language":87,"meta":88,"style":88},"touch src\u002FButton\u002FButton.test.ts\n",[77,614,615],{"__ignoreMap":88},[92,616,617,620],{"class":94,"line":95},[92,618,619],{"class":98},"touch",[92,621,622],{"class":102}," src\u002FButton\u002FButton.test.ts\n",[82,624,627],{"className":136,"code":625,"filename":626,"language":138,"meta":88,"style":88},"import { fireEvent, render, screen } from '@testing-library\u002Fvue'\nimport { describe, expect, it } from 'vitest'\nimport Button from '.\u002FButton.vue'\n\ndescribe('button', () => {\n  it('doit émettre un événement de clic lorsqu\\'il est cliqué', async () => {\n    const { emitted } = render(Button, {\n      props: {\n        label: 'Hello',\n      },\n    })\n\n    await fireEvent.click(screen.getByText('Hello'))\n\n    expect(emitted()).toMatchInlineSnapshot(`\n      {\n        \"click\": [\n          [\n            MouseEvent {\n              \"isTrusted\": false,\n            },\n          ],\n        ],\n      }\n    `)\n  })\n\n  describe('solide', () => {\n    it('doit rendre un bouton solide', () => {\n      const button = render(Button, {\n        props: {\n          label: 'Hello',\n          variant: 'solid',\n        },\n      })\n\n      expect(button.html()).toMatchSnapshot()\n    })\n  })\n\n  describe('contour', () => {\n    it('doit rendre un bouton en contour', () => {\n      const button = render(Button, {\n        props: {\n          label: 'Hello',\n          variant: 'outline',\n        },\n      })\n\n      expect(button.html()).toMatchSnapshot()\n    })\n  })\n})\n","Exemple",[77,628,629,641,653,665,669,689,717,739,744,754,759,764,768,792,796,816,821,826,832,838,844,850,856,862,868,877,883,888,905,922,938,944,954,965,971,977,982,1002,1007,1012,1017,1033,1049,1062,1067,1076,1086,1091,1096,1101,1116,1121,1126],{"__ignoreMap":88},[92,630,631,633,636,638],{"class":94,"line":95},[92,632,176],{"class":156},[92,634,635],{"class":179}," { fireEvent, render, screen } ",[92,637,183],{"class":156},[92,639,640],{"class":102}," '@testing-library\u002Fvue'\n",[92,642,643,645,648,650],{"class":94,"line":166},[92,644,176],{"class":156},[92,646,647],{"class":179}," { describe, expect, it } ",[92,649,183],{"class":156},[92,651,652],{"class":102}," 'vitest'\n",[92,654,655,657,660,662],{"class":94,"line":173},[92,656,176],{"class":156},[92,658,659],{"class":179}," Button ",[92,661,183],{"class":156},[92,663,664],{"class":102}," '.\u002FButton.vue'\n",[92,666,667],{"class":94,"line":189},[92,668,170],{"emptyLinePlaceholder":169},[92,670,671,674,677,680,683,686],{"class":94,"line":194},[92,672,673],{"class":98},"describe",[92,675,676],{"class":179},"(",[92,678,679],{"class":102},"'button'",[92,681,682],{"class":179},", () ",[92,684,685],{"class":156},"=>",[92,687,688],{"class":179}," {\n",[92,690,691,694,696,699,702,705,707,710,713,715],{"class":94,"line":209},[92,692,693],{"class":98},"  it",[92,695,676],{"class":179},[92,697,698],{"class":102},"'doit émettre un événement de clic lorsqu",[92,700,701],{"class":106},"\\'",[92,703,704],{"class":102},"il est cliqué'",[92,706,46],{"class":179},[92,708,709],{"class":156},"async",[92,711,712],{"class":179}," () ",[92,714,685],{"class":156},[92,716,688],{"class":179},[92,718,719,722,725,728,731,733,736],{"class":94,"line":215},[92,720,721],{"class":156},"    const",[92,723,724],{"class":179}," { ",[92,726,727],{"class":106},"emitted",[92,729,730],{"class":179}," } ",[92,732,157],{"class":156},[92,734,735],{"class":98}," render",[92,737,738],{"class":179},"(Button, {\n",[92,740,741],{"class":94,"line":220},[92,742,743],{"class":179},"      props: {\n",[92,745,746,749,752],{"class":94,"line":226},[92,747,748],{"class":179},"        label: ",[92,750,751],{"class":102},"'Hello'",[92,753,235],{"class":179},[92,755,756],{"class":94,"line":238},[92,757,758],{"class":179},"      },\n",[92,760,761],{"class":94,"line":249},[92,762,763],{"class":179},"    })\n",[92,765,766],{"class":94,"line":255},[92,767,170],{"emptyLinePlaceholder":169},[92,769,770,773,776,779,782,785,787,789],{"class":94,"line":569},[92,771,772],{"class":156},"    await",[92,774,775],{"class":179}," fireEvent.",[92,777,778],{"class":98},"click",[92,780,781],{"class":179},"(screen.",[92,783,784],{"class":98},"getByText",[92,786,676],{"class":179},[92,788,751],{"class":102},[92,790,791],{"class":179},"))\n",[92,793,794],{"class":94,"line":575},[92,795,170],{"emptyLinePlaceholder":169},[92,797,798,801,803,805,808,811,813],{"class":94,"line":585},[92,799,800],{"class":98},"    expect",[92,802,676],{"class":179},[92,804,727],{"class":98},[92,806,807],{"class":179},"()).",[92,809,810],{"class":98},"toMatchInlineSnapshot",[92,812,676],{"class":179},[92,814,815],{"class":102},"`\n",[92,817,818],{"class":94,"line":591},[92,819,820],{"class":102},"      {\n",[92,822,823],{"class":94,"line":596},[92,824,825],{"class":102},"        \"click\": [\n",[92,827,829],{"class":94,"line":828},18,[92,830,831],{"class":102},"          [\n",[92,833,835],{"class":94,"line":834},19,[92,836,837],{"class":102},"            MouseEvent {\n",[92,839,841],{"class":94,"line":840},20,[92,842,843],{"class":102},"              \"isTrusted\": false,\n",[92,845,847],{"class":94,"line":846},21,[92,848,849],{"class":102},"            },\n",[92,851,853],{"class":94,"line":852},22,[92,854,855],{"class":102},"          ],\n",[92,857,859],{"class":94,"line":858},23,[92,860,861],{"class":102},"        ],\n",[92,863,865],{"class":94,"line":864},24,[92,866,867],{"class":102},"      }\n",[92,869,871,874],{"class":94,"line":870},25,[92,872,873],{"class":102},"    `",[92,875,876],{"class":179},")\n",[92,878,880],{"class":94,"line":879},26,[92,881,882],{"class":179},"  })\n",[92,884,886],{"class":94,"line":885},27,[92,887,170],{"emptyLinePlaceholder":169},[92,889,891,894,896,899,901,903],{"class":94,"line":890},28,[92,892,893],{"class":98},"  describe",[92,895,676],{"class":179},[92,897,898],{"class":102},"'solide'",[92,900,682],{"class":179},[92,902,685],{"class":156},[92,904,688],{"class":179},[92,906,908,911,913,916,918,920],{"class":94,"line":907},29,[92,909,910],{"class":98},"    it",[92,912,676],{"class":179},[92,914,915],{"class":102},"'doit rendre un bouton solide'",[92,917,682],{"class":179},[92,919,685],{"class":156},[92,921,688],{"class":179},[92,923,925,928,931,934,936],{"class":94,"line":924},30,[92,926,927],{"class":156},"      const",[92,929,930],{"class":106}," button",[92,932,933],{"class":156}," =",[92,935,735],{"class":98},[92,937,738],{"class":179},[92,939,941],{"class":94,"line":940},31,[92,942,943],{"class":179},"        props: {\n",[92,945,947,950,952],{"class":94,"line":946},32,[92,948,949],{"class":179},"          label: ",[92,951,751],{"class":102},[92,953,235],{"class":179},[92,955,957,960,963],{"class":94,"line":956},33,[92,958,959],{"class":179},"          variant: ",[92,961,962],{"class":102},"'solid'",[92,964,235],{"class":179},[92,966,968],{"class":94,"line":967},34,[92,969,970],{"class":179},"        },\n",[92,972,974],{"class":94,"line":973},35,[92,975,976],{"class":179},"      })\n",[92,978,980],{"class":94,"line":979},36,[92,981,170],{"emptyLinePlaceholder":169},[92,983,985,988,991,994,996,999],{"class":94,"line":984},37,[92,986,987],{"class":98},"      expect",[92,989,990],{"class":179},"(button.",[92,992,993],{"class":98},"html",[92,995,807],{"class":179},[92,997,998],{"class":98},"toMatchSnapshot",[92,1000,1001],{"class":179},"()\n",[92,1003,1005],{"class":94,"line":1004},38,[92,1006,763],{"class":179},[92,1008,1010],{"class":94,"line":1009},39,[92,1011,882],{"class":179},[92,1013,1015],{"class":94,"line":1014},40,[92,1016,170],{"emptyLinePlaceholder":169},[92,1018,1020,1022,1024,1027,1029,1031],{"class":94,"line":1019},41,[92,1021,893],{"class":98},[92,1023,676],{"class":179},[92,1025,1026],{"class":102},"'contour'",[92,1028,682],{"class":179},[92,1030,685],{"class":156},[92,1032,688],{"class":179},[92,1034,1036,1038,1040,1043,1045,1047],{"class":94,"line":1035},42,[92,1037,910],{"class":98},[92,1039,676],{"class":179},[92,1041,1042],{"class":102},"'doit rendre un bouton en contour'",[92,1044,682],{"class":179},[92,1046,685],{"class":156},[92,1048,688],{"class":179},[92,1050,1052,1054,1056,1058,1060],{"class":94,"line":1051},43,[92,1053,927],{"class":156},[92,1055,930],{"class":106},[92,1057,933],{"class":156},[92,1059,735],{"class":98},[92,1061,738],{"class":179},[92,1063,1065],{"class":94,"line":1064},44,[92,1066,943],{"class":179},[92,1068,1070,1072,1074],{"class":94,"line":1069},45,[92,1071,949],{"class":179},[92,1073,751],{"class":102},[92,1075,235],{"class":179},[92,1077,1079,1081,1084],{"class":94,"line":1078},46,[92,1080,959],{"class":179},[92,1082,1083],{"class":102},"'outline'",[92,1085,235],{"class":179},[92,1087,1089],{"class":94,"line":1088},47,[92,1090,970],{"class":179},[92,1092,1094],{"class":94,"line":1093},48,[92,1095,976],{"class":179},[92,1097,1099],{"class":94,"line":1098},49,[92,1100,170],{"emptyLinePlaceholder":169},[92,1102,1104,1106,1108,1110,1112,1114],{"class":94,"line":1103},50,[92,1105,987],{"class":98},[92,1107,990],{"class":179},[92,1109,993],{"class":98},[92,1111,807],{"class":179},[92,1113,998],{"class":98},[92,1115,1001],{"class":179},[92,1117,1119],{"class":94,"line":1118},51,[92,1120,763],{"class":179},[92,1122,1124],{"class":94,"line":1123},52,[92,1125,882],{"class":179},[92,1127,1129],{"class":94,"line":1128},53,[92,1130,258],{"class":179},[10,1132,1133,1134,1137,1138,1141,1142,1145,1146,1149,1150,1152],{},"Dans le premier test, nous utilisons la fonction ",[77,1135,1136],{},"render"," de Testing Library pour rendre notre composant ",[77,1139,1140],{},"Button",". Nous utilisons également la fonction ",[77,1143,1144],{},"fireEvent"," pour simuler un événement de clic sur le bouton. Enfin, nous utilisons la fonction ",[77,1147,1148],{},"expect"," de Vitest pour affirmer que le composant émet un événement ",[77,1151,778],{}," lorsqu'il est cliqué.",[10,1154,1155,1156,31,1159,1162,1163,1165],{},"Dans les tests suivants, nous vérifions les variantes ",[77,1157,1158],{},"solid",[77,1160,1161],{},"outline"," du bouton. Nous utilisons la fonction ",[77,1164,998],{}," de Vitest pour affirmer que le composant se rend correctement.",[10,1167,1168],{},"Ces tests reflètent deux approches clés que je préfère lors des tests de composants :",[1170,1171,1172,1176],"ol",{},[1173,1174,1175],"li",{},"Tester le comportement du composant. Par exemple, émet-il les bons événements lorsqu'il est cliqué ?",[1173,1177,1178],{},"Tester l'apparence du composant. Par exemple, se rend-il correctement avec des variantes différentes ?",[10,1180,1181,1182,39],{},"Dans la plupart des cas, ces deux types de tests suffisent à garantir que nos composants fonctionnent comme prévu, et ils peuvent être facilement réalisés à l'aide des ",[14,1183,1184],{},"tests par instantané",[260,1186,1189],{"color":1187,"icon":1188},"success","i-ph-lightbulb-duotone",[10,1190,1191],{},"Le test par instantané est un outil puissant qui nous permet de capturer la sortie de nos composants et de la comparer à un instantané de référence. Cela est très utile pour vérifier l'apparence de nos composants, garantissant qu'ils se rendent correctement et évitant d'écrire manuellement le HTML attendu.",[10,1193,1194],{},"Nous pouvons exécuter nos tests avec la commande suivante :",[82,1196,1198],{"className":84,"code":1197,"filename":86,"language":87,"meta":88,"style":88},"pnpm run test\n",[77,1199,1200],{"__ignoreMap":88},[92,1201,1202,1204,1207],{"class":94,"line":95},[92,1203,99],{"class":98},[92,1205,1206],{"class":102}," run",[92,1208,1209],{"class":102}," test\n",[10,1211,1212],{},"Tout fonctionne comme prévu !",[82,1214,1216],{"className":84,"code":1215,"filename":86,"language":87,"meta":88,"style":88}," DEV  v2.1.5 \u002Fhuchet-vue\u002Fpackages\u002Fhuchet-vue\n\n ✓ src\u002FButton\u002FButton.test.ts (3)\n   ✓ button (3)\n     ✓ doit émettre un événement de clic lorsqu'il est cliqué\n     ✓ solide (1)\n       ✓ doit rendre un bouton solide\n     ✓ contour (1)\n       ✓ doit rendre un bouton en contour\n\n Fichiers de test  1 réussi (1)\n      Tests  3 réussis (3)\n   Début à  00:00:00\n   Durée  536ms (transform 42ms, setup 0ms, collect 142ms, tests 22ms, environment 237ms, prepare 34ms)\n",[77,1217,1218,1229,1233,1244,1253,1279,1284,1289,1294,1299,1303,1308,1313,1318],{"__ignoreMap":88},[92,1219,1220,1223,1226],{"class":94,"line":95},[92,1221,1222],{"class":98}," DEV",[92,1224,1225],{"class":102},"  v2.1.5",[92,1227,1228],{"class":102}," \u002Fhuchet-vue\u002Fpackages\u002Fhuchet-vue\n",[92,1230,1231],{"class":94,"line":166},[92,1232,170],{"emptyLinePlaceholder":169},[92,1234,1235,1238,1241],{"class":94,"line":173},[92,1236,1237],{"class":98}," ✓",[92,1239,1240],{"class":102}," src\u002FButton\u002FButton.test.ts",[92,1242,1243],{"class":179}," (3)\n",[92,1245,1246,1249,1251],{"class":94,"line":189},[92,1247,1248],{"class":98},"   ✓",[92,1250,930],{"class":102},[92,1252,1243],{"class":179},[92,1254,1255,1258,1261,1264,1267,1270,1273,1276],{"class":94,"line":194},[92,1256,1257],{"class":98},"     ✓",[92,1259,1260],{"class":102}," doit",[92,1262,1263],{"class":102}," émettre",[92,1265,1266],{"class":102}," un",[92,1268,1269],{"class":102}," événement",[92,1271,1272],{"class":102}," de",[92,1274,1275],{"class":102}," clic",[92,1277,1278],{"class":102}," lorsqu'il est cliqué\n",[92,1280,1281],{"class":94,"line":209},[92,1282,1283],{"class":102},"     ✓ solide (1)\n",[92,1285,1286],{"class":94,"line":215},[92,1287,1288],{"class":102},"       ✓ doit rendre un bouton solide\n",[92,1290,1291],{"class":94,"line":220},[92,1292,1293],{"class":102},"     ✓ contour (1)\n",[92,1295,1296],{"class":94,"line":226},[92,1297,1298],{"class":102},"       ✓ doit rendre un bouton en contour\n",[92,1300,1301],{"class":94,"line":238},[92,1302,170],{"emptyLinePlaceholder":169},[92,1304,1305],{"class":94,"line":249},[92,1306,1307],{"class":102}," Fichiers de test  1 réussi (1)\n",[92,1309,1310],{"class":94,"line":255},[92,1311,1312],{"class":102},"      Tests  3 réussis (3)\n",[92,1314,1315],{"class":94,"line":569},[92,1316,1317],{"class":102},"   Début à  00:00:00\n",[92,1319,1320],{"class":94,"line":575},[92,1321,1322],{"class":102},"   Durée  536ms (transform 42ms, setup 0ms, collect 142ms, tests 22ms, environment 237ms, prepare 34ms)\n",[64,1324,1326],{"id":1325},"vérification-de-type-des-tests","Vérification de type des tests",[10,1328,1329,1330,1332],{},"En plus des tests, nous pouvons garantir que chaque type dans le projet est correct. C'est une manière simple de détecter les erreurs avant qu'elles ne se produisent, mais cela ne remplace pas les tests. Nous pouvons ajouter un nouveau script au fichier ",[77,1331,275],{}," pour exécuter la vérification de type :",[82,1334,1336],{"className":282,"code":1335,"filename":275,"language":284,"meta":88,"style":88},"{\n  \"scripts\": {\n    \"typecheck\": \"vue-tsc -p tsconfig.app.json --noEmit\"\n  }\n}\n",[77,1337,1338,1342,1348,1358,1362],{"__ignoreMap":88},[92,1339,1340],{"class":94,"line":95},[92,1341,291],{"class":179},[92,1343,1344,1346],{"class":94,"line":166},[92,1345,296],{"class":106},[92,1347,299],{"class":179},[92,1349,1350,1353,1355],{"class":94,"line":173},[92,1351,1352],{"class":106},"    \"typecheck\"",[92,1354,307],{"class":179},[92,1356,1357],{"class":102},"\"vue-tsc -p tsconfig.app.json --noEmit\"\n",[92,1359,1360],{"class":94,"line":189},[92,1361,327],{"class":179},[92,1363,1364],{"class":94,"line":194},[92,1365,332],{"class":179},[10,1367,1368,1369,1372,1373,1375,1376,1379],{},"Ce script utilise la commande ",[77,1370,1371],{},"vue-tsc"," pour vérifier les types du projet dans le contexte du fichier ",[77,1374,400],{},". L'option ",[77,1377,1378],{},"--noEmit"," empêche la transpilation des fichiers TypeScript en fichiers JavaScript, se concentrant uniquement sur la vérification des types sans construction.",[1381,1382,1383],"style",{},"html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":88,"searchDepth":166,"depth":166,"links":1385},[1386,1387,1388,1389],{"id":66,"depth":166,"text":67},{"id":338,"depth":166,"text":339},{"id":601,"depth":166,"text":602},{"id":1325,"depth":166,"text":1326},"ebf9971d-0101-4d55-815b-87be77651be6","2024-11-24","Apprenez à automatiser les tests pour les composants Vue.js en utilisant Vitest et Testing Library pour des tests efficaces et centrés sur l'utilisateur.","md",null,{},"\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fautomatic-component-testing-with-vitest-and-testing-library","---\ncontentId: ebf9971d-0101-4d55-815b-87be77651be6\npart: 4\ntitle: \"Test de composants automatisé avec Vitest et Testing Library\"\ndescription: \"Apprenez à automatiser les tests pour les composants Vue.js en utilisant Vitest et Testing Library pour des tests efficaces et centrés sur l'utilisateur.\"\ndate: 2024-11-24\nseriesSlug: the-complete-guide-to-building-a-vue-js-component-library\n---\n\nLes **tests** sont une partie essentielle du développement logiciel. Ils garantissent que nos composants fonctionnent comme prévu et nous aident à détecter les bogues tôt dans le processus de développement. Dans cet article, nous allons explorer comment tester automatiquement les **composants Vue.js** en utilisant [**Vitest**](https:\u002F\u002Fvitest.dev) et [**Testing Library**](https:\u002F\u002Ftesting-library.com).\n\nLorsque l'on travaille sur un projet **Vite**, **Vitest** est le meilleur choix pour tester nos composants. C'est un exécuteur de tests optimisé pour Vite et il est très facile à utiliser. **Testing Library** s'appuie sur **Vue Test Utils** et fournit un ensemble d'outils pour tester nos composants de manière centrée sur l'utilisateur.\n\nPar exemple, **Testing Library** nous encourage à tester le comportement de nos composants plutôt que leur implémentation. C'est un concept puissant qui nous permet de tester les composants d'une manière plus proche de l'expérience utilisateur et facilite le refactoring.\n\n## Configuration de Vitest\n\nPour commencer, nous devons installer **Vitest** et **Testing Library** dans notre package `packages\u002Fhuchet-vue` :\n\n```bash [terminal]\npnpm add -D vitest @testing-library\u002Fvue jsdom\n```\n\nÉtant donné que nous testons des composants frontend, nous avons besoin d'un environnement avec un **DOM**. Pour éviter de lancer un vrai navigateur, qui est lent et gourmand en ressources, nous pouvons utiliser **JSDOM**, une implémentation légère du DOM dans Node.js.\n\nPour faire fonctionner Vitest avec JSDOM, nous devons le configurer dans le fichier `vite.config.ts` :\n\n```ts [vite.config.ts]\n\u002F\u002F\u002F \u003Creference types=\"vitest\" \u002F>\n\nimport { defineConfig } from 'vite'\n\nexport default defineConfig({\n  \u002F\u002F ...\n\n  test: {\n    globals: true,\n    environment: 'jsdom',\n  },\n})\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\n`\u002F\u002F\u002F \u003Creference types=\"vitest\" \u002F>` est crucial pour garantir que les bons types soient disponibles dans le fichier de configuration de Vite. Cela augmente le fichier de configuration de Vite avec les types de Vitest.\n::\n\nDans le fichier `package.json` de `packages\u002Fhuchet-vue`, ajoutez deux nouveaux scripts pour exécuter les tests :\n\n```json [package.json]\n{\n  \"scripts\": {\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\"\n  }\n}\n```\n\nLe premier script exécute les tests une fois, et le second script exécute les tests en mode surveillance s'il ne détecte pas un environnement CI.\n\n## Configuration TypeScript\n\nNos fichiers de test forment un nouveau contexte TypeScript. Nous devons accéder à l'API Node.js mais pas à l'environnement du navigateur. Comme pour tout nouveau contexte TypeScript, nous le configurons via un nouveau fichier TSConfig.\n\nCréez un fichier `tsconfig.test.json` qui étend `tsconfig.node.json` et inclut les fichiers `test.ts` :\n\n```json [test.ts]\n{\n  \"extends\": \".\u002Ftsconfig.node.json\",\n  \"include\": [\"src\u002F**\u002F*.test.ts\"]\n}\n```\n\nDans le fichier `tsconfig.app.json`, nous excluons les fichiers `test.ts`, de la même manière que nous avons exclu les fichiers `story.vue` :\n\n```json [story.vue]\n{\n  \"extends\": \"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\",\n  \"include\": [\n    \"src\u002F**\u002F*.ts\",\n    \"src\u002F**\u002F*.vue\"\n  ],\n  \"exclude\": [\n    \"src\u002F**\u002F*.story.vue\",\n    \"src\u002F**\u002F*.test.ts\" \u002F\u002F [!code ++]\n  ]\n}\n```\n\nDans notre fichier TSConfig principal, nous ajoutons une référence au fichier `tsconfig.test.json` :\n\n```json [tsconfig.test.json]\n{\n  \"files\": [],\n  \"references\": [\n    {\n      \"path\": \".\u002Ftsconfig.app.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.node.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.story.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.test.json\" \u002F\u002F [!code ++]\n    }\n  ]\n}\n```\n\n## Écrire notre premier test\n\nChaque composant est isolé et encapsulé dans son dossier dès le départ. Les tests suivront la même structure. Créez un fichier `src\u002FButton\u002FButton.test.ts` et écrivez notre premier test :\n\n```bash [src\u002FButton\u002FButton.test.ts]\ntouch src\u002FButton\u002FButton.test.ts\n```\n\n```ts [Exemple]\nimport { fireEvent, render, screen } from '@testing-library\u002Fvue'\nimport { describe, expect, it } from 'vitest'\nimport Button from '.\u002FButton.vue'\n\ndescribe('button', () => {\n  it('doit émettre un événement de clic lorsqu\\'il est cliqué', async () => {\n    const { emitted } = render(Button, {\n      props: {\n        label: 'Hello',\n      },\n    })\n\n    await fireEvent.click(screen.getByText('Hello'))\n\n    expect(emitted()).toMatchInlineSnapshot(`\n      {\n        \"click\": [\n          [\n            MouseEvent {\n              \"isTrusted\": false,\n            },\n          ],\n        ],\n      }\n    `)\n  })\n\n  describe('solide', () => {\n    it('doit rendre un bouton solide', () => {\n      const button = render(Button, {\n        props: {\n          label: 'Hello',\n          variant: 'solid',\n        },\n      })\n\n      expect(button.html()).toMatchSnapshot()\n    })\n  })\n\n  describe('contour', () => {\n    it('doit rendre un bouton en contour', () => {\n      const button = render(Button, {\n        props: {\n          label: 'Hello',\n          variant: 'outline',\n        },\n      })\n\n      expect(button.html()).toMatchSnapshot()\n    })\n  })\n})\n```\n\nDans le premier test, nous utilisons la fonction `render` de Testing Library pour rendre notre composant `Button`. Nous utilisons également la fonction `fireEvent` pour simuler un événement de clic sur le bouton. Enfin, nous utilisons la fonction `expect` de Vitest pour affirmer que le composant émet un événement `click` lorsqu'il est cliqué.\n\nDans les tests suivants, nous vérifions les variantes `solid` et `outline` du bouton. Nous utilisons la fonction `toMatchSnapshot` de Vitest pour affirmer que le composant se rend correctement.\n\nCes tests reflètent deux approches clés que je préfère lors des tests de composants :\n\n1. Tester le comportement du composant. Par exemple, émet-il les bons événements lorsqu'il est cliqué ?\n2. Tester l'apparence du composant. Par exemple, se rend-il correctement avec des variantes différentes ?\n\nDans la plupart des cas, ces deux types de tests suffisent à garantir que nos composants fonctionnent comme prévu, et ils peuvent être facilement réalisés à l'aide des **tests par instantané**.\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nLe test par instantané est un outil puissant qui nous permet de capturer la sortie de nos composants et de la comparer à un instantané de référence. Cela est très utile pour vérifier l'apparence de nos composants, garantissant qu'ils se rendent correctement et évitant d'écrire manuellement le HTML attendu.\n::\n\nNous pouvons exécuter nos tests avec la commande suivante :\n\n```bash [terminal]\npnpm run test\n```\n\nTout fonctionne comme prévu !\n\n```bash [terminal]\n DEV  v2.1.5 \u002Fhuchet-vue\u002Fpackages\u002Fhuchet-vue\n\n ✓ src\u002FButton\u002FButton.test.ts (3)\n   ✓ button (3)\n     ✓ doit émettre un événement de clic lorsqu'il est cliqué\n     ✓ solide (1)\n       ✓ doit rendre un bouton solide\n     ✓ contour (1)\n       ✓ doit rendre un bouton en contour\n\n Fichiers de test  1 réussi (1)\n      Tests  3 réussis (3)\n   Début à  00:00:00\n   Durée  536ms (transform 42ms, setup 0ms, collect 142ms, tests 22ms, environment 237ms, prepare 34ms)\n```\n\n## Vérification de type des tests\n\nEn plus des tests, nous pouvons garantir que chaque type dans le projet est correct. C'est une manière simple de détecter les erreurs avant qu'elles ne se produisent, mais cela ne remplace pas les tests. Nous pouvons ajouter un nouveau script au fichier `package.json` pour exécuter la vérification de type :\n\n```json [package.json]\n{\n  \"scripts\": {\n    \"typecheck\": \"vue-tsc -p tsconfig.app.json --noEmit\"\n  }\n}\n```\n\nCe script utilise la commande `vue-tsc` pour vérifier les types du projet dans le contexte du fichier `tsconfig.app.json`. L'option `--noEmit` empêche la transpilation des fichiers TypeScript en fichiers JavaScript, se concentrant uniquement sur la vérification des types sans construction.\n",{"title":5,"description":1392},"the-complete-guide-to-building-a-vue-js-component-library",{"loc":1396},"fr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fautomatic-component-testing-with-vitest-and-testing-library","OwHjBhn8NM_FbcSgmstrCRgZX8waE5zPDBKenm5tJyQ",{"overview":1404,"chapters":1599},{"id":1405,"title":1406,"body":1407,"contentId":1581,"date":1391,"description":1582,"extension":1393,"github":1583,"meetTheInstructor":1586,"meta":1587,"navigation":169,"part":1394,"path":1588,"rawbody":1589,"robots":1394,"schemaOrg":1394,"seo":1590,"seriesSlug":1399,"sitemap":1591,"stem":1592,"subtitle":1593,"topics":1594,"__hash__":1598},"series\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library.md","Guide pour construire une bibliothèque de composants Vue.js",{"type":7,"value":1408,"toc":1578},[1409,1412,1415,1427,1431,1434,1447,1450,1565,1568,1572],[10,1410,1411],{},"Bienvenue ! 👋",[10,1413,1414],{},"Au départ, cette série était censée être un seul article, mais il est rapidement devenu évident qu'elle serait trop longue. Même GitHub ne voulait pas l'afficher dans l'onglet des fichiers des pull requests. Par conséquent, j'ai décidé de la diviser en plusieurs articles pour la rendre plus digeste et pour me concentrer sur chaque partie individuellement.",[10,1416,1417,1418,1422,1423],{},"Cette série est en quelque sorte une suite de l'article ",[23,1419,1421],{"href":1420},"\u002Ffr\u002Fposts\u002Fthe-simplest-method-to-create-a-vue-js-component-library","La Méthode la Plus Simple pour Créer une Bibliothèque de Composants Vue.js",", mais elle adopte une approche plus professionnelle. ",[1424,1425,1426],"em",{},"Vous apprendrez comment les bibliothèques de composants les plus populaires sont construites dans les coulisses et comment créer la vôtre.",[1428,1429],"callout-read-more",{"id":1430},"75df6bff-de40-4056-af23-fae2401cd21a",[10,1432,1433],{},"Bien que ce soit toujours ma méthode préférée lorsque je suis certain de ce que je veux réaliser, j'ai également reçu des retours de lecteurs cherchant un comportement plus personnalisé et nécessitant des fonctionnalités plus complexes.",[10,1435,1436,1437,1442,1443,39],{},"C'est compréhensible. Bien que ",[23,1438,1441],{"href":1439,"rel":1440},"https:\u002F\u002Fgithub.com\u002Funjs\u002Funbuild",[27],"unbuild"," soit un outil puissant, il ne peut égaler la flexibilité, l'écosystème de plugins et l'adoption de ",[23,1444,45],{"href":1445,"rel":1446},"https:\u002F\u002Fvite.dev\u002F",[27],[10,1448,1449],{},"Tout au long de cette série, nous aborderons les sujets suivants :",[1170,1451,1452,1464,1496,1514,1529,1535,1547],{},[1173,1453,1454,1457,1458,1463],{},[14,1455,1456],{},"Prise en Main avec Monorepo, Linter et Formatter"," : Nous mettrons en place un monorepo pour gérer notre bibliothèque de composants et tous les outils nécessaires pour garantir une bonne expérience de développement. Nous configurerons également ",[23,1459,1462],{"href":1460,"rel":1461},"https:\u002F\u002Feslint.org\u002F",[27],"ESLint"," pour assurer la cohérence du code.",[1173,1465,1466,1469,1470,46,1475,31,1480,1485,1486,31,1491,39],{},[14,1467,1468],{},"Création d'un Premier Composant avec Vue.js et Tailwind CSS"," : Nous créerons notre premier composant avec ",[23,1471,1474],{"href":1472,"rel":1473},"https:\u002F\u002Fvuejs.org\u002F",[27],"Vue.js",[23,1476,1479],{"href":1477,"rel":1478},"https:\u002F\u002Ftailwindcss.com\u002F",[27],"Tailwind CSS",[23,1481,1484],{"href":1482,"rel":1483},"https:\u002F\u002Fwww.tailwind-variants.org\u002F",[27],"Tailwind Variants"," en utilisant les techniques les plus avancées et puissantes employées dans des bibliothèques de composants populaires comme ",[23,1487,1490],{"href":1488,"rel":1489},"https:\u002F\u002Fwww.radix-vue.com\u002F",[27],"Radix Vue",[23,1492,1495],{"href":1493,"rel":1494},"https:\u002F\u002Fui.nuxt.com\u002F",[27],"Nuxt UI",[1173,1497,1498,1501,1502,1507,1508,1513],{},[14,1499,1500],{},"Une Meilleure Expérience de Développement avec TypeScript et TSConfig"," : Nous améliorerons notre expérience de développement en ajoutant ",[23,1503,1506],{"href":1504,"rel":1505},"https:\u002F\u002Fwww.typescriptlang.org\u002F",[27],"TypeScript"," à notre bibliothèque de composants et en configurant ",[23,1509,1512],{"href":1510,"rel":1511},"https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig",[27],"TSConfig"," pour nous assurer que nos composants sont correctement typés et que nous pouvons tirer pleinement parti des fonctionnalités de TypeScript.",[1173,1515,1516,1519,1520,31,1524,1528],{},[14,1517,1518],{},"Tests Automatiques des Composants avec Vitest et Testing Library"," : Nous écrirons des tests pour nos composants en utilisant ",[23,1521,30],{"href":1522,"rel":1523},"https:\u002F\u002Fvitest.dev\u002Fguide\u002F",[27],[23,1525,38],{"href":1526,"rel":1527},"https:\u002F\u002Ftesting-library.com\u002F",[27]," pour garantir que nos composants fonctionnent comme prévu. Cela est crucial pour une bibliothèque de composants professionnelle qui reste fiable dans le temps.",[1173,1530,1531,1534],{},[14,1532,1533],{},"Livraison Continue et Confiance dans les Composants"," : Nous établirons un processus d'intégration continue pour garantir que nos composants sont toujours livrés avec confiance. Pour chaque commit de chaque branche, nous exécuterons nos tests pour vérifier que tout fonctionne correctement. Nous établirons également un processus de publication pour publier nos composants sur npm.",[1173,1536,1537,1540,1541,1546],{},[14,1538,1539],{},"Création d'un Playground et d'un Storybook pour les Composants"," : Nous créerons un playground pour tester nos composants dans un environnement réel et un storybook avec ",[23,1542,1545],{"href":1543,"rel":1544},"https:\u002F\u002Fhistoire.dev\u002F",[27],"Histoire"," pour les documenter. Cela nous permettra de partager nos composants avec d'autres développeurs et de les tester dans divers scénarios, tant en isolation qu'en combinaison.",[1173,1548,1549,1552,1553,1558,1559,1564],{},[14,1550,1551],{},"Amélioration de l'Intégration avec Unplugin et le Module Nuxt"," : Nous améliorerons l'intégration de notre bibliothèque de composants avec l'écosystème en créant un plugin Vite avec ",[23,1554,1557],{"href":1555,"rel":1556},"https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components",[27],"Unplugin Vue Components"," et un ",[23,1560,1563],{"href":1561,"rel":1562},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fguide\u002Fgoing-further\u002Fmodules",[27],"module Nuxt"," pour utiliser nos composants dans une application Nuxt.",[10,1566,1567],{},"À la fin de cette série, vous aurez une bibliothèque de composants Vue.js complète que vous pourrez utiliser dans vos projets ou partager avec la communauté, comme un développeur professionnel. N'est-ce pas excitant ? 😎",[64,1569,1571],{"id":1570},"chapitres","Chapitres",[1573,1574],"series-chapters-list",{"className":1575},[1576,1577],"mx-auto","max-w-5xl",{"title":88,"searchDepth":166,"depth":166,"links":1579},[1580],{"id":1570,"depth":166,"text":1571},"1fafed86-05bb-4de4-b7d0-bb0bd6abc9d2","Découvrez comment construire une bibliothèque de composants Vue.js en utilisant Vite avec un guide couvrant des techniques de développement web professionnel.",{"name":1584,"repository":1585},"huchet-vue","barbapapazes\u002Fhuchet-vue","J'ai créé cette série parce que j'aime \u003Cstrong>Vue.js\u003C\u002Fstrong> et que, depuis des années, je n'ai pas réussi à trouver un guide complet, à jour et \u003Cstrong>professionnel\u003C\u002Fstrong> sur la façon de construire une bibliothèque de composants Vue.js et que je veux que plus de développeurs de logiciels se sentent capables de créer leur propre bibliothèque.",{},"\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library","---\ncontentId: 1fafed86-05bb-4de4-b7d0-bb0bd6abc9d2\ntitle: Guide pour construire une bibliothèque de composants Vue.js\nsubtitle: Le cours le plus avancé et le plus professionnel pour créer une bibliothèque de composants Vue.js avec Vite.\ndescription: Découvrez comment construire une bibliothèque de composants Vue.js en utilisant Vite avec un guide couvrant des techniques de développement web professionnel.\ndate: 2024-11-24\ntopics:\n  - vue\n  - vite\n  - bibliothèque de composants\ngithub:\n  name: huchet-vue\n  repository: barbapapazes\u002Fhuchet-vue\nmeetTheInstructor: J'ai créé cette série parce que j'aime \u003Cstrong>Vue.js\u003C\u002Fstrong> et que, depuis des années, je n'ai pas réussi à trouver un guide complet, à jour et \u003Cstrong>professionnel\u003C\u002Fstrong> sur la façon de construire une bibliothèque de composants Vue.js et que je veux que plus de développeurs de logiciels se sentent capables de créer leur propre bibliothèque.\nseriesSlug: the-complete-guide-to-building-a-vue-js-component-library\n---\n\nBienvenue ! 👋\n\nAu départ, cette série était censée être un seul article, mais il est rapidement devenu évident qu'elle serait trop longue. Même GitHub ne voulait pas l'afficher dans l'onglet des fichiers des pull requests. Par conséquent, j'ai décidé de la diviser en plusieurs articles pour la rendre plus digeste et pour me concentrer sur chaque partie individuellement.\n\nCette série est en quelque sorte une suite de l'article [La Méthode la Plus Simple pour Créer une Bibliothèque de Composants Vue.js](\u002Ffr\u002Fposts\u002Fthe-simplest-method-to-create-a-vue-js-component-library), mais elle adopte une approche plus professionnelle. _Vous apprendrez comment les bibliothèques de composants les plus populaires sont construites dans les coulisses et comment créer la vôtre._\n\n\u003CCalloutReadMore id=\"75df6bff-de40-4056-af23-fae2401cd21a\" \u002F>\n\nBien que ce soit toujours ma méthode préférée lorsque je suis certain de ce que je veux réaliser, j'ai également reçu des retours de lecteurs cherchant un comportement plus personnalisé et nécessitant des fonctionnalités plus complexes.\n\nC'est compréhensible. Bien que [unbuild](https:\u002F\u002Fgithub.com\u002Funjs\u002Funbuild) soit un outil puissant, il ne peut égaler la flexibilité, l'écosystème de plugins et l'adoption de [Vite](https:\u002F\u002Fvite.dev\u002F).\n\nTout au long de cette série, nous aborderons les sujets suivants :\n\n1. **Prise en Main avec Monorepo, Linter et Formatter** : Nous mettrons en place un monorepo pour gérer notre bibliothèque de composants et tous les outils nécessaires pour garantir une bonne expérience de développement. Nous configurerons également [ESLint](https:\u002F\u002Feslint.org\u002F) pour assurer la cohérence du code.\n2. **Création d'un Premier Composant avec Vue.js et Tailwind CSS** : Nous créerons notre premier composant avec [Vue.js](https:\u002F\u002Fvuejs.org\u002F), [Tailwind CSS](https:\u002F\u002Ftailwindcss.com\u002F) et [Tailwind Variants](https:\u002F\u002Fwww.tailwind-variants.org\u002F) en utilisant les techniques les plus avancées et puissantes employées dans des bibliothèques de composants populaires comme [Radix Vue](https:\u002F\u002Fwww.radix-vue.com\u002F) et [Nuxt UI](https:\u002F\u002Fui.nuxt.com\u002F).\n3. **Une Meilleure Expérience de Développement avec TypeScript et TSConfig** : Nous améliorerons notre expérience de développement en ajoutant [TypeScript](https:\u002F\u002Fwww.typescriptlang.org\u002F) à notre bibliothèque de composants et en configurant [TSConfig](https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig) pour nous assurer que nos composants sont correctement typés et que nous pouvons tirer pleinement parti des fonctionnalités de TypeScript.\n4. **Tests Automatiques des Composants avec Vitest et Testing Library** : Nous écrirons des tests pour nos composants en utilisant [Vitest](https:\u002F\u002Fvitest.dev\u002Fguide\u002F) et [Testing Library](https:\u002F\u002Ftesting-library.com\u002F) pour garantir que nos composants fonctionnent comme prévu. Cela est crucial pour une bibliothèque de composants professionnelle qui reste fiable dans le temps.\n5. **Livraison Continue et Confiance dans les Composants** : Nous établirons un processus d'intégration continue pour garantir que nos composants sont toujours livrés avec confiance. Pour chaque commit de chaque branche, nous exécuterons nos tests pour vérifier que tout fonctionne correctement. Nous établirons également un processus de publication pour publier nos composants sur npm.\n6. **Création d'un Playground et d'un Storybook pour les Composants** : Nous créerons un playground pour tester nos composants dans un environnement réel et un storybook avec [Histoire](https:\u002F\u002Fhistoire.dev\u002F) pour les documenter. Cela nous permettra de partager nos composants avec d'autres développeurs et de les tester dans divers scénarios, tant en isolation qu'en combinaison.\n7. **Amélioration de l'Intégration avec Unplugin et le Module Nuxt** : Nous améliorerons l'intégration de notre bibliothèque de composants avec l'écosystème en créant un plugin Vite avec [Unplugin Vue Components](https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components) et un [module Nuxt](https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fguide\u002Fgoing-further\u002Fmodules) pour utiliser nos composants dans une application Nuxt.\n\nÀ la fin de cette série, vous aurez une bibliothèque de composants Vue.js complète que vous pourrez utiliser dans vos projets ou partager avec la communauté, comme un développeur professionnel. N'est-ce pas excitant ? 😎\n\n## Chapitres\n\n::series-chapters-list\n---\nclass: mx-auto max-w-5xl\n---\n::\n",{"title":1406,"description":1582},{"loc":1588},"fr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library","Le cours le plus avancé et le plus professionnel pour créer une bibliothèque de composants Vue.js avec Vite.",[1595,1596,1597],"vue","vite","bibliothèque de composants","uPZbK53-TcUyWNHiN_UucohLqZHXH1ZV1Tpgk8hOc5c",[1600,1605,1610,1615,1616,1621,1626],{"contentId":1601,"title":1602,"description":1603,"path":1604,"part":95,"github":1394,"topics":1394},"bd5d11e9-876b-4ed0-b27b-ba400670de76","Bien démarrer avec un monorepo, un linter et un formatter","Commencez votre aventure avec le monorepo ! Apprenez à configurer un linter et un formatter pour un codage rationalisé et l'organisation de votre projet.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fgetting-started-with-monorepo-linter-and-formatter",{"contentId":1606,"title":1607,"description":1608,"path":1609,"part":166,"github":1394,"topics":1394},"24847f3a-2219-4e78-829b-0f5a08fa9baa","Construire un premier composant avec Vue.js et Tailwind CSS","Création d'un composant avec Vue.js en utilisant Tailwind CSS pour le style et les variantes, ainsi qu'une configuration du build avec Vite.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fbuilding-a-first-component-with-vuejs-and-tailwind-css",{"contentId":1611,"title":1612,"description":1613,"path":1614,"part":173,"github":1394,"topics":1394},"09cf0b6c-6e56-4718-85d2-784fc0337ebd","Une meilleure expérience avec TypeScript et TSConfig","Apprenez à configurer TypeScript avec plusieurs contextes et à générer des types pour une bibliothèque afin d'exposer des types aux développeurs.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fa-better-development-experience-with-typescript-and-tsconfig",{"contentId":1390,"title":5,"description":1392,"path":1396,"part":189,"github":1394,"topics":1394},{"contentId":1617,"title":1618,"description":1619,"path":1620,"part":194,"github":1394,"topics":1394},"e3477b60-7fca-49d3-a944-2bde3f39a3c1","Intégration continue et livraison simplifiée des composants","Implémentez un pipeline d'intégration continue avec GitHub Actions et automatisez le processus de publication sur npm","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fdelivering-components-continuously-and-with-confidence",{"contentId":1622,"title":1623,"description":1624,"path":1625,"part":209,"github":1394,"topics":1394},"0d31ab1a-2cc6-44d0-bdf5-31a5ecacd755","Créer un Playground et un Storybook pour les Composants","Découvrez comment créer un playground et utiliser Histoire pour visualiser et documenter vos composants dans des scénarios isolés et combinés.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components",{"contentId":1627,"title":1628,"description":1629,"path":1630,"part":215,"github":1394,"topics":1394},"aa563897-2826-4726-bdaf-4441199328d8","Améliorer l'intégration avec Unplugin et Nuxt Module","Découvrez comment intégrer sans effort une bibliothèque de composants Vue.js en utilisant Unplugin Vue Components et Nuxt Module.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fenhancing-integration-with-unplugin-and-nuxt-module",1795016703289]