Add snapshot version support

examples/react-native/__tests__/__snapshots__/Intro-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`renders correctly 1`] = `
 <View
   style={

examples/snapshot/__tests__/__snapshots__/Clock.react-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`renders correctly 1`] = `
 <p>
   1482363367.071

examples/snapshot/__tests__/__snapshots__/Link.react-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`changes the class when hovered 1`] = `
 <a
   className="normal"

integration_tests/__tests__/__snapshots__/console-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`console printing 1`] = `
 " PASS  __tests__/console-test.js
   ● Console

integration_tests/__tests__/__snapshots__/coverage_report-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`collects coverage only from specified files 1`] = `
 "----------|----------|----------|----------|----------|----------------|
 File      |  % Stmts | % Branch |  % Funcs |  % Lines |Uncovered Lines |

integration_tests/__tests__/__snapshots__/failures-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`throwing not Error objects 1`] = `
 Object {
   "rest": " FAIL  __tests__/throw-number-test.js

integration_tests/__tests__/__snapshots__/globals-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`basic test constructs 1`] = `
 " PASS  __tests__/basic-test-constructs-test.js
   ✓ it

integration_tests/__tests__/__snapshots__/snapshot-serializers-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`Snapshot serializers renders snapshot 1`] = `
 Object {
   "snapshot serializers works with default serializers 1": "

integration_tests/__tests__/__snapshots__/snapshot-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`Snapshot Validation deletes a snapshot when a test does removes all the snapshots 1`] = `
 "Test Suites: 3 passed, 3 total
 Tests:       7 passed, 7 total

integration_tests/__tests__/__snapshots__/stack_trace-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`Stack Trace does not print a stack trace for errors when --noStackTrace is given 1`] = `
 "Test Suites: 1 failed, 1 total
 Tests:       3 failed, 3 total

integration_tests/__tests__/__snapshots__/testNamePattern-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`testNamePattern 1`] = `
 "Test Suites: 1 passed, 1 total
 Tests:       2 skipped, 2 passed, 4 total

integration_tests/__tests__/__snapshots__/transform-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`babel-jest instruments only specific files and collects coverage 1`] = `
 "------------|----------|----------|----------|----------|----------------|
 File        |  % Stmts | % Branch |  % Funcs |  % Lines |Uncovered Lines |

integration_tests/__tests__/__snapshots__/typescript-coverage-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`instruments and collects coverage for typescript files 1`] = `
 "------------|----------|----------|----------|----------|----------------|
 File        |  % Stmts | % Branch |  % Funcs |  % Lines |Uncovered Lines |

integration_tests/__tests__/transform-test.js

@@ -98,7 +98,7 @@ describe('multiple-transformers', () => {
   });
 
   it('transforms dependencies using specific transformers', () => {
-    const {json, stderr} = runJest.json(dir, ['--no-cache']);
+    const {json, stderr} = runJest.json(dir, ['--no-cache', '-u']);
 
     expect(stderr).toMatch(/PASS/);
     expect(json.numTotalTests).toBe(1);

integration_tests/transform/multiple-transformers/__tests__/__snapshots__/multiple-transformers-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`generates a snapshot with correctly transformed dependencies 1`] = `
 <div
   className="App-root"

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

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`generates an empty coverage object for a file without running it 1`] = `
 Object {
   "b": Object {

packages/jest-cli/src/__tests__/__snapshots__/watch-filename-pattern-mode-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`Watch mode flows Pressing "P" enters pattern mode 1`] = `
 "
 

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

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`Watch mode flows Runs Jest once by default and shows usage 1`] = `
 Array [
   "

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

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`dims everything when there is no match 1`] = `"jest-cli/__tests__/watch-test.js"`;
 
 exports[`dims everything when there is no match 2`] = `"...t-cli/__tests__/watch-test.js"`;

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

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`trimAndFormatPath() does not trim anything 1`] = `"1234567890/1234567890/1234.js"`;
 
 exports[`trimAndFormatPath() split at the path.sep index 1`] = `".../1234.js"`;
@@ -8,9 +10,9 @@ exports[`trimAndFormatPath() trims dirname 1`] = `"...234567890/123
 
 exports[`trimAndFormatPath() trims dirname and basename 1`] = `"...1234.js"`;
 
-exports[`wrapAnsiString() returns the string unaltered if given a terminal width of zero 1`] = `"This string shouldn\'t cause you any trouble"`;
+exports[`wrapAnsiString() returns the string unaltered if given a terminal width of zero 1`] = `"This string shouldn't cause you any trouble"`;
 
