# IntentMatchers

Artifact: [androidx.test.espresso:espresso-intents](https://developer.android.com/jetpack/androidx/releases/test-espresso) [View Source](https://cs.android.com/search?q=file:androidx/test/espresso/intent/matcher/IntentMatchers.java+class:androidx.test.espresso.intent.matcher.IntentMatchers)

*** ** * ** ***


```
@CheckReturnValue
class IntentMatchers
```

<br />

*** ** * ** ***

A collection of hamcrest matchers for matching `https://developer.android.com/reference/android/content/Intent.html` objects.

## Summary

| ### Public functions |
|---|---|
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#anyIntent()()` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#doesNotHaveExtraWithKey(org.hamcrest.Matcher<java.lang.String>)(keyMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#doesNotHaveExtraWithKey(java.lang.String)(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#doesNotHaveFlag(int)(flag: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#doesNotHaveFlags(int...)(flags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#doesNotHaveFlags(int)(flags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#filterEquals(android.content.Intent)(expectedIntent: https://developer.android.com/reference/android/content/Intent.html!)` Matches an intent if it `https://developer.android.com/reference/android/content/Intent.html#filterEquals(android.content.Intent)` the expected intent. |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasAction(org.hamcrest.Matcher<java.lang.String>)(actionMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasAction(java.lang.String)(action: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasCategories(org.hamcrest.Matcher<? extends java.lang.Iterable<? extends java.lang.String>>)(categoriesMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<(https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-iterable/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-iterable/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasCategories(java.util.Set<java.lang.String>)(categories: (https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-set/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-set/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasComponent(java.lang.String)(className: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` Returns a matcher that will only match intents targeted to a single class by using `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/ComponentNameMatchers#hasClassName(java.lang.String)`. |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasComponent(org.hamcrest.Matcher<android.content.ComponentName>)(componentMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/ComponentName.html!>!)` Can match an intent by class name, package name or short class name. |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasComponent(android.content.ComponentName)(componentName: https://developer.android.com/reference/android/content/ComponentName.html!)` Returns a matcher that will only match intents targeted to the componentName's class, {@see \* ComponentName#getClassName}. |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasData(org.hamcrest.Matcher<android.net.Uri>)(uriMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/net/Uri.html!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasData(java.lang.String)(uri: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasData(android.net.Uri)(uri: https://developer.android.com/reference/android/net/Uri.html!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasDataString(org.hamcrest.Matcher<java.lang.String>)(stringMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasExtra(org.hamcrest.Matcher<java.lang.String>,org.hamcrest.Matcher<?>)(keyMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>!, valueMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<*>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `<T> https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasExtra(java.lang.String,T)(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, value: T!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasExtra(java.lang.String,org.hamcrest.Matcher<?>)(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, valueMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<*>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasExtraWithKey(org.hamcrest.Matcher<java.lang.String>)(keyMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasExtraWithKey(java.lang.String)(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasExtras(org.hamcrest.Matcher<android.os.Bundle>)(bundleMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/os/Bundle.html!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasFlag(int)(flag: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasFlags(int...)(flags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasFlags(int)(flags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasPackage(org.hamcrest.Matcher<java.lang.String>)(packageMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasPackage(java.lang.String)(packageName: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasType(org.hamcrest.Matcher<java.lang.String>)(typeMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#hasType(java.lang.String)(type: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#isInternal()()` Matches an intent if its package is the same as the target package for the instrumentation test. |
| `java-static https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/Intent.html!>!` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/IntentMatchers#toPackage(java.lang.String)(packageName: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` Matches an intent based on the package of activity which can handle the intent. |

## Public functions

### anyIntent

```
java-static fun anyIntent(): Matcher<Intent!>!
```

### doesNotHaveExtraWithKey

```
java-static fun doesNotHaveExtraWithKey(keyMatcher: Matcher<String!>): Matcher<Intent!>
```

### doesNotHaveExtraWithKey

```
java-static fun doesNotHaveExtraWithKey(key: String): Matcher<Intent!>
```

### doesNotHaveFlag

```
java-static fun doesNotHaveFlag(flag: Int): Matcher<Intent!>!
```

### doesNotHaveFlags

```
java-static fun doesNotHaveFlags(flags: IntArray<Int>!): Matcher<Intent!>!
```

### doesNotHaveFlags

```
java-static fun doesNotHaveFlags(flags: Int): Matcher<Intent!>!
```

### filterEquals

```
java-static fun filterEquals(expectedIntent: Intent!): Matcher<Intent!>!
```

Matches an intent if it `https://developer.android.com/reference/android/content/Intent.html#filterEquals(android.content.Intent)` the expected intent.

### hasAction

```
java-static fun hasAction(actionMatcher: Matcher<String!>!): Matcher<Intent!>!
```

### hasAction

```
java-static fun hasAction(action: String!): Matcher<Intent!>!
```

### hasCategories

```
java-static fun hasCategories(categoriesMatcher: Matcher<(Mutable)Iterable<String!>!>!): Matcher<Intent!>!
```

### hasCategories

```
java-static fun hasCategories(categories: (Mutable)Set<String!>!): Matcher<Intent!>!
```

### hasComponent

```
java-static fun hasComponent(className: String!): Matcher<Intent!>!
```

Returns a matcher that will only match intents targeted to a single class by using `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/ComponentNameMatchers#hasClassName(java.lang.String)`. The input string must contain the package name + short class name. For example hasComponent("com.google.provider.NotePad").

| Parameters |
|---|---|
| `className: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | complete class path |

### hasComponent

```
java-static fun hasComponent(componentMatcher: Matcher<ComponentName!>!): Matcher<Intent!>!
```

Can match an intent by class name, package name or short class name.

| Parameters |
|---|---|
| `componentMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/content/ComponentName.html!>!` | can be the value of `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/ComponentNameMatchers#hasClassName(java.lang.String)`, `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/ComponentNameMatchers#hasPackageName(java.lang.String)` or `https://developer.android.com/reference/kotlin/androidx/test/espresso/intent/matcher/ComponentNameMatchers#hasShortClassName(java.lang.String)` |

### hasComponent

```
java-static fun hasComponent(componentName: ComponentName!): Matcher<Intent!>!
```

Returns a matcher that will only match intents targeted to the componentName's class, {@see \* ComponentName#getClassName}. For example: Intent intent = new Intent() .setComponentName(new ComponentName("com.google.provider", "com.google.provider.Notepad")); will match all intents targeted to Notepad.java.

| Parameters |
|---|---|
| `componentName: https://developer.android.com/reference/android/content/ComponentName.html!` | a componentName that has the target class specified |

### hasData

```
java-static fun hasData(uriMatcher: Matcher<Uri!>!): Matcher<Intent!>!
```

### hasData

```
java-static fun hasData(uri: String!): Matcher<Intent!>!
```

### hasData

```
java-static fun hasData(uri: Uri!): Matcher<Intent!>!
```

### hasDataString

```
java-static fun hasDataString(stringMatcher: Matcher<String!>!): Matcher<Intent!>!
```

### hasExtra

```
java-static fun hasExtra(keyMatcher: Matcher<String!>!, valueMatcher: Matcher<*>!): Matcher<Intent!>!
```

### hasExtra

```
java-static fun <T> hasExtra(key: String!, value: T!): Matcher<Intent!>!
```

### hasExtra

```
java-static fun hasExtra(key: String!, valueMatcher: Matcher<*>!): Matcher<Intent!>!
```

### hasExtraWithKey

```
java-static fun hasExtraWithKey(keyMatcher: Matcher<String!>!): Matcher<Intent!>!
```

### hasExtraWithKey

```
java-static fun hasExtraWithKey(key: String!): Matcher<Intent!>!
```

### hasExtras

```
java-static fun hasExtras(bundleMatcher: Matcher<Bundle!>!): Matcher<Intent!>!
```

### hasFlag

```
java-static fun hasFlag(flag: Int): Matcher<Intent!>!
```

### hasFlags

```
java-static fun hasFlags(flags: IntArray<Int>!): Matcher<Intent!>!
```

### hasFlags

```
java-static fun hasFlags(flags: Int): Matcher<Intent!>!
```

### hasPackage

```
java-static fun hasPackage(packageMatcher: Matcher<String!>!): Matcher<Intent!>!
```

### hasPackage

```
java-static fun hasPackage(packageName: String!): Matcher<Intent!>!
```

### hasType

```
java-static fun hasType(typeMatcher: Matcher<String!>!): Matcher<Intent!>!
```

### hasType

```
java-static fun hasType(type: String!): Matcher<Intent!>!
```

### isInternal

```
java-static fun isInternal(): Matcher<Intent!>!
```

Matches an intent if its package is the same as the target package for the instrumentation test.

### toPackage

```
java-static fun toPackage(packageName: String!): Matcher<Intent!>!
```

Matches an intent based on the package of activity which can handle the intent.

| Parameters |
|---|---|
| `packageName: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | packages of activity that can handle the intent |