Documentation for Interactive Snapshot Update

CHANGELOG.md

@@ -34,6 +34,8 @@
   not generate additional (invalid) paths by prepending each ancestor of `cwd`
   to the absolute path. Additionally, this fixes functionality in Windows OS.
   ([#5398](https://github.com/facebook/jest/pull/5398))
+* `[doc]` Add information about Interactive Snapshot update
+  ([#5291](https://github.com/facebook/jest/pull/5291))
 
 ## jest 22.1.4
 
@@ -85,6 +87,9 @@
 * `[jest-cli]` Make Jest exit without an error when no tests are found in the
   case of `--lastCommit`, `--findRelatedTests`, or `--onlyChanged` options
   having been passed to the CLI
+* `[jest-cli]` Interactive Snapshot Update: allow to review and update
+  individual snapshot failure
+  ([#3831](https://github.com/facebook/jest/pull/3831))
 
 ### Fixes
 
@@ -113,9 +118,6 @@
   ([#5279](https://github.com/facebook/jest/pull/5279))
 * `[jest-config]` Fix breaking change in `--testPathPattern`
   ([#5269](https://github.com/facebook/jest/pull/5269))
-
-### Fixes
-
 * `[docs]` Document caveat with mocks, Enzyme, snapshots and React 16
   ([#5258](https://github.com/facebook/jest/issues/5258))
 

docs/SnapshotTesting.md

@@ -121,6 +121,20 @@ You can try out this functionality by cloning the
 [snapshot example](https://github.com/facebook/jest/tree/master/examples/snapshot),
 modifying the `Link` component, and running Jest.
 
+#### Interactive Updates
+
+The snapshots of one test file can be updated in the Jest watch mode:
+
+![](/jest/img/content/interactiveSnapshot.png)
+
+Once you enter the Interactive Snapshot Updates mode, Jest will walk you though
+the failed snapshots of one test file at a time and give you an opportunity to
+review the failed output.
+
+From here you can choose to update that snapshot or skip to the next:
+
+![](/jest/img/content/interactiveSnapshotUpdate.gif)
+
 ### Tests Should Be Deterministic
 
 Your tests should be deterministic. That is, running the same tests multiple

packages/jest-cli/src/__tests__/__snapshots__/snapshot_interactive_mode.test.js.snap

@@ -12,7 +12,7 @@ exports[`SnapshotInteractiveMode updateWithResults overlay handle progress UI 1`
 
 <bold>Watch Usage</>
 <dim> › Press </>u<dim> to update failing snapshots for this test.</>
-<dim> › Press </>s<dim> to skip the current snapshot.</>
+<dim> › Press </>s<dim> to skip the current test file.</>
 <dim> › Press </>q<dim> to quit Interactive Snapshot Update Mode.</>
 <dim> › Press </>Enter<dim> to trigger a test run.</>
 "

packages/jest-cli/src/snapshot_interactive_mode.js

@@ -54,7 +54,7 @@ export default class SnapshotInteractiveMode {
       this._testFilePaths.length > 1
         ? chalk.dim(' \u203A Press ') +
           's' +
-          chalk.dim(' to skip the current snapshot.')
+          chalk.dim(' to skip the current test file.')
         : '',
 
       chalk.dim(' \u203A Press ') +