251

Is there a nicer way to write in jUnit

String x = "foo bar";
Assert.assertTrue(x.contains("foo"));
5
  • 11
    IMO this is nice enough, suggested options are less readable Oct 26, 2018 at 19:25
  • 10
    @TheGodfather less readable, but produce more meaningful assertion errors (ie, the accepted response will show the difference in strings, where as OPs solution will just show "False when expected True" on failure)
    – Mike
    Jun 12, 2019 at 22:57
  • 1
    What makes an assert "nicer" is the error message when it fails. How readable it is in the code is secondary to that, because you don't have to look at the code until it fails, and the failure message is the first thing you see.
    – rjmunro
    Mar 12, 2020 at 11:36
  • The question itself should be the accepted answer :D
    – d1Master
    May 5, 2022 at 14:32
  • @rjmunro You can pass your own message as an argument to assertTrue, like Assert.assertTrue("Should contain substring 'foo'", x.contains("foo"));
    – rook218
    Apr 13 at 13:25

12 Answers 12

376

If you add in Hamcrest and JUnit4, you could do:

String x = "foo bar";
Assert.assertThat(x, CoreMatchers.containsString("foo"));

With some static imports, it looks a lot better:

assertThat(x, containsString("foo"));

The static imports needed would be:

import static org.hamcrest.MatcherAssert.assertThat;
import static org.hamcrest.CoreMatchers.containsString;
9
  • 8
    Be sure you're using org.junit.Assert versus junit.framework.Assert, as the latter doesn't have the Hamcrest Matcher assertThat() Aug 8, 2012 at 17:09
  • 16
    I think when running JUnit 4.10, the class to use is org.junit.matchers.JUnitMatchers, e.g.: assertThat("something", JUnitMatchers.containsString("some")); Feb 21, 2013 at 13:04
  • 2
    The failure message for a failing assertThat is way more helpful then an assertTrue
    – Rylander
    Apr 1, 2013 at 15:04
  • 3
    static imports needed are import static org.junit.Assert.assertThat; import static org.hamcrest.CoreMatchers.containsString; - just to save someone from trouble
    – eis
    Aug 7, 2013 at 16:03
  • 5
    ... and org.hamcrest.Matchers.containsString; in the latest api, in the hamcrest-library dependency.
    – eis
    Nov 26, 2013 at 14:25
22

use fest assert 2.0 whenever possible EDIT: assertj may have more assertions (a fork)

assertThat(x).contains("foo");
2
  • I did not find a contains method with AssertJ.assertThat. This is what I found instead - org.assertj.core.api.Assertions.assertThat(conversionException).hasMessageContaining("some substring");
    – Raj
    Dec 5, 2018 at 1:18
  • sorry, I think my above comment does not suit to the context of this answer. I was on a different use case where I need to check for a substring within an exception message.
    – Raj
    Dec 5, 2018 at 1:24
11

Use hamcrest Matcher containsString()

// Hamcrest assertion
assertThat(person.getName(), containsString("myName"));

// Error Message
java.lang.AssertionError:
Expected: a string containing "myName"
     got: "some other name"

You can optional add an even more detail error message.

// Hamcrest assertion with custom error message
assertThat("my error message", person.getName(), containsString("myName"));

// Error Message
java.lang.AssertionError: my error message
Expected: a string containing "myName"
     got: "some other name"

Posted my answer to a duplicate question here

9

You can use assertj-fluent assertions. It has lot of capabilities to write assertions in more human readable - user friendly manner.

In your case, it would be

 String x = "foo bar";
 assertThat(x).contains("foo");

It is not only for the strings, it can be used to assert lists, collections etc.. in a friendlier way

7

Example (junit version- 4.13)

import static org.assertj.core.api.Assertions.assertThat;
import org.junit.Test;

public class TestStr {

@Test
public void testThatStringIsContained(){
    String testStr = "hi,i am a test string";
    assertThat(testStr).contains("test");
 }

}
2
  • This should be the accepted answer. Easiest and works
    – ajpieri
    Dec 21, 2020 at 18:15
  • Thanks @ajpieri. Dec 21, 2020 at 21:02
5

Use the new assertThat syntax together with Hamcrest.

It is available starting with JUnit 4.4.

5

It's too late, but just to update I got it done with below syntax

import org.hamcrest.core.StringContains;
import org.junit.Assert;

Assert.assertThat("this contains test", StringContains.containsString("test"));
2

Another variant is

Assert.assertThat(actual, new Matches(expectedRegex));

Moreover in org.mockito.internal.matchers there are some other interesting matchers, like StartWith, Contains etc.

2

assertj variant

import org.assertj.core.api.Assertions;
Assertions.assertThat(actualStr).contains(subStr);
1

I wrote this utility method

public static void assertContains(String string, String subString) {
    Assertions.assertTrue(string.contains(subString));
}
0

I've tried out many answers on this page, none really worked:

  • org.hamcrest.CoreMatchers.containsString does not compile, cannot resolve method.
  • JUnitMatchers.containsString is depricated (and refers to CoreMatchers.containsString).
  • org.hamcrest.Matchers.containsString: NoSuchMethodError

So instead of writing readable code, I decided to use the simple and workable approach mentioned in the question instead.

Hopefully another solution will come up.

0

The previous answers are fairly good if you are able and willing to add external libraries. For various reasons, this might not be the case. If you can't/don't want to add another dependency to your project, or if you just want to keep hamcrest at arms length, you could use the parts of hamcrest that come with JUnit.

For example, org.hamcrest.BaseMatcher and org.hamcrest.Matcher come with JUnit 4.10. One implementation could be:

public class StringMatchers {
    public static Matcher<String> contains(String expected) {
        return new BaseMatcher<String>() {
            @Override
            public boolean matches(Object actual) {
                String act = (String) actual;
                
                return act.contains(expected);
            }

            @Override
            public void describeTo(Description desc) {
                desc.appendText("should contain ").appendValue(expected);
            }
        };
    }
}

and then you can import it into other test files with import static <package>.StringMatchers.contains. This will leave you with the statement:

assertThat(x, contains(y));

PS. This is suspiciously similar to other libraries, so I would be surprised if they were implemented much different.

src: https://programmingideaswithjake.wordpress.com/2014/11/08/advanced-creation-of-hamcrest-matchers/ **not everything in here works!

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.