Home/ Questions/Q 7522333
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-05-30T02:29:32+00:00

Why is it that every unit testing framework (that I know of) requires the

  • 0

Why is it that every unit testing framework (that I know of) requires the expected value in equality tests to always be the first argument:

Assert.AreEqual(42, Util.GetAnswerToLifeTheUniverseAndEverything());

assertEquals(42, Util.GetAnswerToLifeTheUniverseAndEverything());

etc.

I’m quite used to it now, but every coder I try to teach unit testing makes the mistake of reversing the arguments, which I understand perfectly. Google didn’t help, maybe one of the hard-core unit-testers here knows the answer?

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. Editorial Team

    It seems that most early frameworks used expected before actual (for some unknown reason though, dice roll perhaps?). Yet with programming languages development, and increased fluency of the code, that order got reversed. Most fluent interfaces usually try to mimic natural language and unit testing frameworks are no different.

    In the assertion, we want to assure that some object matches some conditions. This is the natural language form, as if you were to explain your test code you’d probably say

    “In this test, I make sure that computed value is equal to 5”

    instead of

    “In this test, I make sure that 5 is equal to computed value”.

    Difference may not be huge, but let’s push it further. Consider this:

    Assert.That(Roses, Are(Red));

    Sounds about right. Now:

    Assert.That(Red, Are(Roses));

    Hm..? You probably wouldn’t be too surprised if somebody told you that roses are red. Other way around, red are roses, raises suspicious questions. Yoda, anybody?

    That doesn't sound natural at all

    Yoda’s making an important point – reversed order forces you to think.

    It gets even more unnatural when your assertions are more complex:

    Assert.That(Forest, Has.MoreThan(15, Trees));

    How would you reverse that one? More than 15 trees are being had by forest?

    This claim (fluency as a driving factor for modification) is somehow reflected in the change that NUnit has gone through – originally (Assert.AreEqual) it used expected before actual (old style). Fluent extensions (or to use NUnit’s terminology, constraint based – Assert.That) reversed that order.

    • 0