feat: Enhance ByText error with selector (#1159)

raplemie · web-flow · commit d1a57dd9266c · 2022-10-08T11:43:36.000+02:00
diff --git a/src/__tests__/element-queries.js b/src/__tests__/element-queries.js
@@ -76,6 +76,15 @@ test('get throws a useful error message', () => {
       <div />
     </div>
   `)
+  expect(() => getByText('LucyRicardo', {selector: 'span'}))
+    .toThrowErrorMatchingInlineSnapshot(`
+    Unable to find an element with the text: LucyRicardo, which matches selector 'span'. This could be because the text is broken up by multiple elements. In this case, you can provide a function for your text matcher to make your matcher more flexible.
+
+    Ignored nodes: comments, script, style
+    <div>
+      <div />
+    </div>
+  `)
   expect(() => getByTestId('LucyRicardo')).toThrowErrorMatchingInlineSnapshot(`
     Unable to find an element by: [data-testid="LucyRicardo"]
 
@@ -1297,7 +1306,7 @@ test('ByText error message ignores not the same elements as configured in `ignor
   expect(() =>
     getByText('.css-selector', {selector: 'style', ignore: 'script'}),
   ).toThrowErrorMatchingInlineSnapshot(`
-    Unable to find an element with the text: .css-selector. This could be because the text is broken up by multiple elements. In this case, you can provide a function for your text matcher to make your matcher more flexible.
+    Unable to find an element with the text: .css-selector, which matches selector 'style'. This could be because the text is broken up by multiple elements. In this case, you can provide a function for your text matcher to make your matcher more flexible.
 
     Ignored nodes: comments, script, style
     <body>
diff --git a/src/queries/text.ts b/src/queries/text.ts
@@ -52,14 +52,17 @@ const getMissingError: GetErrorFunction<[Matcher, SelectorMatcherOptions]> = (
   text,
   options = {},
 ) => {
-  const {collapseWhitespace, trim, normalizer} = options
+  const {collapseWhitespace, trim, normalizer, selector} = options
   const matchNormalizer = makeNormalizer({collapseWhitespace, trim, normalizer})
   const normalizedText = matchNormalizer(text.toString())
   const isNormalizedDifferent = normalizedText !== text.toString()
+  const isCustomSelector = (selector ?? '*') !== '*'
   return `Unable to find an element with the text: ${
     isNormalizedDifferent
       ? `${normalizedText} (normalized from '${text}')`
       : text
+  }${
+    isCustomSelector ? `, which matches selector '${selector}'` : ''
   }. This could be because the text is broken up by multiple elements. In this case, you can provide a function for your text matcher to make your matcher more flexible.`
 }
 
