Microsoft.Testing.Platform-Exitcodes

Microsoft.Testing.Platform verwendet bekannte Exitcodes, um Testfehler oder App-Fehler zu kommunizieren. Exitcodes beginnen bei 0 und sind nicht negativ. Beachten Sie die folgende Tabelle, in der die verschiedenen Exitcodes und ihre entsprechenden Ursachen aufgeführt sind:

Exitcode	Details
0	Der Exitcode 0 gibt Erfolg an. Alle Tests, die für die Ausführung ausgewählt wurden, wurden abgeschlossen, und es gab keine Fehler.
1	Der Exitcode 1 gibt unbekannte Fehler an und fungiert als catch all-Parameter. Weitere Fehlerinformationen und Details finden Sie in der Ausgabe.
2	Mit dem Exitcode 2 wird angegeben, dass mindestens ein Testfehler aufgetreten ist.
3	Der Exitcode 3 gibt an, dass die Testsitzung abgebrochen wurde. Eine Sitzung kann beispielsweise mit STRG+C abgebrochen werden.
4	Der Exitcode 4 gibt an, dass das Setup von verwendeten Erweiterungen ungültig ist und die Testsitzung nicht ausgeführt werden kann.
5	Der Exitcode 5 gibt an, dass die an die Test-App übergebenen Befehlszeilenargumente ungültig sind.
6	Der Exitcode 6 gibt an, dass die Testsitzung ein nicht implementiertes Feature verwendet.
7	Der Exitcode 7 gibt an, dass eine Testsitzung nicht erfolgreich abgeschlossen werden konnte und wahrscheinlich abgestürzt ist. Es ist möglich, dass dies durch eine Testsitzung verursacht wurde, die über den Erweiterungspunkt eines Testcontrollers ausgeführt wurde.
8	Der Exitcode 8 gibt an, dass die Testsitzung keine Tests ausgeführt hat.
9	Der Exitcode 9 gibt an, dass gegen die Mindestausführungsrichtlinie für die ausgeführten Tests verstoßen wurde.
10	Der Exitcode 10 gibt an, dass der Testadapter, das Testframework „Testing.Platform“, MSTest, NUnit oder xUnit aus einem infrastrukturellen Grund, der nicht mit dem Test selbst zusammenhängt, Tests nicht ausführen konnte. Ein Beispiel ist die fehlgeschlagene Erstellung einer für Tests benötigten Fixture.
11	Der Beendigungscode 11 gibt an, dass der Testvorgang beendet wird, wenn abhängiger Prozess beendet wird.
12	Der Beendigungscode 12 gibt an, dass die Testsitzung nicht ausgeführt werden konnte, da der Client keine der unterstützten Protokollversionen unterstützt.

Informationen zum Aktivieren ausführlicher Protokollierung und Problembehandlung finden Sie unter "Microsoft.Testing.Platform Diagnostics"-Erweiterungen.

Ignorieren bestimmter Exitcodes

Microsoft.Testing.Platform ist standardmäßig streng ausgelegt, ermöglicht jedoch die Konfigurierbarkeit. Daher können Benutzer*innen entscheiden, welche Exitcodes ignoriert werden sollen (Exitcode 0 wird anstelle des ursprünglichen Exitcodes zurückgegeben).

Verwenden Sie die Befehlszeilenoption --ignore-exit-code oder die Umgebungsvariable TESTINGPLATFORM_EXITCODE_IGNORE, um bestimmte Exitcodes zu ignorieren. Das zulässige Format ist eine durch Semikolons getrennte Liste der zu ignorierenden Exitcodes (z. B --ignore-exit-code 2;3;8). Ein häufiges Szenario besteht darin, zu berücksichtigen, dass Testfehler nicht zu einem Nichtzero-Exitcode führen sollten (was dem Ignorieren von Exit-Code 2entspricht).