Jest: Inkonsistenz in den Dokumenten und den Beispielen

PR #3172 hat die Dokumentation aktualisiert, um die neuen Schlüsselwörter .resolves und .rejects zum Ausführen von Assertions auf Promises aufzunehmen.

Mir ist aufgefallen, dass diese PR einige Inkonsistenzen im aktualisierten Abschnitt zur Fehlerbehandlung von

1. Die Kommentare am Anfang des Tests beziehen sich immer noch auf try-catch , dies steht im Widerspruch zu dem Code, der in den Codeschnipseln enthalten ist.
2. Die PR zeigt nur ein Beispiel mit .rejects welches nur in Jest 20+ verfügbar sein wird. Dies sollte in den Dokumenten erwähnt werden, um Verwirrung zu vermeiden.
3. Personen, die ältere Versionen von Jest verwenden, können diese Dokumentation nicht verwenden. Ich denke, wir sollten die Erklärung über die Verwendung von try-catch hinzufügen, um die Ablehnung von Versprechen (die in PR #3172 entfernt wurde) für Leute, die Jest 19 und darunter verwenden, abzufangen. Dies kann neben den aktuellen Dokumenten mit .rejects .
4. Das im Link examples/async Beispiel verlinkt auf Testbeispiele wie dieses . Diese Beispiele verwenden immer noch den try-catch Mechanismus, dies steht im Widerspruch zu den derzeit in den Dokumenten enthaltenen Codebeispielen. Dies ist ein weiterer Grund, warum wir diesem Abschnitt der Dokumentation die Erklärung zur Verwendung von try-catch hinzufügen sollten.