Make toBe matcher error message more helpful for objects and arrays

Author: rogeliog

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

@@ -232,27 +232,13 @@ Received:
 exports[`.toBe() fails for: [] and [] 1`] = `
 "<dim>expect(<red>received</><dim>).toBe(<green>expected</><dim>)
 
-Expected value to be (using ===):
-  <green>[]</>
-Received:
-  <red>[]</>
-
-Difference:
-
-<dim>Compared values have no visual difference."
+Looks like you wanted to test for object/array equity with strict \`toBe\` matcher. You probably need to use \`toEqual\` instead."
 `;
 
 exports[`.toBe() fails for: {"a": 1} and {"a": 1} 1`] = `
 "<dim>expect(<red>received</><dim>).toBe(<green>expected</><dim>)
 
-Expected value to be (using ===):
-  <green>{\\"a\\": 1}</>
-Received:
-  <red>{\\"a\\": 1}</>
-
-Difference:
-
-<dim>Compared values have no visual difference."
+Looks like you wanted to test for object/array equity with strict \`toBe\` matcher. You probably need to use \`toEqual\` instead."
 `;
 
 exports[`.toBe() fails for: {"a": 1} and {"a": 5} 1`] = `
@@ -277,14 +263,7 @@ Difference:
 exports[`.toBe() fails for: {} and {} 1`] = `
 "<dim>expect(<red>received</><dim>).toBe(<green>expected</><dim>)
 
-Expected value to be (using ===):
-  <green>{}</>
-Received:
-  <red>{}</>
-
-Difference:
-
-<dim>Compared values have no visual difference."
+Looks like you wanted to test for object/array equity with strict \`toBe\` matcher. You probably need to use \`toEqual\` instead."
 `;
 
 exports[`.toBe() fails for: 1 and 2 1`] = `

packages/jest-matchers/src/matchers.js

@@ -67,6 +67,18 @@ const matchers: MatchersObject = {
           `Received:\n` +
           `  ${printReceived(received)}`
       : () => {
+          if (
+            getType(received) === getType(expected) &&
+            (getType(received) === 'object' || getType(expected) === 'array') &&
+            equals(received, expected, [iterableEquality])
+          ) {
+            return (
+              matcherHint('.toBe') +
+              '\n\n' +
+              'Looks like you wanted to test for object/array equity with strict `toBe` matcher. You probably need to use `toEqual` instead.'
+            );
+          }
+
           const diffString = diff(expected, received, {
             expand: this.expand,
           });