Утверждения

Добавляет в скрипт функционал "Утверждений" (assertions). Возможны 2 стиля использования:

Модуль "Утверждения" - утверждения в стиле фреймворка xUnitFor1C
Свойство глобального контекста "Ожидаем" - fluent-API утверждений в стиле BDD

Краткий пример

МояПеременная = ВычислитьЧтоТоТам(); 

// xUnit style        
Утверждения.ПроверитьРавенство(1, МояПеременная, "Моя переменная должна быть строго равна 1");

// BDD style
Ожидаем.Что(МояПеременная).Равно(1);

Модуль "Ожидаем"

BDD стиль предоставляет fluent API для создания более читаемых утверждений.

Базовый синтаксис

Ожидаем.Что(ПроверяемоеЗначение).МетодПроверки(ПараметрыПроверки);

Отрицание

`Не_()` / `ЭтоНе()`

Инвертирует результат следующей проверки.

Ожидаем.Что(Значение).Не_().Равно(0);
Ожидаем.Что(Строка).ЭтоНе().Заполнено();

Логические проверки

`ЭтоИстина()` / `ЕстьИстина()`

Проверяет, что значение равно Истина.

Ожидаем.Что(УсловиеВыполнено).ЭтоИстина();

`ЭтоЛожь()` / `ЕстьЛожь()`

Проверяет, что значение равно Ложь.

Ожидаем.Что(ОшибкаВозникла).ЭтоЛожь();

`Равно(ОжидаемоеЗначение)`

Проверяет равенство значений.

Ожидаем.Что(Результат).Равно(42);
Ожидаем.Что(Статус).Равно("Готов");

Числовые сравнения в BDD

`Больше(МеньшееЗначение)`

Проверяет, что значение больше указанного.

Ожидаем.Что(Количество).Больше(0);

`БольшеИлиРавно(МеньшееИлиРавноеЗначение)` / `Минимум(МинимальноеЗначение)`

Проверяет, что значение больше или равно указанному.

Ожидаем.Что(Возраст).БольшеИлиРавно(18);
Ожидаем.Что(Зарплата).Минимум(10000);

`Меньше(БольшееЗначение)`

Проверяет, что значение меньше указанного.

Ожидаем.Что(ВремяОтклика).Меньше(1000);

`МеньшеИлиРавно(БольшееИлиРавноеЗначение)` / `Максимум(МаксимальноеЗначение)`

Проверяет, что значение меньше или равно указанному.

Ожидаем.Что(Оценка).МеньшеИлиРавно(10);
Ожидаем.Что(Размер).Максимум(1024);

`Между(НачальноеЗначение, КонечноеЗначение)`

Проверяет, что значение находится в указанном диапазоне.

Ожидаем.Что(Процент).Между(0, 100);

Проверки существования и заполненности

`Заполнено()`

Проверяет, что значение заполнено.

Ожидаем.Что(НомерЗаказа).Заполнено();

`Существует()`

Проверяет, что значение не равно Неопределено и не равно Null.

Ожидаем.Что(НайденныйЭлемент).Существует();

`ЭтоНеопределено()` / `ЕстьНеопределено()`

Проверяет, что значение равно Неопределено.

Ожидаем.Что(НеинициализированнаяПеременная).ЭтоНеопределено();

`ЭтоNull()` / `ЕстьNull()`

Проверяет, что значение равно Null.

Ожидаем.Что(ПустаяСсылка).ЭтоNull();

Проверки типов в BDD

`ИмеетТип(ТипИлиИмяТипа)`

Проверяет соответствие типа значения ожидаемому.

Ожидаем.Что(МойОбъект).ИмеетТип("Структура");
Ожидаем.Что(СписокЗначений).ИмеетТип(Тип("Массив"));

Работа с коллекциями

`Содержит(ИскомоеЗначение)`

Проверяет содержание элемента в коллекции или подстроки в строке.

// Для строк
Ожидаем.Что(ТекстОшибки).Содержит("не найден");

// Для массивов
Ожидаем.Что(СписокФайлов).Содержит("config.json");

// Для структур/соответствий - проверяет значения
Ожидаем.Что(Настройки).Содержит("Администратор");

`ИмеетДлину(ОжидаемаяДлина)`

Проверяет длину строки или количество элементов в коллекции.

Ожидаем.Что(Пароль).ИмеетДлину(8);
Ожидаем.Что(МассивДанных).ИмеетДлину(5);

Проверки методов и исключений

`ИмеетМетод(ИмяМетода)`

Проверяет наличие метода у объекта.

Ожидаем.Что(МойОбъект).ИмеетМетод("ВыполнитьОбработку");

`Метод(ИмяМетода, ПараметрыМетода).ВыбрасываетИсключение(ФрагментИсключения)`

Проверяет, что вызов метода вызывает исключение.

Ожидаем.Что(КалькуляторОбъект).Метод("Разделить", Новый Массив).ВыбрасываетИсключение("деление на ноль");

Работа с таблицами значений

`РавнаТаблице(ОжидаемоеЗначение, СравнитьТолькоСТруктуру = Ложь)`

