Testování částí v JavaScriptu a TypeScriptu v sadě Visual Studio

Pokud vaše oblíbená architektura není podporovaná, přečtěte si téma Přidání podpory pro architekturu testování jednotek s informacemi o přidání podpory.

Zápis testů jednotek pro projekt založený na rozhraní příkazového řádku (.esproj)

Projekty založené na rozhraní příkazového řádku podporované v sadě Visual Studio 2022 pracují s Průzkumníkem testů. Jest je integrovaná testovací architektura pro projekty React a Vue a Karma a Jasmine se používají pro projekty Angular. Ve výchozím nastavení budete moct spouštět výchozí testy poskytované jednotlivými architekturami a také všechny další testy, které napíšete. Stačí stisknout tlačítko Spustit v Průzkumníku testů. Pokud průzkumníka testů ještě nemáte otevřený, najdete ho tak, že v řádku nabídek vyberete Průzkumníka testů>.

Pokud chcete spustit testy jednotek z příkazového řádku, klikněte pravým tlačítkem na projekt v Průzkumník řešení, zvolte Otevřít v terminálu a spusťte příkaz specifický pro typ testu.

Informace o nastavení testů jednotek najdete v následujících tématech:

• Testování Reactu pomocí Jestu
• Angular testing
• Testování Vue.js

Tady je také uveden jednoduchý příklad. K úplným informacím však použijte předchozí odkazy.

Přidání testu jednotek (.esproj)

Následující příklad je založený na šabloně projektu TypeScript React poskytované v sadě Visual Studio 2022 verze 17.8 nebo novější, což je samostatná šablona projektu TypeScript React. U Vue a Angular jsou kroky podobné.

1. V Průzkumník řešení klikněte pravým tlačítkem myši na projekt React a zvolte Upravit soubor projektu.

2. Ujistěte se, že se v souboru .esproj nacházejí následující vlastnosti se zobrazenými hodnotami.

   <PropertyGroup>
     <JavaScriptTestRoot>src\</JavaScriptTestRoot>
     <JavaScriptTestFramework>Jest</JavaScriptTestFramework>
   </PropertyGroup> 
   

   Tento příklad určuje Jako testovací architekturu Jest. Místo toho můžete zadat Mocha, Tape nebo Jasmine.

   Element JavaScriptTestRoot určuje, že testy jednotek budou ve složce src kořenového adresáře projektu.

3. V Průzkumník řešení klikněte pravým tlačítkem na uzel npm a zvolte Nainstalovat nové balíčky npm.

   Pomocí dialogového okna instalace balíčku npm nainstalujte následující balíčky npm:

   • jest
   • jest-editor-support

   Tyto balíčky se přidají do souboru package.json v rámci závislostí.

4. V souboru package.json přidejte test oddíl na konec oddílu scripts :

   "scripts": {
      ...
      "test": "jest"
   },
   

5. V Průzkumník řešení klikněte pravým tlačítkem na složku src a zvolte Přidat>novou položku a pak přidejte nový soubor s názvem App.test.tsx.

   Tím se nový soubor přidá do složky src.

6. Do souboru App.test.tsx přidejte následující kód.

   describe('testAsuite', () => {
      it('testA1', async () => {
         expect(2).toBe(2);
      });
   });
   

7. Otevřete Průzkumníka testů (zvolte >Průzkumník testů) a Visual Studio vyhledá a zobrazí testy. Pokud se testy nezobrazují na začátku, znovu sestavte projekt a aktualizujte seznam.

   

   Poznámka:

   Pro TypeScript nepoužívejte outfile možnost v souboru tsconfig.json, protože Průzkumník testů nebude moct najít testy jednotek. Tuto možnost můžete použít outdir , ale ujistěte se, že jsou konfigurační soubory, jako package.json jsou a tsconfig.json jsou v kořenovém adresáři projektu.

Spouštění testů (.esproj)

Testy můžete spustit kliknutím na odkaz Spustit vše v Průzkumníku testů. Nebo můžete testy spustit tak, že vyberete jeden nebo více testů nebo skupin, kliknete pravým tlačítkem myši a v místní nabídce vyberete Spustit . Testy běží na pozadí a Průzkumník testů se automaticky aktualizuje a zobrazí výsledky. Vybrané testy můžete také ladit tak, že kliknete pravým tlačítkem myši a vyberete Ladit.

Následující obrázek ukazuje příklad s přidaným druhým testem jednotek.

U některých architektur testů jednotek se testy jednotek obvykle spouštějí proti vygenerovanému kódu JavaScriptu.

Přidání podpory pro architekturu testování jednotek

Podporu dalších testovacích architektur můžete přidat implementací logiky zjišťování a spouštění pomocí JavaScriptu.

Uděláte to tak, že přidáte složku s názvem testovací architektury v části:

<VisualStudioFolder>\Common7\IDE\Extensions\Microsoft\NodeJsTools\TestAdapter\TestFrameworks

Pokud složku v projektu ASP.NET Core nevidíteNodeJsTools, přidejte úlohu vývoje Node.js pomocí Instalační program pro Visual Studio. Tato úloha zahrnuje podporu testování jednotek v JavaScriptu a TypeScriptu.

Tato složka musí obsahovat javascriptový soubor se stejným názvem, který exportuje následující dvě funkce:

• find_tests
• run_tests

Dobrý příklad find_tests implementace a run_tests implementace najdete v implementaci architektury testování jednotek Mocha v těchto tématech:

<VisualStudioFolder>\Common7\IDE\Extensions\Microsoft\NodeJsTools\TestAdapter\TestFrameworks\mocha\mocha.js

