Skip to content

Latest commit

 

History

History
145 lines (120 loc) · 12.9 KB

Базовые-утверждения.MD

File metadata and controls

145 lines (120 loc) · 12.9 KB

Плагин базовых утверждений

Обращение к плагину (пример)

Из кода шагов (BDD), запускаемых через bddRunner

Процедура МойШаг(...) Экспорт
  Утверждения = Ванесса.Плагин("БазовыеУтверждения");
  Утверждения.Проверить(успешно, "флаг успешно");
  Утверждения.ПроверитьРавенство(1, Таб.Количество(), "Таб.Количество()");
КонецПроцедуры

Из кода тестов (TDD), запускаемых через xddTestRunner

Перем КонтекстЯдра;
Перем Ожидаем;

Процедура Инициализация(КонтекстЯдраПараметр) Экспорт
  КонтекстЯдра = КонтекстЯдраПараметр;
  Утверждения = КонтекстЯдра.Плагин("БазовыеУтверждения");
КонецПроцедуры

Процедура ТестДолжен() Экспорт
  Утверждения.Проверить(успешно, "флаг успешно");
  Утверждения.ПроверитьРавенство(1, Таб.Количество(), "Таб.Количество()");
КонецПроцедуры

Использование

  1. Каждый из методов-утверждений работает по простой схеме:
  • если проверяемое условие выполняется, тогда метод просто завершает свою работу
  • а вот если условие не выполняется, тогда выбрасывается исключение со специальным текстом ошибки, который можно дополнительно детализировать с помощью доп.параметра ДопСообщениеОшибки
  1. В каждом из методов-утверждений есть специальный последний параметр по умолчанию ДопСообщениеОшибки = ""

В этом параметре можно передать специальный текст для большей детализации ошибочного сообщения и возможного поиска строки, вызвавшей ошибку, в своем коде.

Публичный интерфейс

  • Проверить ( Значение, ДопСообщениеОшибки = "" ) - проверить значение на равенство с Истина

  • ПроверитьИстину ( Значение, ДопСообщениеОшибки = "" ) - проверить значение на равенство с Истина

  • ПроверитьЛожь ( Значение, ДопСообщениеОшибки = "" ) - проверить значение на равенство с Ложь

  • ПроверитьРавенство ( _1, _2, ДопСообщениеОшибки = "" ) - проверить равенство 2-х значений

  • ПроверитьНеРавенство ( _1, _2, ДопСообщениеОшибки = "" ) - проверить неравенство 2-х значений

  • ПроверитьДату ( _Дата, _Период, ДопСообщениеОшибки = "" ) - проверить дату на вхождение в стандартный период

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

  • ПроверитьБольше ( _Больше, _Меньше, ДопСообщениеОшибки = "" ) - проверить, что первое значение больше, чем второе значение

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

  • ПроверитьМеньше ( _Меньше, _Больше, ДопСообщениеОшибки = "" ) - проверить, что первое значение меньше, чем второе значение

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

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

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

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

    • проверить, что тип значения совпадает с ожидаемым типом данного
    • в качестве типа можно передать как Тип, так и имя типа

  • ПроверитьВхождение ( строка, подстрокаПоиска, ДопСообщениеОшибки = "" ) - проверить, что строка из 2-го параметра является подстрокой 1-го параметра

  • ПроверитьВхождениеВКоллекцию(Элемент, Коллекция, ДопСообщениеОшибки = "") - проверить, что элемент входит в коллекцию

    • В качестве коллекции могут выступать
      • Массив,
      • Структура,
      • Соответствие,
      • ФиксированныйМассив,
      • ФиксированнаяСтруктура,
      • ФиксированноеСоответствие,
      • СписокЗначений

  • ПроверитьНаличиеОбъектаИБ ( ссылка, ДопСообщениеОшибки = "" ) - проверить, что в базе данных есть такая ссылка (выполняется попытка получить объект).

  • ПроверитьВалидностьЗапросаСКД( ТекстЗапроса, ДопСообщениеОшибки = "" ) - проверяется правильность запроса для СКД

  • ПроверитьВыполнилось ( СтрокаАлгоритм, ДопСообщениеОшибки = "" ) - проверяется возможность выполнения переданного алгоритма

    • Пример вызова: 
      ИмяОтчета = "ТестовыйОтчетСКДДляСравнениеСЭталоном";
Отчет = Отчеты[ИмяОтчета].Создать();
Параметры = Новый Структура;
Параметры.Вставить("Отчет", Отчет);
Параметры.Вставить("КомпоновщикНастроек");
юТест.ПроверитьВыполнилось(
  "Параметры.КомпоновщикНастроек = Параметры.Отчет.КомпоновщикНастроек", 
  Параметры, 
  "Ожидали, что компоновщик настроек будет получен, а это не так");
КомпоновщикНастроек = Параметры.КомпоновщикНастроек;

  • ПроверитьНеВыполнилось ( Знач СтрокаАлгоритм, ОжидаемоеОписаниеОшибки = Неопределено, Знач ДопСообщениеОшибки = "") - проверяется невозможность выполнения переданного алгоритма

    • ОжидаемоеОписаниеОшибки - подстрока подробного представления ошибки.
    • Пример вызова: 
      ИмяОтчета = "ТестовыйОтчетСКДДляСравнениеСЭталоном";
Отчет = Отчеты[ИмяОтчета].Создать();
Параметры = Новый Структура;
Параметры.Вставить("Отчет", Отчет);
Параметры.Вставить("КомпоновщикНастроек");
юТест.ПроверитьНеВыполнилось(
  "Параметры.КомпоновщикНастроек = Параметры.Отчет.КомпоновщикНастроек", 
  Параметры, 
  "Компоновщик настроек не получен", 
  "Ожидали,что компоновщик не удастся установить, но это не так");
КомпоновщикНастроек = Параметры.КомпоновщикНастроек;

  • ПроверитьМетодВыполнился ( Объект, ИмяМетода, Параметры = Неопределено, ДопСообщениеОшибки = "" ) - проверяется возможность выполнения метода объекта

    • Параметры - массив параметров метода.
    • Пример вызова: 
      Отчет = Отчеты[ "ТестовыйОтчетСКДДляСравнениеСЭталоном" ].Создать();
Параметры = Новый Массив;
Параметры.Вставить("КомпоновщикНастроек");
юТест.ПроверитьМетодВыполнился(
  Отчет, "Сформировать", Параметры, 
  "Ожидали, что компоновщик настроек будет получен, а это не так");

  • ПроверитьМетодНеВыполнился ( Объект, ИмяМетода, Параметры = Неопределено, Знач ОжидаемоеОписаниеОшибки = "", Знач ДопСообщениеОшибки = "" ) - проверяется невозможность выполнения метода объекта

    • Параметры - массив параметров метода.
    • ОжидаемоеОписаниеОшибки - подстрока подробного описания ошибки.

  • ПроверитьРавенствоФайлов ( ПутьФайла1, ПутьФайла2, ДопСообщениеОшибки = "", ПарамСравнениеФайлов = Неопределено, ПоказатьРазличия = Ложь) - проверяет равенство файлов

    • доступен только в толстом клиенте, т.к. работает через объект СравнениеФайлов.
    • ПарамСравнениеФайлов - структура с источником свойств объекта СравнениеФайлов.
    • ПоказатьРазличия - открывать ли окно демонстрации различий.