Сравнивает таблицы значений.

Ожидаем.Что(ПолученнаяТаблица).РавнаТаблице(ОжидаемаяТаблица);

`ИмеетРавнуюСтруктуруСТаблицей(ОжидаемоеЗначение)`

Сравнивает только структуру таблиц (колонки и их типы).

Ожидаем.Что(НоваяТаблица).ИмеетРавнуюСтруктуруСТаблицей(ШаблонТаблицы);

`СодержитСтрокуТаблицы(ОжидаемоеЗначение)`

Проверяет наличие строки с указанными значениями в таблице.

СтрокаПоиска = Новый Структура("Код, Наименование", "001", "Товар1");
Ожидаем.Что(ТаблицаТоваров).СодержитСтрокуТаблицы(СтрокаПоиска);

Модификаторы сравнения

`БезУчетаПорядкаСтрок()`

Игнорирует порядок строк при сравнении таблиц.

Ожидаем.Что(Таблица1).БезУчетаПорядкаСтрок().РавнаТаблице(Таблица2);

`БезУчетаПорядкаКолонок()`

Игнорирует порядок колонок при сравнении таблиц.

Ожидаем.Что(Таблица1).БезУчетаПорядкаКолонок().РавнаТаблице(Таблица2);

`БезУчетаИменКолонок()`

Игнорирует имена колонок при сравнении таблиц.

Ожидаем.Что(Таблица1).БезУчетаИменКолонок().РавнаТаблице(Таблица2);

`НеУчитыватьПорядокВМассиве()`

Игнорирует порядок элементов при сравнении массивов.

Ожидаем.Что(Массив1).НеУчитыватьПорядокВМассиве().РавноМассиву(Массив2);

Продвинутые сравнения

`Идентично(ОжидаемоеЗначение)`

Выполняет глубокое сравнение объектов (структур, массивов, таблиц).

Ожидаем.Что(СложнаяСтруктура).Идентично(ОжидаемаяСтруктура);

`РавноМассиву(ОжидаемоеЗначение)`

Сравнивает массивы с детальной диагностикой различий.

Ожидаем.Что(ПолученныйМассив).РавноМассиву(ОжидаемыйМассив);

`РавноСтруктуреИлиСоответствию(ОжидаемоеЗначение)`

Сравнивает структуры или соответствия с детальной диагностикой.

Ожидаем.Что(НастройкиСистемы).РавноСтруктуреИлиСоответствию(ОжидаемыеНастройки);

Цепочки утверждений

BDD стиль поддерживает цепочки утверждений для комплексных проверок:

Ожидаем.Что(Пользователь)
    .ИмеетТип("Структура")
    .Содержит("Администратор")
    .ИмеетДлину(3);

Ожидаем.Что(Таблица)
    .БезУчетаПорядкаСтрок()
    .БезУчетаПорядкаКолонок()
    .РавнаТаблице(ЭталонТаблица);

Модуль "Утверждения"

Основные проверки

`Проверить(Условие, ДопСообщениеОшибки = "")`

Проверяет, что условие истинно.

Утверждения.Проверить(Истина, "Условие должно быть истинным");

`ПроверитьИстину(Условие, ДопСообщениеОшибки = "")`

Синоним для Проверить(). Проверяет, что значение равно Истина.

Утверждения.ПроверитьИстину(ПолучитьБулевоЗначение());

`ПроверитьЛожь(Условие, ДопСообщениеОшибки = "")`

Проверяет, что значение равно Ложь.

Утверждения.ПроверитьЛожь(ПользовательНеАвторизован);

Сравнения значений

`ПроверитьРавенство(ПервоеЗначение, ВтороеЗначение, ДопСообщениеОшибки = "")`

Проверяет равенство двух значений.

Утверждения.ПроверитьРавенство(42, ПолучитьЧисло());
Утверждения.ПроверитьРавенство("Привет", ПолучитьСтроку());

`ПроверитьНеРавенство(ПервоеЗначение, ВтороеЗначение, ДопСообщениеОшибки = "")`

Проверяет неравенство двух значений.

Утверждения.ПроверитьНеРавенство("", ИмяПользователя);

Числовые сравнения

`ПроверитьБольше(Больше, Меньше, ДопСообщениеОшибки = "")`

Проверяет, что первое значение больше второго.

Утверждения.ПроверитьБольше(100, ПолученнаяСумма);

`ПроверитьБольшеИлиРавно(Больше, Меньше, ДопСообщениеОшибки = "")`

Проверяет, что первое значение больше или равно второму.

Утверждения.ПроверитьБольшеИлиРавно(0, КоличествоЭлементов);

`ПроверитьМеньше(ПроверяемоеЗначение1, ПроверяемоеЗначение2, СообщениеОбОшибке = "")`

Проверяет, что первое значение меньше второго.

Утверждения.ПроверитьМеньше(ВремяВыполнения, МаксимальноеВремя);

`ПроверитьМеньшеИлиРавно(ПроверяемоеЗначение1, ПроверяемоеЗначение2, СообщениеОбОшибке = "")`