Ke zjišťování dostupných testovacích architektur dochází při spuštění sady Visual Studio. Pokud je v době, kdy je sada Visual Studio spuštěná, přidá se architektura, restartujte Visual Studio, aby ho detekoval. Při provádění změn v implementaci ale nemusíte restartovat.

Testy jednotek v rozhraní .NET Framework

Nejste omezeni na psaní testů jednotek pouze v projektech Node.js a ASP.NET Core. Když přidáte vlastnosti TestFramework a TestRoot do libovolného projektu jazyka C# nebo Visual Basic, tyto testy budou uvedeny a můžete je spustit pomocí okna Průzkumníka testů.

Pokud to chcete povolit, klikněte pravým tlačítkem myši na uzel projektu v Průzkumník řešení, zvolte Uvolnit projekt a pak zvolte Upravit projekt. Potom do souboru projektu přidejte do skupiny vlastností následující dva prvky.

<PropertyGroup>
    <JavaScriptTestRoot>tests\</JavaScriptTestRoot>
    <JavaScriptTestFramework>Tape</JavaScriptTestFramework>
</PropertyGroup>

Potom přidejte testy do zadané kořenové složky testu a budou dostupné ke spuštění v okně Průzkumníka testů. Pokud se zpočátku nezobrazí, budete možná muset projekt znovu sestavit.

Test jednotek .NET Core a .NET Standard

Kromě předchozích vlastností popsaných pro rozhraní .NET Framework musíte také nainstalovat balíček NuGet Microsoft.JavaScript.UnitTest a nastavit vlastnost:

<PropertyGroup>
    <GenerateProgramFile>false</GenerateProgramFile>
</PropertyGroup>

Některé testovací architektury můžou pro detekci testů vyžadovat další balíčky npm. Například jest vyžaduje balíček npm s podporou jest-editoru. V případě potřeby si projděte dokumentaci pro konkrétní architekturu.

Zápis testů jednotek v projektu Node.js (.njsproj)

Před přidáním testů jednotek do projektu v projektech Node.js se ujistěte, že je v projektu místně nainstalovaná architektura, kterou chcete použít. To se dá snadno udělat pomocí instalačního okna balíčku npm.

Upřednostňovaným způsobem, jak do projektu přidat testy jednotek, je vytvoření složky testů v projektu a nastavení jako kořen testu ve vlastnostech projektu. Musíte také vybrat testovací architekturu, kterou chcete použít.

Do projektu můžete přidat jednoduché prázdné testy pomocí dialogového okna Přidat novou položku . JavaScript i TypeScript jsou podporovány ve stejném projektu.

Pro test jednotek Mocha použijte následující kód:

var assert = require('assert');

describe('Test Suite 1', function() {
    it('Test 1', function() {
        assert.ok(true, "This shouldn't fail");
    })

    it('Test 2', function() {
        assert.ok(1 === 1, "This shouldn't fail");
        assert.ok(false, "This should fail");
    })
})

Pokud jste nenastavili možnosti testování jednotek ve vlastnostech projektu, musíte zajistit , aby vlastnost Test Framework v okně Vlastnosti byla nastavena na správnou testovací architekturu pro soubory testů jednotek. To se provádí automaticky pomocí šablon souborů testu jednotek.

Po otevření Průzkumníka testů (zvolte Test>>Windows Test Explorer), Visual Studio vyhledá a zobrazí testy. Pokud se testy nezobrazují na začátku, znovu sestavte projekt a aktualizujte seznam.

Spouštění testů (Node.js)

Testy můžete spouštět v sadě Visual Studio nebo z příkazového řádku.

Spouštění testů v sadě Visual Studio

Testy můžete spustit kliknutím na odkaz Spustit vše v Průzkumníku testů. Nebo můžete testy spustit tak, že vyberete jeden nebo více testů nebo skupin, kliknete pravým tlačítkem myši a v místní nabídce vyberete Spustit . Testy běží na pozadí a Průzkumník testů se automaticky aktualizuje a zobrazí výsledky. Vybrané testy můžete také ladit tak, že kliknete pravým tlačítkem myši a vyberete Ladit.

Pro TypeScript se testy jednotek spouští proti vygenerovanému kódu JavaScriptu.

Spuštění testů z příkazového řádku

Testy můžete spustit z příkazového řádku pro vývojáře pro Visual Studio pomocí následujícího příkazu:

vstest.console.exe <path to project file>\NodejsConsoleApp23.njsproj /TestAdapterPath:<VisualStudioFolder>\Common7\IDE\Extensions\Microsoft\NodeJsTools\TestAdapter

Tento příkaz zobrazuje výstup podobný následujícímu:

Microsoft (R) Test Execution Command Line Tool Version 15.5.0
Copyright (c) Microsoft Corporation.  All rights reserved.

Starting test execution, please wait...
Processing: NodejsConsoleApp23\NodejsConsoleApp23\UnitTest1.js
  Creating TestCase:NodejsConsoleApp23\NodejsConsoleApp23\UnitTest1.js::Test Suite 1 Test 1::mocha
  Creating TestCase:NodejsConsoleApp23\NodejsConsoleApp23\UnitTest1.js::Test Suite 1 Test 2::mocha
Processing finished for framework of Mocha
Passed   Test Suite 1 Test 1
Standard Output Messages:
 Using default Mocha settings
 1..2
 ok 1 Test Suite 1 Test 1

Failed   Test Suite 1 Test 2
Standard Output Messages:
 not ok 1 Test Suite 1 Test 2
   AssertionError [ERR_ASSERTION]: This should fail
       at Context.<anonymous> (NodejsConsoleApp23\NodejsConsoleApp23\UnitTest1.js:10:16)

Total tests: 2. Passed: 1. Failed: 1. Skipped: 0.
Test Run Failed.
Test execution time: 1.5731 Seconds