---
title: "onSubspaceNodeWithTag"
description: "Finds a semantics node in the Subspace hierarchy identified by the provided test tag."
type: "function"
lastmod: "2026-06-18T10:32:52.443959Z"
---
## API Reference

### onSubspaceNodeWithTag

> Source set: Android

```kotlin
public fun AndroidComposeTestRule<*, *>.onSubspaceNodeWithTag(
    testTag: String
): SubspaceSemanticsNodeInteraction
```

Finds a semantics node in the Subspace hierarchy identified by the provided test tag.

This convenience function specifically searches for nodes within the Subspace hierarchy and does
not locate standard 2D compose elements. The search evaluates for an exact string match on the
test tag.

#### Parameters

| | |
| --- | --- |
| testTag | the specific tag string to search for within the hierarchy. |

#### Returns

| | |
| --- | --- |
|  | the `SubspaceSemanticsNodeInteraction` for the matched node. |

## Code Examples
### subspaceNodeMatcherProperties
```kotlin
public fun subspaceNodeMatcherProperties() {
    composeTestRule.setContent {
        Subspace {
            SpatialPanel(SubspaceModifier.width(100.dp).height(100.dp).testTag("myPanel")) {}
        }
    }
    // Check existence and exact spatial dimensions in DP using semantic matchers
    composeTestRule
        .onSubspaceNodeWithTag("myPanel")
        .assertExists()
        .assertPositionInRootIsEqualTo(0.dp, 0.dp, 0.dp)
        .assertWidthIsEqualTo(100.toDp())
        .assertHeightIsEqualTo(100.toDp())
}
```
### subspacePanelRenderedAndInteractive
```kotlin
public fun subspacePanelRenderedAndInteractive() {
    var count = 0
    composeTestRule.setContent {
        Subspace {
            SpatialPanel(SubspaceModifier.testTag("spatialPanel")) {
                Button(onClick = { count++ }) { Text("Increment") }
            }
        }
    }
    // Assert subspace node existence, position, and dimensions in the Spatial hierarchy
    composeTestRule
        .onSubspaceNodeWithTag("spatialPanel")
        .assertExists()
        .assertPositionInRootIsEqualTo(0.toDp(), 0.toDp(), 0.toDp())
    // Interact with the 2D Compose node nested within the Spatial container
    composeTestRule.onNodeWithText("Increment").performClick()
    composeTestRule.waitForIdle()
    // Verify outcomes
    assert(count == 1)
}
```