Проверяет, что первое значение меньше или равно второму.

Утверждения.ПроверитьМеньшеИлиРавно(РазмерФайла, МаксимальныйРазмер);

Проверки заполненности

`ПроверитьЗаполненность(ПроверяемоеЗначение, ДопСообщениеОшибки = "")`

Проверяет, что значение заполнено (с помощью ЗначениеЗаполнено()).

Утверждения.ПроверитьЗаполненность(НомерДокумента);
Утверждения.ПроверитьЗаполненность(ДатаСоздания);

`ПроверитьНеЗаполненность(ПроверяемоеЗначение, ДопСообщениеОшибки = "")`

Проверяет, что значение не заполнено.

Утверждения.ПроверитьНеЗаполненность(ДатаУдаления);

Проверки типов

`ПроверитьТип(Значение, ТипИлиИмяТипа, ДопСообщениеОшибки = "")`

Проверяет соответствие типа значения ожидаемому типу.

Утверждения.ПроверитьТип(ПолученныйОбъект, "Структура");
Утверждения.ПроверитьТип(ПолученныйОбъект, Тип("Массив"));

Проверки дат

`ПроверитьДату(Дата, Период, ДопСообщениеОшибки = "")`

Проверяет, что дата входит в указанный период.

Период = Новый Структура("ДатаНачала, ДатаОкончания", НачалоДня(ТекущаяДата()), КонецДня(ТекущаяДата()));
Утверждения.ПроверитьДату(ДатаОперации, Период);

`ПроверитьРавенствоДатСТочностью2Секунды(Дата, Дата2, ДопСообщениеОшибки = "")`

Проверяет равенство дат с точностью до 2 секунд.

Утверждения.ПроверитьРавенствоДатСТочностью2Секунды(ВремяВыполнения, ОжидаемоеВремя);

Строковые проверки

`ПроверитьЧтоВСтрокеСодержатсяТолькоЦифры(ИсходнаяСтрока, ДопСообщениеОшибки = "")`

Проверяет, что строка содержит только цифры.

Утверждения.ПроверитьЧтоВСтрокеСодержатсяТолькоЦифры(Телефон);

`ПроверитьВхождение(Строка, ПодстрокаПоиска, ДопСообщениеОшибки = "")`

Проверяет, что строка содержит указанную подстроку.

Утверждения.ПроверитьВхождение(ОтветСервера, "success");

Проверки исключений и методов

`ПроверитьКодСОшибкой(Код, Ошибка, ДопСообщениеОшибки = "")`

Проверяет, что выполнение кода вызывает ошибку с указанным текстом.

Утверждения.ПроверитьКодСОшибкой("ВызватьИсключение ""Тестовая ошибка""", "Тестовая ошибка");

`ПроверитьМетодСуществует(Объект, ИмяМетода, ДопСообщениеОшибки = "")`

Проверяет наличие метода у объекта.

Утверждения.ПроверитьМетодСуществует(МойОбъект, "ВыполнитьОбработку");

GeezerVison

Latest commit

History

Folders and files

Repository files navigation

Утверждения

Краткий пример

Модуль "Ожидаем"

Базовый синтаксис

Отрицание

Не_() / ЭтоНе()

Логические проверки

ЭтоИстина() / ЕстьИстина()

ЭтоЛожь() / ЕстьЛожь()

Равно(ОжидаемоеЗначение)

Числовые сравнения в BDD

Больше(МеньшееЗначение)

БольшеИлиРавно(МеньшееИлиРавноеЗначение) / Минимум(МинимальноеЗначение)

Меньше(БольшееЗначение)

МеньшеИлиРавно(БольшееИлиРавноеЗначение) / Максимум(МаксимальноеЗначение)

Между(НачальноеЗначение, КонечноеЗначение)

Проверки существования и заполненности

Заполнено()

Существует()

ЭтоНеопределено() / ЕстьНеопределено()

ЭтоNull() / ЕстьNull()

Проверки типов в BDD

ИмеетТип(ТипИлиИмяТипа)

Работа с коллекциями

Содержит(ИскомоеЗначение)

ИмеетДлину(ОжидаемаяДлина)

Проверки методов и исключений

ИмеетМетод(ИмяМетода)

Метод(ИмяМетода, ПараметрыМетода).ВыбрасываетИсключение(ФрагментИсключения)

Работа с таблицами значений

РавнаТаблице(ОжидаемоеЗначение, СравнитьТолькоСТруктуру = Ложь)

ИмеетРавнуюСтруктуруСТаблицей(ОжидаемоеЗначение)

СодержитСтрокуТаблицы(ОжидаемоеЗначение)

Модификаторы сравнения

БезУчетаПорядкаСтрок()

БезУчетаПорядкаКолонок()

БезУчетаИменКолонок()

НеУчитыватьПорядокВМассиве()

Продвинутые сравнения

Идентично(ОжидаемоеЗначение)

РавноМассиву(ОжидаемоеЗначение)

РавноСтруктуреИлиСоответствию(ОжидаемоеЗначение)