test_find_widget

function test_find_widget(widget:Gtk.Widget, label_pattern:String, widget_type:GType):Gtk.Widget {
    // Gjs wrapper for gtk_test_find_widget()
}

This function will search the descendants of widget for a widget of type widget_type that has a label matching label_pattern next to it. This is most useful for automated GUI testing, e.g. to find the "OK" button in a dialog and synthesize clicks on it. However see test_find_label, test_find_sibling and test_widget_click for possible caveats involving the search of such widgets and synthesizing widget events.

Since 2.14

widget

Container widget, usually a GtkWindow.

label_pattern

Shell-glob pattern to match a label string.

widget_type

Type of a aearched for label sibling widget.

Returns

a valid widget if any is found or null.