Výstup terminálu

Reportér testu terminálu je integrovaná implementace hlášení o stavu a průběhu do terminálu (konzoly). Je součástí základní Microsoft. Testing.Platform (MTP) a nevyžaduje žádné další balíčky NuGet.

Výstupní režimy

MTP podporuje tyto výstupní režimy:

• Minimal hlásí neúspěšné bloky výsledků.

• Normal hlásí neúspěšné a přeskočené bloky výsledků. Obsahuje také banner, zprávy s upozorněním a souhrn spuštění.

• Detailed zobrazí všechny bloky výsledků.

Minimal je k dispozici ve verzi MTP 2.4 Preview.

organizace ANSI

Interně existují 2 různé výstupní formátovací moduly, které automaticky detekují schopnost terminálu zpracovávat řídicí kódy ANSI.

• Formátovací modul ANSI se používá, když terminál dokáže vykreslovat řídicí kódy.
• Formátovací modul, který není ANSI, se používá, když terminál nedokáže zpracovat řídicí kódy, kdy --no-ansi se používá nebo když je výstup přesměrován.

Výchozí možností je automatické zjišťování schopností.

Progress

Indikátor průběhu se zapíše do terminálu. Indikátor průběhu ukazuje počet úspěšných testů, neúspěšných testů a přeskočených testů, následovaný názvem testovaného sestavení, jeho cílovým rozhraním a architekturou.

Indikátor průběhu se zapíše na základě vybraného režimu:

• ANSI, indikátor průběhu je animovaný, drží se v dolní části obrazovky a aktualizuje se každých 500 ms. Indikátor průběhu se po dokončení provádění testu skryje.
• Pokud nejde o ANSI, indikátor průběhu se zapisuje na obrazovku každé 3 sekundy. Pokrok zůstává součástí výstupu.

Přímý výstup konzole a překreslování průběhu

Pokud chcete animovat indikátor průběhu, renderer průběhu ANSI převezme kontrolu nad kurzorem terminálu a opakovaně překreslí dolní část obrazovky. Jakýkoli text, který je zapsán přímo do stdout nebo stderr mimo mechanismus zachytávání testovacího frameworku, může být během tohoto překreslení přepsán nebo odstraněn. Například volání Console.WriteLine z kódu životního cyklu na úrovni sestavení nebo relace (například z hooku Before(Assembly) nebo Before(TestSession)) nebo z rozšíření může krátce probliknout a pak zmizet, když se ukazatel průběhu aktualizuje.

Toto chování se liší od zachyceného standardního výstupu a standardního chybového výstupu pro každý test. Výstup, který test vypisuje během běhu, je zachycován rámcem a zobrazován podle --show-stdout a --show-stderr, takže jej indikátor průběhu nepřepíše.

Pokud váš kód musí zapisovat přímo do konzoly a potřebujete, aby tento výstup zůstal viditelný, zakažte průběh (--progress off v MTP 2.3.0+ nebo --no-progress v dřívějších verzích). Případně zakažte ANSI (--ansi off v MTP 2.3.0+ nebo --no-ansi v dřívějších verzích); tím použijete ne‑ANSI výstup průběhu, který přidává nové řádky namísto překreslování na místě a nepřepisuje předchozí přímý výstup.

Možnosti

Možnost	Verze MTP	Description
--no-progress	—	Zakáže zobrazování průběhu na obrazovce. Zastarano v MTP 2.3.0 ve prospěch použití --progress off.
--progress	2.3.0	Určuje, jestli se zobrazuje průběh. Platné hodnoty jsou auto (výchozí), on (také přijímá true, enable, 1) a off (také přijímá false, disable, , 0).
--no-ansi	—	Zakáže výstup řídicích znaků ANSI na obrazovku.
--ansi	2.3.0	Určuje, zda jsou generovány řídicí znaky ANSI. Platné hodnoty jsou auto (výchozí), on (také přijímá true, enable, 1) a off (také přijímá false, disable, , 0).
--output	—	Určuje úroveň podrobností výstupu výsledků testů. Platné hodnoty jsou Minimal, Normala Detailed. Výchozí hodnota je Normal. Minimal vyžaduje MTP 2.4 Preview.
--show-test-results <OUTCOME>	2.4.0	Vybere bloky výsledků podle výsledku. Použijte passed, skipped, failed, all nebo none. failed zahrnuje také chyby, časové limity a zrušení.
--show-stdout	2.2.1	Určuje, kdy se má zobrazit zachycený standardní výstup testu. Platné hodnoty jsou All, Faileda None. Výchozí hodnota je All.
--show-stderr	2.2.1	Určuje, kdy se má zobrazit zachycený chybový výstup testu. Platné hodnoty jsou All, Faileda None. Výchozí hodnota je All.
--show-flaky-tests	2.4.0	Ovládá souhrn flaky: a seznam Flaky tests pro testy, které projdou po opakovaném spuštění. Použít on nebo off; výchozí je on. Platí pro MSTest [Retry] a rozšíření pro opakování.
--show-slowest-tests	2.4.0	Zobrazuje požadovaný počet nejpomalejších testů v souhrnu. Při spuštění s více moduly MTP hlásí nejpomalejší testy pro každý modul.

Kombinovat passed, faileda skipped s čárkami, mezerami nebo opakovanými --show-test-results možnostmi. Nekombinujte all ani none s jinou hodnotou. Explicitně zadaná hodnota --show-test-results přepíše předvolbu --output bez ohledu na pořadí voleb. Filtr mění pouze bloky výsledků; počty průběhu a souhrnů zůstávají beze změny.

Note

Pomlčka (—) ve sloupci verze MTP označuje základní možnosti, které nejsou svázané s konkrétní verzí, protože jsou k dispozici od počátečních verzí platformy.

Note

Od verze MTP 2.3.0, když MTP zjistí, že běží v prostředí nástroje LLM nebo AI, potlačí úvodní banner a změní výchozí nastavení --show-stdout a --show-stderr z All na Failed, aby omezil nadbytečný výstup.