-exports[`wrapAnsiString() returns the string unaltered if given a terminal width of zero 2`] = `"This string shouldn\'t cause you any trouble"`;
+exports[`wrapAnsiString() returns the string unaltered if given a terminal width of zero 2`] = `"This string shouldn't cause you any trouble"`;
 
 exports[`wrapAnsiString() wraps a long string containing ansi chars 1`] = `
 "abcde red-

packages/jest-config/src/__tests__/__snapshots__/normalize-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`Upgrade help logs a warning when \`scriptPreprocessor\` and/or \`preprocessorIgnorePatterns\` are used 1`] = `
 "● Deprecation Warning:
 

packages/jest-diff/src/__tests__/__snapshots__/diff-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`collapses big diffs to patch format 1`] = `
 "- Expected
 + Received

packages/jest-haste-map/src/__tests__/__snapshots__/index-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`HasteMap throws on duplicate module ids if "throwOnModuleCollision" is set to true 1`] = `
 [Error: jest-haste-map: @providesModule naming collision:
   Duplicate module name: Strawberry
@@ -8,7 +10,7 @@ This error is caused by a @providesModule declaration with the same name across
 
 exports[`HasteMap tries to crawl using node as a fallback 1`] = `
 "jest-haste-map: Watchman crawl failed. Retrying once with node crawler.
-  Usually this happens when watchman isn\'t running. Create an empty \`.watchmanconfig\` file in your project\'s root folder or initialize a git or hg repository in your project.
+  Usually this happens when watchman isn't running. Create an empty \`.watchmanconfig\` file in your project's root folder or initialize a git or hg repository in your project.
   Error: watchman error"
 `;
 

packages/jest-jasmine2/src/__tests__/__snapshots__/matchers-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`matchers proxies matchers to jest-matchers 1`] = `
 "expect(received).toBe(expected)
 

packages/jest-matcher-utils/src/__tests__/__snapshots__/index-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`.stringify() reduces maxDepth if stringifying very large objects 1`] = `"{\\"a\\": 1, \\"b\\": [Object]}"`;
 
 exports[`.stringify() reduces maxDepth if stringifying very large objects 2`] = `"{\\"a\\": 1, \\"b\\": {\\"0\\": \\"test\\", \\"1\\": \\"test\\", \\"2\\": \\"test\\", \\"3\\": \\"test\\", \\"4\\": \\"test\\", \\"5\\": \\"test\\", \\"6\\": \\"test\\", \\"7\\": \\"test\\", \\"8\\": \\"test\\", \\"9\\": \\"test\\"}}"`;

packages/jest-matchers/src/__tests__/__snapshots__/extend-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`is available globally 1`] = `"expected 15 to be divisible by 2"`;
 
 exports[`is ok if there is no message specified 1`] = `"No message was specified for this matcher."`;

packages/jest-matchers/src/__tests__/__snapshots__/matchers-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`.toBe() does not crash on circular references 1`] = `
 "expect(received).toBe(expected)
 

packages/jest-matchers/src/__tests__/__snapshots__/spyMatchers-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`lastCalledWith works only on spies or jest.fn 1`] = `
 "expect(jest.fn())[.not].lastCalledWith()
 

packages/jest-matchers/src/__tests__/__snapshots__/toThrowMatchers-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`.toThrow() error class did not throw at all 1`] = `
 "expect(function).toThrow(type)
 

packages/jest-message-util/src/__tests__/__snapshots__/messages-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`should exclude jasmine from stack trace for windows paths 1`] = `
 "  ● windows test
 

packages/jest-runtime/src/__tests__/__snapshots__/transform-test.js.snap

