В докладе будет: - что такое F.I.R.S.T - организация кода приложения для повышения его тестируемости, поддерживаемости и производительности - какой тест-фреймворк выбрать для решения какой задачи? - какие виды тестирования бывают и за какие из них отвечают разработчики? - как тратить больше времени на код, а не на тесты - как и какие метрики тестирования собирать

1. Никита Галкин
Ezetech
Testing in Node.js World

2. Галкин
Никита
Люблю и умею:
▰ Node.js, OpenSource, TypeScript, Docker, AWS
▰ Распиливать монолиты на микросервисы
Верю:
▰ Проблем нужно решать на правильном уровне
▰ Сложности в людях, а не технологиях
▰ Идеи и решения надо “продавать”
Доклады:
▰ Spec driven development in Microservices
▰ Использовании TypeScript для Node.js приложений
▰ Best practices of Node.js use in production
Ссылки:
GitHub Twitter Facebook
2

3. 3
О чем этот доклад?

4. Какие проблемы?
▰ Что и как тестировать?
▰ Разные Node.js проекты требуют разного подхода. Какие и когда
применять?
▰ Как тестировать асинхронную логику?
▰ Как тратить на тесты меньше времени?
▰ Что тестировать разработчикам, а что тестировщикам?
4

5. 5
А зачем
тестировать?

6. Что бы не было
багов?

7. Не в багах дело.
Дело в людях.

8. Архитектура это компромисс
между требованиями и
имеющимся ресурсами.
Она показывает как команда
может договариваться.
Что скрывается за...
Тестирование это проверка
соответствия функционала
требованиям.
Оно показывает насколько
команда понимает результат
и умеет нести за него
ответственность.
8

9. Термины
9

10. Test:
▰Case
▰Suit
▰Status
▻Passed
▻Failed
▻Skipped
▰Coverage
Термины
Lib types:
▰ Run
▰Assert or Expectation
▰Spies
▰Stubs
▰Mocks
10

11. 11
Фреймворк это не только
набор библиотек, но и
философия

12. 12
Как тестировать?

13. Формула теста
Arrange-Act-Assert VS Given-When-Then
13

14. Формула теста
Arrange/Given – настройка всех зависимостей и
данных.
Act/When – запуск тестируемого кода.
Assert/Then – проверка, что получен ожидаемый
результат и/или произошел side-effect.
Cleanup – очистка состояния.
14

15. Без формулы
15
describe('Array', function() {
describe('#indexOf()', function() {
it('should return -1 when the value is not present', function() {
assert.equal(-1, [1,2,3].indexOf(4));
});
});
});

16. C формулой
16
describe('Array', function() {
describe('#indexOf()', function() {
it('should return -1 when the value is not present', function() {
// arrange
const arr = [1,2,3];
const el = 4;
// act
const index = arr.indexOf(el);
// assert
assert.equal(-1, index);
});
});
});

17. Виды Node.js кода
17

18. Виды Node.js кода
CLI – консольная утилита, например webpack, yo.
Package – npm пакет.
Script – пример, конфигурация для webpack.
Microservice – одна процесс-функция, например websocket.
Monolithic APP – сразу много процессов.
18

19. CLI tool
19
process.stdin Node.js process.stdout
System

20. DB
Boundaries
Business Logic
nginx
Микросервис

21. Рекомендация по структуре
Аналог Entity-Control-Boundary
/boundaries
/rest
smtp.js
/services
users.js
app.js
21

22. Виды тестирования
22

23. Unit
23
Integration
Component
E2E

24. Виды тестов
Unit – тестирование одного файла (класса).
Integration – тестирование взаимодействия кода.
Component – тестирование всего приложения.
End-to-end – тестирование всей системы.
Contract – тестирование контракта/интерфейса.
24

25. Когда применять
Unit – Business Logic.
Integration – Microservice.
Component – CLI.
End-to-end – Monolithic.
Contract – REST API, TypeScript definition.
25

26. Что применять
Unit – mocha+chai+sinon, jest.
Integration – nock, supertest, etc.
Component – spawn from child_process.
End-to-end – WebDriver for Browser or Custom Solution.
Contract – Abao, TypeScript.
nyc for code coverage.
26

27. Integration
27
const app = require('./../src/app');
const request = require('supertest');
describe('GET /ping', function (){
it('should return status 200', function (done) {
request(app)
.get('/ping')
.expect('Content-Type', /json/)
.expect(200, {response: 'success'}, done);
});
});

28. Component
28
describe('CLI', function () {
let messageCallback, errorCallback, closeCallback
function startCLI(commandOptions) {
let childProcess = require('child_process').spawn('path/to/cli', commandOptions)
childProcess.stdout.on('data', messageCallback)
childProcess.stderr.on('data', errorCallback)
childProcess.on('close', closeCallback)
return childProcess
}
it('should stopping gracefully', function(done) {
closeCallback = (code) => {
expect(code).to.equal(0)
done()
}
errorCallback = done
let cli = startCLI([`-f=example`])
setTimeout(() => cli.kill('SIGTERM'), 1000)
})
})

29. Одни тесты для
разных видов
тестирования?
NOCK_OFF

30. Contract
import StatusClient = require("tc-status-client");
const options = {
namespace: 'monitoring:status',
statusCheckInterval: 50
};
let client = new StatusClient(options);
client.register('example', () => true);
client.run();
client.terminate();
client.isRunning();
30
declare class StatusClient {
constructor(options?: {
namespace?: string;
statusCheckInterval?: number;
statusMessageTtl?: number;
blacklistedKeyPatterns?: RegExp[];
});
run(): StatusClient;
register(serviceName: string, serviceCheck: () => boolean):
StatusClient;
isRunning(): boolean;
terminate(): void;
}
declare module "tc-status-client" {
export = StatusClient;
}

31. 31
Все виды тестирования
можно писать на Node.js

32. F.I.R.S.T.
По мотивам книги “Чистый код”
32

33. БЫСТРОТА
Тесты должны выполняться
быстро.
Используйте стабы (stubs) и
моки (mock).
Запускайте тесты
параллельно с помощью ava
или jest.
Fast
33

34. Независимость
Результаты выполнения
одного теста не должны быть
входными данными для
другого.
Для создания состояния
используйте beforeEach.
Independent
beforeEach(function() {
return db.clear()
.then(function() {
return db.save([tobi, loki, jane]);
});
});
34

35. Повторяемость
Тесты должны давать
одинаковые результаты
независимо от среды
выполнения.
В крайнем случае
используйте skip
Repeatable
it('should write to log', function (done) {
// @todo Fix on travis file writing
if (process.env.TRAVIS) {
return this.skip()
}
// main logic ...
}
35

36. Очевидность
Тест либо прошел, либо не
прошел, либо не запускался.
Это должно быть легко
понятно любому
разработчику.
Self-Validating
36

37. Своевременность
Тесты должны создаваться
своевременно.
Потом никогда не наступит.
Timely
37
Пиши тесты

38. 38

39. That's All Folks!
@galk_in
39