1. Имена тестов должны быть строками
Начать надо с того, что имя теста - это имя функции. В отличие от функций, мы не вызываем тесты из кода, имя теста нужно только для того чтобы один раз описать что он тестирует, чтобы это описание потом записалось в лог с результатами тестирования.
По этому в некоторых тестовых фреймворках имена тестов - это обычные строки.
Например в Catch (C++)
TEST_CASE("что-то когда такие-то условия") {
auto testee = Testee(1, 2);
REQUIRE(testee.foo() == 1);
}
Или Mocha (JS и прочие *script)
describe('что-то', function () {
it('когда такие-то условия', function () {
var testee = Testee(1, 2);
assert.equal(testee.foo(), 1);
});
});
Интересным исключением являются языки где идентификаторы могут иметь любые символы, как например в F#
[<Test>]
let ``twice удваивает числа`` () =
twice(1) |> should equal 2
2. Не надо повторяться (принцип DRY)
Если тестовый фреймворк позволяет группировать тесты, то это надо использовать. Вместо тестов Чтото_КогдаЭто_ВотЭто
, Чтото_КогдаДругое_ВотЭто
и Чтото_КогдаДругое_ЕщеИЭто
тесты можно сгруппировать.
Пример на Mocha/JS:
describe('что-то', function () {
var testee = Testee();
describe('когда так-то', function () {
it('вот это', function () {
testee.setup(1);
assert.equal(testee.f(), 1);
});
});
describe('когда по другому', function () {
testee.setup(2);
it('вот это', function () {
assert.equal(testee.f(), 20);
});
it('и еще это', function () {
assert.equal(testee.g(), 21);
});
});
});
Или для Catch/C++:
TEST_CASE("что-то") {
auto testee = Testee();
WHEN("когда так-то то вот это") {
testee.setup(1);
REQUIRE(testee.f() == 1);
}
WHEN("когда по другому") {
testee.setup(2);
THEN("вот это") {
REQUIRE(testee.f() == 20);
}
THEN("и еще это") {
REQUIRE(testee.g() == 21);
}
}
}
Также зачастую нет смысла повторять код теста в названии теста. Надо описывать что проверяет тест, а не как он это делает. По этому вместо StartButton_WhenPressed_BecomesDisabled можно написать
TEST_F(ButtonsPanelTest, StartButtonPress) {
EXPECT_CALL(delegate_mock, Start());
start_button.Press();
ASSERT_FALSE(start_button.IsEnabled());
}
Как правило тест включает в себя начальные условия (GIVEN/WHEN часть) и результаты (THEN часть). Если для каких-то начальных условий тест один, то не зачем писать в названии то что проверяется в THEN части. Это видно из кода, и если тест провалится, то текст проваленной проверки будет написан в логе.
Примеры имен тестов
Имена тестов зависят от тестового фреймворка и от уровня теста (юнит/интеграционный/регрессионный).
Регрессионные тесты на Mocha/JS
describe("File IO", function() {
it("can read text", function() {...})
it("invalid file name error", function() {...})
it("read after EOF error", function() {...})
})
Юнит-тесты на Catch/С++, когда в Catch использовались имена тестов разделенные /
TEST_CASE_METHOD(ParserFixture, "Notifications/Empty") {
SECTION("no 'type' field") {...}
SECTION("empty updates") {...}
}
TEST_CASE_METHOD(ParserFixture, "Notifications/Status update") {...}
TEST_CASE_METHOD(ParserFixture, "Notifications/Profile update") {...}
Более новые тесты Catch/C++, с тегами
TEST_CASE("request line", "[http][parser]") {...}
TEST_CASE_METHOD(FrameReceiverFixture, "is frame complete", "[websocket]") {...}
Тесты на gtest/C++ (из кода Chromium)
TEST_F(DownloadItemTest, CompleteDelegate_SetDanger) {...}
TEST_F(DownloadItemTest, NotificationAfterOnDownloadTargetDetermined) {...}
Тесты на Golang
func TestSomeClassMethod_CanDoThis(t *testing.T) {...}
Если имя теста нельзя задать строкой, то одновременное использование CamelCase и нижнего подчеркивания дает довольно неплохо повышает читабельность. Например вместо TEST_CASE("some unit") { WHEN("this state") { THEN("those results") { ...
можно написать SomeUnit_WhenThisState_ThoseResults
.