@@ -1,3 +1,5 @@
+// Jest Snapshot v1
+
 exports[`transform transforms a file properly 1`] = `
 "({\\"Object.<anonymous>\\":function(module,exports,require,__dirname,__filename,global,jest){/* istanbul ignore next */var cov_25u22311x4 = function () {var path = \\"/fruits/banana.js\\",hash = \\"04636d4ae73b4b3e24bf6fba39e08c946fd0afb5\\",global = new Function('return this')(),gcv = \\"__coverage__\\",coverageData = { path: \\"/fruits/banana.js\\", statementMap: { \\"0\\": { start: { line: 1, column: 0 }, end: { line: 1, column: 26 } } }, fnMap: {}, branchMap: {}, s: { \\"0\\": 0 }, f: {}, b: {}, _coverageSchema: \\"332fd63041d2c1bcb487cc26dd0d5f7d97098a6c\\" },coverage = global[gcv] || (global[gcv] = {});if (coverage[path] && coverage[path].hash === hash) {return coverage[path];}coverageData.hash = hash;return coverage[path] = coverageData;}();++cov_25u22311x4.s[0];module.exports = \\"banana\\";
 }});"

packages/jest-snapshot/src/State.js

@@ -48,7 +48,7 @@ class SnapshotState {
   ) {
     this._dirty = false;
     this._snapshotPath = snapshotPath || getSnapshotPath(testPath);
-    this._snapshotData = getSnapshotData(this._snapshotPath);
+    this._snapshotData = getSnapshotData(this._snapshotPath, update);
     this._uncheckedKeys = new Set(Object.keys(this._snapshotData));
     this._counters = new Map();
     this._index = 0;
@@ -83,7 +83,7 @@ class SnapshotState {
 
     const isEmpty = Object.keys(this._snapshotData).length === 0;
 
-    if ((this._dirty || this._uncheckedKeys.size) && !isEmpty) {
+    if ((this._dirty || this._uncheckedKeys.size || update) && !isEmpty) {
       saveSnapshotFile(this._snapshotData, this._snapshotPath);
       status.saved = true;
     } else if (isEmpty && fileExists(this._snapshotPath)) {

packages/jest-snapshot/src/__tests__/utils-test.js

@@ -9,17 +9,28 @@
 'use strict';
 
 const {
+  getSnapshotData,
   getSnapshotPath,
   keyToTestName,
   saveSnapshotFile,
   testNameToKey,
+  SNAPSHOT_VERSION,
 } = require('../utils');
 const fs = require('fs');
 const path = require('path');
 
 const writeFileSync = fs.writeFileSync;
-beforeEach(() => fs.writeFileSync = jest.fn());
-afterEach(() => fs.writeFileSync = writeFileSync);
+const readFileSync = fs.readFileSync;
+beforeEach(() => {
+  fs.writeFileSync = jest.fn();
+  fs.readFileSync = jest.fn();
+});
+afterEach(() => {
+  fs.writeFileSync = writeFileSync;
+  fs.readFileSync = readFileSync;
+});
+
+jest.mock('jest-file-exists', () => () => true);
 
 test('keyToTestName()', () => {
   expect(keyToTestName('abc cde 12')).toBe('abc cde');
@@ -49,7 +60,10 @@ test('saveSnapshotFile() works with \r\n', () => {
 
   saveSnapshotFile(data, filename);
   expect(fs.writeFileSync)
-    .toBeCalledWith(filename, 'exports[`myKey`] = `<div>\n</div>`;\n');
+    .toBeCalledWith(
+      filename,
+      '// Jest Snapshot v1\n\nexports[`myKey`] = `<div>\n</div>`;\n'
+    );
 });
 
 test('saveSnapshotFile() works with \r', () => {
@@ -60,15 +74,55 @@ test('saveSnapshotFile() works with \r', () => {
 
   saveSnapshotFile(data, filename);
   expect(fs.writeFileSync)
-    .toBeCalledWith(filename, 'exports[`myKey`] = `<div>\n</div>`;\n');
+    .toBeCalledWith(
+      filename,
+      '// Jest Snapshot v1\n\nexports[`myKey`] = `<div>\n</div>`;\n'
+    );
+});
+
+test('getSnapshotData() throws when no snapshot version', () => {
+  const filename = path.join(__dirname, 'old-snapshot.snap');
+  fs.readFileSync = jest.fn(() => 'exports[`myKey`] = `<div>\n</div>`;\n');
+  const update = false;
+
+  expect(() => getSnapshotData(filename, update)).toThrowError(
+    `Stored snapshot version is outdated.\n` +
+    `Expected: v${SNAPSHOT_VERSION}, but received: v0\n` +
+    `Update the snapshot to remove this error.`
+  );
+});
+
+test('getSnapshotData() throws for older snapshot version', () => {
+  const filename = path.join(__dirname, 'old-snapshot.snap');
+  fs.readFileSync = jest.fn(() =>
+    '// Jest Snapshot v0.99\n\nexports[`myKey`] = `<div>\n</div>`;\n'
+  );
+  const update = false;
+
+  expect(() => getSnapshotData(filename, update)).toThrowError(
+    `Stored snapshot version is outdated.\n` +
+    `Expected: v${SNAPSHOT_VERSION}, but received: v0.99\n` +
+    `Update the snapshot to remove this error.`
+  );
+});
+
+test('getSnapshotData() does not throw for when updating', () => {
+  const filename = path.join(__dirname, 'old-snapshot.snap');
+  fs.readFileSync = jest.fn(() =>
+    'exports[`myKey`] = `<div>\n</div>`;\n'
+  );
+  const update = true;
+
+  expect(() => getSnapshotData(filename, update)).not.toThrow();
 });
 
 test('escaping', () => {
   const filename = path.join(__dirname, 'escaping.snap');
   const data = '"\'\\';
   saveSnapshotFile({key: data}, filename);
   const writtenData = fs.writeFileSync.mock.calls[0][1];
-  expect(writtenData).toBe("exports[`key`] = `\"'\\\\`;\n");
+  expect(writtenData)
+    .toBe("// Jest Snapshot v1\n\nexports[`key`] = `\"'\\\\`;\n");
 
   // eslint-disable-next-line no-unused-vars
   const exports = {};