feat: widget finders add widgetWithImage method (#89020)

packages/flutter_test/lib/src/finders.dart

@@ -183,6 +183,30 @@ class CommonFinders {
     );
   }
 
+  /// Looks for widgets that contain an [Image] descendant displaying [ImageProvider]
+  /// `image` in it.
+  ///
+  /// ## Sample code
+  ///
+  /// ```dart
+  /// // Suppose you have a button with image in it:
+  /// Button(
+  ///   child: Image.file(filePath)
+  /// )
+  ///
+  /// // You can find and tap on it like this:
+  /// tester.tap(find.widgetWithImage(Button, FileImage(filePath)));
+  /// ```
+  ///
+  /// If the `skipOffstage` argument is true (the default), then this skips
+  /// nodes that are [Offstage] or that are from inactive [Route]s.
+  Finder widgetWithImage(Type widgetType, ImageProvider image, { bool skipOffstage = true }) {
+    return find.ancestor(
+      of: find.image(image),
+      matching: find.byType(widgetType),
+    );
+  }
+
   /// Finds widgets by searching for elements with a particular type.
   ///
   /// This does not do subclass tests, so for example

packages/flutter_test/test/finders_test.dart

@@ -16,6 +16,13 @@ void main() {
       ));
       expect(find.image(FileImage(File('test'), scale: 1.0)), findsOneWidget);
     });
+
+    testWidgets('finds Button widgets with Image', (WidgetTester tester) async {
+      await tester.pumpWidget(_boilerplate(
+          ElevatedButton(onPressed: null, child: Image(image: FileImage(File('test'), scale: 1.0)),)
+      ));
+      expect(find.widgetWithImage(ElevatedButton, FileImage(File('test'), scale: 1.0)), findsOneWidget);
+    });
   });
 
   group('text', () {