Add e2e test for documented implementation

Author: eps1lon

e2e/__tests__/__snapshots__/customInlineSnapshotMatchers.test.ts.snap

@@ -0,0 +1,93 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`works with custom inline snapshot matchers 1`] = `
+FAIL __tests__/asynchronous.test.js
+  ✕ new async, inline snapshots
+  ✕ mismatching async, inline snapshots
+
+  ● new async, inline snapshots
+
+    expect(received).toMatchInlineSnapshot()
+
+    Snapshot name: \`new async, inline snapshots 1\`
+
+    New snapshot was not written. The update flag must be explicitly passed to write a new snapshot.
+
+    This is likely because this test is run in a continuous integration (CI) environment in which snapshots are not written by default.
+
+    Received: "result #1"
+
+      17 | 
+      18 | test('new async, inline snapshots', async () => {
+    > 19 |   await expect(async () => 'result #1').toMatchObservationInlineSnapshot();
+         |                                         ^
+      20 |   await expect(async () => 'result #2').toMatchObservationInlineSnapshot();
+      21 | });
+      22 | 
+
+      at Object.toMatchObservationInlineSnapshot (__tests__/asynchronous.test.js:19:41)
+
+  ● new async, inline snapshots
+
+    expect(received).toMatchInlineSnapshot()
+
+    Snapshot name: \`new async, inline snapshots 2\`
+
+    New snapshot was not written. The update flag must be explicitly passed to write a new snapshot.
+
+    This is likely because this test is run in a continuous integration (CI) environment in which snapshots are not written by default.
+
+    Received: "result #2"
+
+      18 | test('new async, inline snapshots', async () => {
+      19 |   await expect(async () => 'result #1').toMatchObservationInlineSnapshot();
+    > 20 |   await expect(async () => 'result #2').toMatchObservationInlineSnapshot();
+         |                                         ^
+      21 | });
+      22 | 
+      23 | test('mismatching async, inline snapshots', async () => {
+
+      at Object.toMatchObservationInlineSnapshot (__tests__/asynchronous.test.js:20:41)
+
+  ● mismatching async, inline snapshots
+
+    expect(received).toMatchInlineSnapshot(snapshot)
+
+    Snapshot name: \`mismatching async, inline snapshots 1\`
+
+    Snapshot: "result #?"
+    Received: "result #1"
+
+      22 | 
+      23 | test('mismatching async, inline snapshots', async () => {
+    > 24 |   await expect(async () => 'result #1').toMatchObservationInlineSnapshot(
+         |                                         ^
+      25 |     \`"result #?"\`,
+      26 |   );
+      27 |   await expect(async () => 'result #1').toMatchObservationInlineSnapshot(
+
+      at Object.toMatchObservationInlineSnapshot (__tests__/asynchronous.test.js:24:41)
+
+  ● mismatching async, inline snapshots
+
+    expect(received).toMatchInlineSnapshot(snapshot)
+
+    Snapshot name: \`mismatching async, inline snapshots 2\`
+
+    Snapshot: "result #?"
+    Received: "result #1"
+
+      25 |     \`"result #?"\`,
+      26 |   );
+    > 27 |   await expect(async () => 'result #1').toMatchObservationInlineSnapshot(
+         |                                         ^
+      28 |     \`"result #?"\`,
+      29 |   );
+      30 | });
+
+      at Object.toMatchObservationInlineSnapshot (__tests__/asynchronous.test.js:27:41)
+
+ › 4 snapshots failed.
+Snapshot Summary
+ › 4 snapshots failed from 1 test suite. Inspect your code changes or re-run jest with \`-u\` to update them.
+`;

e2e/__tests__/customInlineSnapshotMatchers.test.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {wrap} from 'jest-snapshot-serializer-raw';
+import {extractSummary} from '../Utils';
+import runJest from '../runJest';
+
+test('works with custom inline snapshot matchers', () => {
+  const {stderr} = runJest('custom-inline-snapshot-matchers', [
+    '--ci',
+    'asynchronous.test.js',
+  ]);
+
+  let {rest} = extractSummary(stderr);
+
+  rest = rest
+    .split('\n')
+    .filter(line => line.indexOf('at Error (native)') < 0)
+    .join('\n');
+
+  expect(wrap(rest)).toMatchSnapshot();
+});

e2e/custom-inline-snapshot-matchers/__tests__/asynchronous.test.js

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const {toMatchInlineSnapshot} = require('jest-snapshot');
+
+expect.extend({
+  async toMatchObservationInlineSnapshot(fn, ...args) {
+    this.error = new Error();
+    const result = await fn();
+
+    return toMatchInlineSnapshot.call(this, result, ...args);
+  },
+});
+
+test('new async, inline snapshots', async () => {
+  await expect(async () => 'result #1').toMatchObservationInlineSnapshot();
+  await expect(async () => 'result #2').toMatchObservationInlineSnapshot();
+});
+
+test('mismatching async, inline snapshots', async () => {
+  await expect(async () => 'result #1').toMatchObservationInlineSnapshot(
+    `"result #?"`,
+  );
+  await expect(async () => 'result #1').toMatchObservationInlineSnapshot(
+    `"result #?"`,
+  );
+});

e2e/custom-inline-snapshot-matchers/package.json

@@ -0,0 +1,5 @@
+{
+  "jest": {
+    "testEnvironment": "node"
+  }
+}