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

K dispozici jsou dva výstupní režimy:

• Normal, výstup obsahuje banner, hlásí úplná selhání testů, varovné zprávy a zapisuje souhrn provedení.

• Detailed, totéž jako Normal, ale také hlásí Passed testy.

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ň podrobnosti výstupu při vypisování výsledků testů. Platné hodnoty jsou Normal a Detailed. Výchozí hodnota je Normal.
--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	flaky: Řídí souhrn a seznam flaky testů pro testy, které projdou po opakování. Použít on nebo off; výchozí je on. Platí pro MSTest [Retry] a rozšíření opakování.

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.