Jest: Inconsistencia en los documentos y los ejemplos

PR # 3172 actualizó los documentos para incluir las nuevas palabras clave .resolves y .rejects para ejecutar afirmaciones en Promesas.

Noté que este PR introdujo algunas inconsistencias en la sección de Manejo de errores actualizada de https://github.com/facebook/jest/blob/master/docs/TutorialAsync.md. Hay una captura de pantalla de esta sección a continuación:

1. Los comentarios en la parte superior de la prueba aún se refieren a try-catch , esto es inconsistente con el código contenido en los fragmentos de código.
2. El PR solo muestra un ejemplo con .rejects que solo estará disponible en Jest 20+. Esto debe mencionarse en los documentos para evitar confusiones.
3. Las personas que utilizan versiones anteriores de Jest no podrán utilizar esta documentación. Creo que deberíamos volver a agregar la explicación sobre el uso de try-catch para detectar el rechazo de Promise (que se eliminó en PR # 3172) para las personas que usan Jest 19 y menos. Esto puede convivir con los documentos actuales usando .rejects .
4. El ejemplo contenido en el enlace examples/async enlaza con ejemplos de prueba como este . Estos ejemplos todavía usan el mecanismo try-catch , esto es inconsistente con los ejemplos de código que se encuentran actualmente en los documentos. Esta es otra razón por la que deberíamos volver a agregar la explicación del uso de try-catch a esta sección de los documentos.