Jest: Несоответствие в документации и примерах

PR # 3172 обновил документацию, включив в нее новые ключевые слова .resolves и .rejects для выполнения утверждений на обещаниях.

Я заметил, что этот PR привел к некоторым несоответствиям в обновленном разделе обработки ошибок https://github.com/facebook/jest/blob/master/docs/TutorialAsync.md. Ниже приведен снимок экрана этого раздела:

1. Комментарии в верхней части теста по-прежнему относятся к try-catch , это несовместимо с кодом, содержащимся во фрагментах кода.
2. PR показывает только пример с .rejects который будет доступен только в Jest 20+. Об этом следует упомянуть в документации, чтобы избежать путаницы.
3. Люди, использующие старые версии Jest, не смогут использовать эту документацию. Я думаю, нам следует добавить объяснение использования try-catch для перехвата отклонения обещаний (которое было удалено в PR # 3172) для людей, использующих Jest 19 и ниже. Это может находиться рядом с текущими документами, используя .rejects .
4. Пример , содержащийся в ссылке examples/async ссылки на тестирование примеры , как это . В этих примерах по-прежнему используется механизм try-catch , что несовместимо с примерами кода, содержащимися в настоящее время в документации. Это еще одна причина, по которой мы должны добавить объяснение использования try-catch в этот раздел документации.