1 /*
2  * Copyright 2023 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package androidx.glance.testing
18 
19 /** Provides an entry point into testing exposing methods to find glance nodes */
20 // Equivalent to "androidx.compose.ui.test.SemanticsNodeInteractionsProvider" from compose.
21 interface GlanceNodeAssertionsProvider<R, T : GlanceNode<R>> {
22     /**
23      * Finds a Glance node that matches the given condition.
24      *
25      * Any subsequent operation on its result will expect exactly one element found and will throw
26      * [AssertionError] if none or more than one element is found.
27      *
28      * @param matcher Matcher used for filtering
29      */
onNodenull30     fun onNode(matcher: GlanceNodeMatcher<R>): GlanceNodeAssertion<R, T>
31 
32     /**
33      * Finds all Glance nodes that matches the given condition.
34      *
35      * @param matcher Matcher used for filtering
36      */
37     fun onAllNodes(matcher: GlanceNodeMatcher<R>): GlanceNodeAssertionCollection<R, T>
38 }
39