From 0b5adaa9841edb48f6b7011fe36bdb6b43318acf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=9A=D0=BE=D1=80=D1=8F=D0=BA=D0=B8=D0=BD=20=D0=90=D0=BB?= =?UTF-8?q?=D0=B5=D0=BA=D1=81=D0=B5=D0=B9?= Date: Sun, 27 Oct 2024 14:50:14 +0300 Subject: [PATCH] =?UTF-8?q?doc:=20=D1=81=D0=BA=D0=BE=D1=80=D1=80=D0=B5?= =?UTF-8?q?=D0=BA=D1=82=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D1=8B=20=D0=BE?= =?UTF-8?q?=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D1=8F=20=D1=83=D1=82=D0=B2?= =?UTF-8?q?=D0=B5=D1=80=D0=B6=D0=B4=D0=B5=D0=BD=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../CommonModules/ЮТУтверждения/Module.bsl | 863 +++++++++++++----- 1 file changed, 615 insertions(+), 248 deletions(-) diff --git a/exts/yaxunit/src/CommonModules/ЮТУтверждения/Module.bsl b/exts/yaxunit/src/CommonModules/ЮТУтверждения/Module.bsl index ee8f76c5..a5667fe9 100644 --- a/exts/yaxunit/src/CommonModules/ЮТУтверждения/Module.bsl +++ b/exts/yaxunit/src/CommonModules/ЮТУтверждения/Module.bsl @@ -20,20 +20,21 @@ // Инициализирует модуль для проверки утверждений. // -// * Запоминает проверяемое значение. -// * Запоминает описание. -// * Сбрасывает настройки предыдущих утверждений. -// -// Утверждения формируются методами этого модуля. +// * Устанавливает новый контекст утверждений. +// * Запоминает проверяемое значение и описание проверки. +// * Сбрасывает предыдущие настройки контекста утверждений. // // Параметры: -// ПроверяемоеЗначение - Произвольный - Проверяемое фактическое значение -// Сообщение - Строка - Описание проверки, которое будет выведено при возникновении ошибки +// ПроверяемоеЗначение - Произвольный - Проверяемое фактическое значение. +// Сообщение - Строка - Описание проверки, которое будет выведено при возникновении ошибки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания -// Примеры -// ЮТУтверждения.Что(...).ЭтоИстина(...); +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение, "Проверка значения") +// .ЭтоИстина() +// ; // Функция Что(Знач ПроверяемоеЗначение, Знач Сообщение = "") Экспорт @@ -50,14 +51,22 @@ КонецФункции // Запоминает описание метода (имя и параметры) для последующей проверки. +// Используется для проверки выполнения метода, совместно с методами +// см. ВыбрасываетИсключение и см. НеВыбрасываетИсключение. // // Параметры: -// ИмяМетода - Строка - Наименование метода -// ПараметрыМетода - Массив из Произвольный - Параметры вызываемого метода. -// В качестве конструктора параметров можно использовать см. ЮТМетоды.МассивПараметров +// ИмяМетода - Строка - Наименование метода объекта (или его свойство), указанного при инициализации. +// ПараметрыМетода - Массив из Произвольный - Параметры, с которыми будет вызываться метод. +// Можно использовать конструктор параметров см. ЮТМетоды.МассивПараметров. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Объект) +// .Метод("Записать", ЮТМетоды.МассивПараметров(РежимЗаписиДокумента.Проведение)) +// .ВыбрасываетИсключение("Какая-то ошибка проведения") +// ; Функция Метод(Знач ИмяМетода, Знач ПараметрыМетода = Неопределено) Экспорт Контекст = Контекст(); @@ -73,13 +82,22 @@ КонецФункции -// Добавляет параметр метода для последующего вызова метода и проверки. +// Добавляет параметр метода (см. Метод) для последующего вызова метода и проверки. +// +// * Сохраняет переданное значение как параметр для дальнейшего использования при вызове метода. +// * Позволяет добавлять параметры последовательно. // // Параметры: -// ЗначениеПараметра - Произвольный - Параметр вызываемого метода +// ЗначениеПараметра - Произвольный - Параметр вызываемого метода. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Объект) +// .Метод("Записать").Параметр(РежимЗаписиДокумента.Проведение).Параметр(РежимПроведенияДокумента.Оперативный) +// .ВыбрасываетИсключение("Какая-то ошибка проведения") +// ; Функция Параметр(Знач ЗначениеПараметра) Экспорт Контекст = Контекст(); @@ -98,13 +116,17 @@ КонецФункции -// Устанавливает описание проверяемого объекта. +// Запоминает переданное представление объекта для использования в сообщениях об ошибках. // // Параметры: -// Представление - Строка - Представление +// Представление - Строка - Текстовое представление проверяемого объекта. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДвиженияДокумента).ИмеющееПредставление("Движения документа") +// .Заполнено(); Функция ИмеющееПредставление(Представление) Экспорт Контекст().ОбъектПроверки.Представление = Представление; @@ -112,18 +134,24 @@ КонецФункции -// Проверяет наличие свойства и запоминает его для последующих проверок. +// Проверяет наличие свойства и запоминает его для последующих проверок указанного свойства. // -// Важно, следующие проверки будут относится к этому свойству. +// Важно, что следующие проверки будут относиться к этому свойству. // Для переключения на проверки объекта можно воспользоваться методом см. Объект. // // Параметры: // ИмяСвойства - Строка - Наименование свойства объекта. -// Возможно обращение к вложенным свойствам через точку -// ОписаниеПроверки - Строка - Описание конкретной проверки +// Возможно обращение к вложенным свойствам через точку, а к элементам коллекций по индексу `[0]`. +// ОписаниеПроверки - Строка - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Движения) +// .Свойство("Остатки").Заполнено() +// .Свойство("Остатки[0].Номенклатура").Равно(Номенклатура) +// ; Функция Свойство(Знач ИмяСвойства, Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -144,11 +172,16 @@ // // Параметры: // ИмяСвойства - Строка - Наименование свойства объекта. -// Возможно обращение к вложенным свойствам через точку +// Возможно обращение к вложенным свойствам через точку // ОписаниеПроверки - Строка - Описание конкретной проверки // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Движения) +// .НетСвойства("Взаиморасчеты") +// ; Функция НетСвойства(Знач ИмяСвойства, Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -165,15 +198,22 @@ // Проверяет наличие элемента с указанным индексом и позиционируется на нем для последующих проверок. // -// Важно, следующие проверки будут относится к этому элементу. +// Важно, что следующие проверки будут относиться к этому элементу. // Для переключения на проверки объекта можно воспользоваться методом см. Объект. // +// Это алиас метода см. Свойство +// // Параметры: -// Индекс - Число - Индекс элемента коллекции -// ОписаниеПроверки - Строка - Описание конкретной проверки +// Индекс - Число - Индекс элемента коллекции. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Движения.Остатки) +// .Элемент(1).Равно(ОжидаемаяСтрокаДвижений) +// ; Функция Элемент(Знач Индекс, Знач ОписаниеПроверки = Неопределено) Экспорт Возврат Свойство(Индекс, ОписаниеПроверки); @@ -182,8 +222,16 @@ // Используется после вызова метода см. Свойство, для переключения с ранее указанного свойства на объект. // +// Этот метод позволяет продолжить проверки на уровне объекта, после того как была выполнена проверка его свойств. +// // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Движения) +// .Свойство("[0]Контрагент").Равно(Контрагент") +// .Объект().ИмеетДлину(1) +// ; Функция Объект() Экспорт Контекст = Контекст(); @@ -195,17 +243,23 @@ #Область УтвержденияПредикатов -// Проверяет установленное значение Контекста (или его свойство) на равенство ожидаемому. +// Проверяет установленное значение (или его свойство) на равенство ожидаемому. // // При сравнении также проверяется совпадение типов проверяемого и ожидаемого значения. -// Для сериализуемых объектов проверяется равенство по значению. +// Реализовано сравнение не только примитивных значений, но и структур, массивов, таблиц и прочего. +// Для сериализуемых объектов проверяется равенство по сериализованной форме. // // Параметры: -// ОжидаемоеЗначение - Произвольный - Ожидается, что значение Контекста (или его свойство) равно этому значению -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Произвольный - Ожидается, что значение (или его свойство) равно этому значению. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .Равно(5, "Проверка на равенство ожидаемому значению 5") +// ; Функция Равно(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт ПараметрыСравнения = Новый Структура("ГлубокийАнализ", Истина); @@ -214,17 +268,23 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на НЕ равенство ожидаемому. +// Проверяет установленное значение (или его свойство) на НЕ равенство ожидаемому. // -// При сравнении также проверяется совпадение типов проверяемого и ожидаемого значения -// Для сериализуемых значений проверяется равенство по значению +// При сравнении также проверяется совпадение типов проверяемого и ожидаемого значения. +// Реализовано сравнение не только примитивных значений, но и структур, массивов, таблиц и прочего. +// Для сериализуемых объектов проверяется равенство по сериализованной форме // // Параметры: -// ОжидаемоеЗначение - Произвольный - Ожидается, что значение Контекста (или его свойство) НЕ равно этому значению -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Произвольный - Ожидается, что установленное значение (или его свойство) НЕ равно этому значению. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .НеРавно(10, "Проверка на неравенство ожидаемому значению 10") +// ; Функция НеРавно(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт ПараметрыСравнения = Новый Структура("ГлубокийАнализ", Истина); @@ -233,14 +293,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство), оно должно быть больше ожидаемого. +// Проверяет установленное значение (или его свойство), оно должно быть больше ожидаемого. // // Параметры: -// ОжидаемоеЗначение - Произвольный - Ожидается, что значение Контекста (или его свойство) Больше этого значения -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Произвольный - Ожидается, что установленное значение (или его свойство) больше этого значения. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .Больше(0, "Проверка, что значение больше 0") +// ; Функция Больше(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().Больше, ОжидаемоеЗначение, ОписаниеПроверки); @@ -248,14 +313,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство), оно должно быть больше или равно ожидаемому. +// Проверяет установленное значение (или его свойство), оно должно быть больше или равно ожидаемому. // // Параметры: -// ОжидаемоеЗначение - Произвольный - Ожидается, что значение Контекста (или его свойство) Больше этого значения или равно ему -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Произвольный - Ожидается, что установленное значение (или его свойство) больше или равно указанному. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .БольшеИлиРавно(10, "Проверка, что значение больше или равно 10") +// ; Функция БольшеИлиРавно(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().БольшеРавно, ОжидаемоеЗначение, ОписаниеПроверки); @@ -263,14 +333,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство), оно должно быть меньше ожидаемого. +// Проверяет установленное значение (или его свойство), оно должно быть меньше ожидаемого. // // Параметры: -// ОжидаемоеЗначение - Произвольный - Ожидается, что значение Контекста (или его свойство) меньше этого значения -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Произвольный - Ожидается, что установленное значение (или его свойство) меньше этого значения. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .Меньше(100, "Проверка, что значение меньше 100") +// ; Функция Меньше(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().Меньше, ОжидаемоеЗначение, ОписаниеПроверки); @@ -278,14 +353,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство), оно должно быть меньше или равно ожидаемому. +// Проверяет установленное значение (или его свойство), оно должно быть меньше или равно ожидаемому. // // Параметры: -// ОжидаемоеЗначение - Произвольный - Ожидается, что значение Контекста (или его свойство) меньше этого значения или равно ему -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Произвольный - Ожидается, что установленное значение (или его свойство) меньше этого значения или равно ему. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Контекст) +// .МеньшеИлиРавно(50, "Проверка, что значение меньше или равно 50") +// ; Функция МеньшеИлиРавно(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().МеньшеРавно, ОжидаемоеЗначение, ОписаниеПроверки); @@ -293,13 +373,18 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на "заполненность" (обертка для `ЗначениеЗаполнено`). +// Проверяет установленное значение (или его свойство) на "заполненность" (обертка для `ЗначениеЗаполнено`). // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .Заполнено("Проверка, что значение заполнено") +// ; Функция Заполнено(Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().Заполнено, , ОписаниеПроверки); @@ -307,13 +392,18 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на "не заполненность" (обертка для `ЗначениеЗаполнено`) +// Проверяет установленное значение (или его свойство) на "не заполненность" (обертка для `ЗначениеЗаполнено`). // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .НеЗаполнено("Проверка, что значение не заполнено") +// ; Функция НеЗаполнено(Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().НеЗаполнено, , ОписаниеПроверки); @@ -321,14 +411,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на соответствие переданному типу. +// Проверяет установленное значение (или его свойство) на соответствие переданному типу. // // Параметры: -// ОжидаемоеЗначение - Строка, Тип, ОписаниеТипов - Ожидается, что значение Контекста (или его свойство) имеет данный тип -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Строка, Тип, ОписаниеТипов - Ожидается, что значение (или его свойство) имеет данный тип. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .ИмеетТип(Тип("Строка"), "Проверка, что значение имеет тип 'Строка'") +// ; Функция ИмеетТип(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().ИмеетТип, ОжидаемоеЗначение, ОписаниеПроверки); @@ -336,14 +431,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на несоответствие переданному типу. +// Проверяет установленное значение (или его свойство) на несоответствие переданному типу. // // Параметры: -// ОжидаемоеЗначение - Строка, Тип, ОписаниеТипов - Ожидается, что значение Контекста (или его свойство) НЕ имеет данный тип -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Строка, Тип, ОписаниеТипов - Ожидается, что значение (или его свойство) НЕ имеет данный тип. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .НеИмеетТип(Тип("Число"), "Проверка, что значение не имеет тип 'Число'") +// ; Функция НеИмеетТип(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().НеИмеетТип, ОжидаемоеЗначение, ОписаниеПроверки); @@ -351,7 +451,7 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на наличие в нем искомого. +// Проверяет установленное значение (или его свойство) на наличие в нем искомого. // // Проверка поддерживается для следующих типов проверяемого значения: // @@ -365,15 +465,27 @@ // - ФиксированноеСоответствие - по наличию равного значения // - Произвольный итерируемый объект для проверки на соответствие предикату // -// При сравнении также проверяется совпадение типов +// При сравнении также проверяется совпадение типов. // // Параметры: -// ОжидаемоеЗначение - Произвольный - Ожидается, что значение Контекста (или его свойство) содержит указанное значение +// ОжидаемоеЗначение - Произвольный - Ожидается, что значение (или его свойство) содержит указанное значение. // - ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто("Привет, мир!") +// .Содержит(", ", "Проверка на наличие искомого значения") +// ; +// +// Предикат = ЮТест.Предикат(). +// Реквизит("Номенклатура").Равно(Номенклатура) +// .Получить(); +// ЮТест.ОжидаетЧто(Документ.Движения.Остатки) +// .Содержит(Предикат, "Проверка на наличие проводки с нужной номенклатурой") +// ; Функция Содержит(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт Если ЮТПредикатыСлужебныйКлиентСервер.ЭтоПредикат(ОжидаемоеЗначение) Тогда @@ -386,11 +498,11 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на наличие в нем искомого. +// Проверяет установленное значение (или его свойство) на наличие в нем искомого. // // Проверка поддерживается для следующих типов проверяемого значения: // -// - Строка - по отсутствию вхождению +// - Строка - по отсутствию вхождения // - Массив - по отсутствию равного элемента // - Структура - по отсутствию равного значения // - Соответствие - по отсутствию равного значения @@ -400,15 +512,20 @@ // - ФиксированноеСоответствие - по отсутствию равного значения // - Произвольный итерируемый объект для проверки на соответствие предикату // -// При сравнении также проверяется совпадение типов +// При сравнении также проверяется совпадение типов. // // Параметры: -// ОжидаемоеЗначение - Произвольный - Ожидается, что значение Контекста (или его свойство) НЕ содержит указанное +// ОжидаемоеЗначение - Произвольный - Ожидается, что значение (или его свойство) НЕ содержит указанное значение. // - ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто("Hello word!") +// .НеСодержит("Привет", "Проверка на отсутствие искомого значения") +// ; Функция НеСодержит(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт Если ЮТПредикатыСлужебныйКлиентСервер.ЭтоПредикат(ОжидаемоеЗначение) Тогда @@ -421,14 +538,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на наличие подстроки, соответствующей регулярному выражению +// Проверяет установленное значение (или его свойство) на наличие подстроки, соответствующей регулярному выражению. // // Параметры: -// Шаблон - Строка - Регулярное выражение, по которому ищем подстроку -// ОписаниеПроверки - Строка - Описание конкретной проверки +// Шаблон - Строка - Регулярное выражение, по которому ищем подстроку. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .СодержитСтрокуПоШаблону("^[A-Z]+$", "Проверка, что значение содержит только заглавные английские буквы") +// ; Функция СодержитСтрокуПоШаблону(Знач Шаблон, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().СодержитСтрокуПоШаблону, Шаблон, ОписаниеПроверки); @@ -436,14 +558,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на отсутствие подстроки, соответствующей регулярному выражению -// +// Проверяет установленное значение (или его свойство) на отсутствие подстроки, соответствующей заданному регулярному выражению. +// // Параметры: -// Шаблон - Строка - Регулярное выражение, по которому ищем подстроку -// ОписаниеПроверки - Строка - Описание конкретной проверки +// Шаблон - Строка - Регулярное выражение, по которому ищем подстроку. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .НеСодержитСтрокуПоШаблону("[A-Z]", "Проверка, что значение не содержит заглавные буквы") +// ; Функция НеСодержитСтрокуПоШаблону(Знач Шаблон, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().НеСодержитСтрокуПоШаблону, Шаблон, ОписаниеПроверки); @@ -451,15 +578,21 @@ КонецФункции -// Проверяет наличие свойства у объекта/его свойства. -// В отличии от метода см. Свойство не позиционируется на указанное свойство. +// Проверяет наличие свойства у объекта или его свойства. +// В отличие от метода см. Свойство, не позиционируется на указанное свойство. +// // Параметры: // ИмяСвойства - Строка - Наименование свойства объекта. -// Возможно обращение к вложенным свойствам через точку +// Возможно обращение к вложенным свойствам через точку // ОписаниеПроверки - Строка - Описание конкретной проверки // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект) +// .ИмеетСвойство("Движения", "Движения должны существовать") +// ; Функция ИмеетСвойство(Знач ИмяСвойства, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().ИмеетСвойство, ИмяСвойства, ОписаниеПроверки); @@ -467,16 +600,21 @@ КонецФункции -// Проверяет отсутствие свойства у объекта/его свойства. -// В отличии от метода см. НетСвойства не сбрасывает позиционирование проверки. +// Проверяет отсутствие свойства у объекта или его свойства. +// В отличие от метода см. НетСвойства, не сбрасывает позиционирование проверки. // // Параметры: // ИмяСвойства - Строка - Наименование свойства объекта. -// Возможно обращение к вложенным свойствам через точку +// Возможно обращение к вложенным свойствам через точку // ОписаниеПроверки - Строка - Описание конкретной проверки // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект) +// .НеИмеетСвойства("НеСуществующееСвойство", "Проверка, что у объекта нет указанного свойства") +// ; Функция НеИмеетСвойства(Знач ИмяСвойства, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().НеИмеетСвойство, ИмяСвойства, ОписаниеПроверки); @@ -487,30 +625,44 @@ // Проверяет значение (или его свойство), оно должно входить в указанный список. // // Параметры: -// Значения - Массив из Произвольный - Значения для проверки -// - СписокЗначений из Произвольный - Значения для проверки -// ОписаниеПроверки - Строка - Описание конкретной проверки +// Значения - Массив из Произвольный - Значение для проверки. +// - СписокЗначений из Произвольный - Значения для проверки. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания -Функция ВСписке(Значения, ОписаниеПроверки = Неопределено) Экспорт +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ОжидаемыйСтатус = Новый Массив; +// ОжидаемыйСтатус.Добавить("Активный"); +// ОжидаемыйСтатус.Добавить("Неактивный"); +// +// ЮТест.ОжидаетЧто(ДокументОбъект.Статус) +// .ВСписке(ОжидаемыйСтатус), "Статус должен быть в списке") +// ; +Функция ВСписке(Знач Значения, Знач ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатУтверждения(ЮТПредикаты.Выражения().ВСписке, Значения, ОписаниеПроверки); Возврат ЮТУтверждения; КонецФункции -// Проверяет вхождение установленного значение (или его свойства) в заданный интервал. +// Проверяет вхождение установленного значения (или его свойства) в заданный интервал. // -// Проверяемое значение может находится на границе интервала. +// Проверяемое значение может находиться на границе интервала. // // Параметры: -// НачалоИнтервала - Произвольный - Левая граница интервала. Может иметь любой тип, позволяющий сравнивать значения -// ОкончаниеИнтервала - Произвольный - Правая граница. Может иметь любой тип, позволяющий сравнивать значения -// ОписаниеПроверки - Строка - Описание конкретной проверки +// НачалоИнтервала - Произвольный - Левая граница интервала. Может иметь любой тип, позволяющий сравнивать значения. +// ОкончаниеИнтервала - Произвольный - Правая граница. Может иметь любой тип, позволяющий сравнивать значения. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Сумма) +// .МеждуВключаяГраницы(100, 200, "Сумма должна быть в интервале от 100 до 200") +// ; Функция МеждуВключаяГраницы(НачалоИнтервала, ОкончаниеИнтервала, ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатМежду(ЮТПредикаты.Выражения().МеждуВключаяГраницы, НачалоИнтервала, ОкончаниеИнтервала, ОписаниеПроверки); @@ -518,17 +670,22 @@ КонецФункции -// Проверяет вхождение установленного значение (или его свойства) в заданный интервал. +// Проверяет вхождение установленного значения (или его свойства) в заданный интервал. // -// Проверяемое значение не может находится на границе интервала. +// Проверяемое значение не может находиться на границе интервала. // // Параметры: -// НачалоИнтервала - Произвольный - Левая граница интервала. Может иметь любой тип, позволяющий сравнивать значения -// ОкончаниеИнтервала - Произвольный - Правая граница. Может иметь любой тип, позволяющий сравнивать значения -// ОписаниеПроверки - Строка - Описание конкретной проверки +// НачалоИнтервала - Произвольный - Левая граница интервала. Может иметь любой тип, позволяющий сравнивать значения. +// ОкончаниеИнтервала - Произвольный - Правая граница. Может иметь любой тип, позволяющий сравнивать значения. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Цена) +// .МеждуИсключаяГраницы(50, 100, "Цена должна быть в интервале от 50 до 100, не включая границы") +// ; Функция МеждуИсключаяГраницы(НачалоИнтервала, ОкончаниеИнтервала, ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатМежду(ЮТПредикаты.Выражения().МеждуИсключаяГраницы, НачалоИнтервала, ОкончаниеИнтервала, ОписаниеПроверки); @@ -536,17 +693,22 @@ КонецФункции -// Проверяет вхождение установленного значение (или его свойства) в заданный интервал. +// Проверяет вхождение установленного значения (или его свойства) в заданный интервал. // -// Проверяемое значение может находится на начальной границе интервала. +// Проверяемое значение может находиться на начальной границе интервала. // // Параметры: -// НачалоИнтервала - Произвольный - Левая граница интервала. Может иметь любой тип, позволяющий сравнивать значения -// ОкончаниеИнтервала - Произвольный - Правая граница. Может иметь любой тип, позволяющий сравнивать значения -// ОписаниеПроверки - Строка - Описание конкретной проверки +// НачалоИнтервала - Произвольный - Левая граница интервала. Может иметь любой тип, позволяющий сравнивать значения. +// ОкончаниеИнтервала - Произвольный - Правая граница. Может иметь любой тип, позволяющий сравнивать значения. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Количество) +// .МеждуВключаяНачалоГраницы(10, 50, "Количество должно быть в интервале от 10 до 50, включая начальную границу") +// ; Функция МеждуВключаяНачалоГраницы(НачалоИнтервала, ОкончаниеИнтервала, ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатМежду(ЮТПредикаты.Выражения().МеждуВключаяНачалоГраницы, НачалоИнтервала, ОкончаниеИнтервала, ОписаниеПроверки); @@ -554,17 +716,22 @@ КонецФункции -// Проверяет вхождение установленного значение (или его свойства) в заданный интервал. +// Проверяет вхождение установленного значения (или его свойства) в заданный интервал. // -// Проверяемое значение может находится на конечной границе интервала. +// Проверяемое значение может находиться на конечной границе интервала. // // Параметры: -// НачалоИнтервала - Произвольный - Левая граница интервала. Может иметь любой тип, позволяющий сравнивать значения -// ОкончаниеИнтервала - Произвольный - Правая граница. Может иметь любой тип, позволяющий сравнивать значения -// ОписаниеПроверки - Строка - Описание конкретной проверки +// НачалоИнтервала - Произвольный - Левая граница интервала. Может иметь любой тип, позволяющий сравнивать значения. +// ОкончаниеИнтервала - Произвольный - Правая граница. Может иметь любой тип, позволяющий сравнивать значения. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Размер) +// .МеждуВключаяОкончаниеГраницы(20, 100, "Размер должен быть в интервале от 20 до 100, включая конечную границу") +// ; Функция МеждуВключаяОкончаниеГраницы(НачалоИнтервала, ОкончаниеИнтервала, ОписаниеПроверки = Неопределено) Экспорт ПроверитьПредикатМежду(ЮТПредикаты.Выражения().МеждуВключаяОкончаниеГраницы, НачалоИнтервала, ОкончаниеИнтервала, ОписаниеПроверки); @@ -577,11 +744,16 @@ // Проверяет наличие свойств и их значения у проверяемого объекта (или его свойства). // // Параметры: -// ОжидаемоеЗначение - Структура - Проверяемый объект должен иметь свойства указанные в параметре -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Структура - Проверяемый объект должен иметь свойства, указанные в параметре. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект) +// .ИмеетСвойстваРавные(Новая Структура("Сумма, Статус", 100, "Активный"), "Объект должен иметь заданные свойства с указанными значениями") +// ; Функция ИмеетСвойстваРавные(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -593,14 +765,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на равенство `Истина)`. +// Проверяет установленное значение (или его свойство) на равенство `Истина`. // При сравнении также проверяется совпадение типов проверяемого и ожидаемого значения. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Проведен) +// .ЭтоИстина("Документ должен быть проведен") +// ; Функция ЭтоИстина(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -610,14 +787,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство)на НЕ равенство `Истина`. +// Проверяет установленное значение (или его свойство) на НЕ равенство `Истина`. // При сравнении также проверяется совпадение типов проверяемого и ожидаемого значения. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Проведен) +// .ЭтоНеИстина("Документ должен быть не проведен") +// ; Функция ЭтоНеИстина(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -627,14 +809,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на равенство `Ложь`. +// Проверяет установленное значение (или его свойство) на равенство `Ложь`. // При сравнении также проверяется совпадение типов проверяемого и ожидаемого значения. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Проведен) +// .ЭтоЛожь("Документ должен быть не проведен") +// ; Функция ЭтоЛожь(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -644,14 +831,19 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на НЕ равенство `Ложь`. +// Проверяет установленное значение (или его свойство) на НЕ равенство `Ложь`. // При сравнении также проверяется совпадение типов проверяемого и ожидаемого значения. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Проверка) +// .ЭтоНеЛожь("Проверка не должна быть ложной") +// ; Функция ЭтоНеЛожь(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -661,13 +853,18 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на "существование", т.е. отличие от `Null` и `Неопределено`. +// Проверяет установленное значение (или его свойство) на "существование", т.е. отличие от `Null` и `Неопределено`. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Выборка.Поле) +// .Существует("Значение поле должно быть указано") +// ; Функция Существует(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -677,13 +874,18 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на "не существование", т.е. оно равно `Null` или `Неопределено`. +// Проверяет установленное значение (или его свойство) на "не существование", т.е. оно равно `Null` или `Неопределено`. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Выборка.Поле) +// .НеСуществует("Значение поля не должно быть указанно") +// ; Функция НеСуществует(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -693,13 +895,18 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) не равенство `Неопределено`. +// Проверяет установленное значение (или его свойство) на неравенство `Неопределено`. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(СправочникОбъект.Поле) +// .ЭтоНеопределено("Поле должно быть неопределено") +// ; Функция ЭтоНеопределено(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -709,13 +916,18 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на не равенство `Неопределено`. +// Проверяет установленное значение (или его свойство) на не равенство `Неопределено`. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение.Поле) +// .ЭтоНеНеопределено("Поле не должно быть неопределено") +// ; Функция ЭтоНеНеопределено(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -725,13 +937,18 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на равенство `Null`. +// Проверяет установленное значение (или его свойство) на равенство `Null`. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Поле) +// .ЭтоNull("Поле должно быть равно Null") +// ; Функция ЭтоNull(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -741,13 +958,18 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на не равенство `Null`. +// Проверяет установленное значение (или его свойство) на не равенство `Null`. // // Параметры: -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(ДокументОбъект.Поле) +// .ЭтоНеNull("Поле не должно быть равно Null") +// ; Функция ЭтоНеNull(Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -757,7 +979,7 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на длину или размер коллекции. +// Проверяет установленное значение (или его свойство) на длину или размер коллекции. // // Проверка поддерживается для следующих типов проверяемого значения: // - Строка @@ -768,14 +990,28 @@ // - ФиксированныйМассив // - ФиксированнаяСтруктура // - ФиксированноеСоответствие -// - ТаблицаЗначения +// - ТаблицаЗначений // // Параметры: -// ОжидаемоеЗначение - Число - Ожидается, что значение Контекста (или его свойство) имеет указанную длину или размер -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Число - Ожидается, что значение (или его свойство) имеет указанную длину или размер. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// СтрокаДляПроверки = "Hello"; +// ЮТест.ОжидаетЧто(СтрокаДляПроверки) +// .ИмеетДлину(5, "Проверка на длину строки равную 5") +// ; +// МассивДляПроверки = Новый Массив(3); +// ЮТест.ОжидаетЧто(МассивДляПроверки) +// .ИмеетДлину(3, "Проверка на длину массива равную 3") +// ; +// СтруктураДляПроверки = Новый Структура("Поле1, Поле2", 10, 20); +// ЮТест.ОжидаетЧто(СтруктураДляПроверки) +// .ИмеетДлину(2, "Проверка на количество полей структуры равное 2") +// ; Функция ИмеетДлину(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -791,7 +1027,7 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на длину или размер коллекции. +// Проверяет установленное значение (или его свойство) на длину или размер коллекции и определяет, больше ли эта длина или размер указанного значения. // // Проверка поддерживается для следующих типов проверяемого значения: // - Строка @@ -802,14 +1038,32 @@ // - ФиксированныйМассив // - ФиксированнаяСтруктура // - ФиксированноеСоответствие -// - ТаблицаЗначения +// - ТаблицаЗначений // // Параметры: -// ОжидаемоеЗначение - Число - Ожидается, что значение Контекста (или его свойство) имеет указанную длину или размер -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Число - Ожидается, что значение (или его свойство) имеет длину или размер, превышающий это значение. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// СтрокаДляПроверки = "Hello, World!"; +// ЮТест.ОжидаетЧто(СтрокаДляПроверки) +// .ИмеетДлинуБольше(5, "Проверка, что длина строки больше 5") +// ; +// МассивДляПроверки = Новый Массив(4); +// ЮТест.ОжидаетЧто(МассивДляПроверки) +// .ИмеетДлинуБольше(3, "Проверка, что длина массива больше 3") +// ; +// СоответствиеДляПроверки = Новый Соответствие; +// СоответствиеДляПроверки.Вставить("Ключ1", 1); +// СоответствиеДляПроверки.Вставить("Ключ2", 2); +// ЮТест.ОжидаетЧто(СоответствиеДляПроверки) +// .ИмеетДлинуБольше(1, "Проверка, что количество элементов соответствия больше 1") +// ; +Функция ИмеетДлинуБольше(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт + Функция ИмеетДлинуБольше(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -825,7 +1079,7 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на длину или размер коллекции. +// Проверяет установленное значение (или его свойство) на длину или размер коллекции и определяет, меньше ли эта длина или размер указанного значения. // // Проверка поддерживается для следующих типов проверяемого значения: // - Строка @@ -836,14 +1090,32 @@ // - ФиксированныйМассив // - ФиксированнаяСтруктура // - ФиксированноеСоответствие -// - ТаблицаЗначения +// - ТаблицаЗначений // // Параметры: -// ОжидаемоеЗначение - Число - Ожидается, что значение Контекста (или его свойство) имеет указанную длину или размер -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Число - Ожидается, что значение (или его свойство) имеет длину или размер, меньшее это значение. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// СтрокаДляПроверки = "Hello"; +// ЮТест.ОжидаетЧто(СтрокаДляПроверки) +// .ИмеетДлинуМеньше(10, "Проверка, что длина строки меньше 10") +// ; +// +// МассивДляПроверки = Новый Массив(2); +// МассивДляПроверки.Добавить(1); +// МассивДляПроверки.Добавить(2); +// ЮТест.ОжидаетЧто(МассивДляПроверки) +// .ИмеетДлинуМеньше(3, "Проверка, что длина массива меньше 3") +// ; +// +// СтруктураДляПроверки = Новый Структура("Поле1", 10); +// ЮТест.ОжидаетЧто(СтруктураДляПроверки) +// .ИмеетДлинуМеньше(2, "Проверка, что количество полей структуры меньше 2") +// ; Функция ИмеетДлинуМеньше(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -859,7 +1131,7 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство) на длину или размер коллекции, которые не должны совпадать с указанным значением. +// Проверяет установленное значение (или его свойство) на длину или размер коллекции, которые не должны совпадать с указанным значением. // // Проверка поддерживается для следующих типов проверяемого значения: // - Строка @@ -873,11 +1145,27 @@ // - ТаблицаЗначения // // Параметры: -// ОжидаемоеЗначение - Число - Ожидается, что значение Контекста (или его свойство) не имеет указанную дину или размер -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ОжидаемоеЗначение - Число - Ожидается, что значение (или его свойство) не имеет указанную длину или размер. +// ОписаниеПроверки - Строка - Описание конкретной проверки, позволяющее более точно понять, что именно проверяется. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// СтрокаДляПроверки = "Hello"; +// ЮТест.ОжидаетЧто(СтрокаДляПроверки) +// .НеИмеетДлину(15, "Проверка, что длина строки не равна 15") +// ; +// +// МассивДляПроверки = Новый Массив(3); +// ЮТест.ОжидаетЧто(МассивДляПроверки) +// .НеИмеетДлину(4, "Проверка, что длина массива не равна 4") +// ; +// +// СтруктураДляПроверки = Новый Структура("Поле1, Поле2", 10, 20); +// ЮТест.ОжидаетЧто(СтруктураДляПроверки) +// .НеИмеетДлину(12, "Проверка, что количество полей структуры не равно 12") +// ; Функция НеИмеетДлину(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -895,16 +1183,22 @@ #Область ПроверкаМетодов -// Вызывает метод (см. Метод) объекта контекста и проверяет, выбрасывает ли он исключение. -// Проверяет, что метод упадет по исключению, а текст исключения содержит(включает) указанный. +// Вызывает метод (см. Метод) объекта и проверяет, выбрасывает ли он исключение. +// Проверяет, что метод вызывает исключение, а текст исключения содержит (включает) указанный текст. // // Параметры: -// ОжидаемоеЗначение - Строка - Ожидается, что сообщение об ошибке будет содержать(включать) данный текст -// ОписаниеПроверки - Строка - Описание конкретной проверки -// ВТранзакции - Булево - Вызов метода выполняется в транзакции +// ОжидаемоеЗначение - Строка - Ожидается, что сообщение об ошибке будет содержать (включать) данный текст. +// ОписаниеПроверки - Строка - Описание конкретной проверки. +// ВТранзакции - Булево - Указывает, что вызов метода выполняется в транзакции. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Объект) +// .Метод("Записать") +// .ВыбрасываетИсключение("Ошибка: Недостаточно прав") +// ; Функция ВыбрасываетИсключение(Знач ОжидаемоеЗначение, Знач ОписаниеПроверки = Неопределено, ВТранзакции = Ложь) Экспорт Контекст = Контекст(); @@ -933,18 +1227,24 @@ КонецФункции -// Вызывает метод (см. Метод) объекта контекста и проверяет, выбрасывает ли он исключение. -// Проверяет, что метод не упадет по исключению -// или упадет по исключению текст, которого не содержит указанный. +// Вызывает метод (см. Метод) объекта и проверяет, выбрасывает ли он исключение. +// Проверяет, что метод не вызывает исключение, +// или что при его вызове выбрасывается исключение, текст которого не содержит указанный текст. // // Параметры: -// ОжидаемоеЗначение - Строка - Ожидается, что метод выбросит исключение, текст которого НЕ будет содержать (включать) данный текст -// - Неопределено - Ожидается, что метод отработает без выбора исключения -// ОписаниеПроверки - Строка - Описание конкретной проверки -// ВТранзакции - Булево - Вызов метода выполняется в транзакции +// ОжидаемоеЗначение - Строка - Ожидается, что метод выбросит исключение, текст которого НЕ будет содержать (включать) данный текст. +// - Неопределено - Ожидается, что метод отработает без выброса исключения. +// ОписаниеПроверки - Строка - Описание конкретной проверки. +// ВТранзакции - Булево - Указывает, что вызов метода выполняется в транзакции. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Объект) +// .Метод("Записать") +// .НеВыбрасываетИсключение("Ошибка: Недостаточно прав") +// ; Функция НеВыбрасываетИсключение(Знач ОжидаемоеЗначение = Неопределено, Знач ОписаниеПроверки = Неопределено, ВТранзакции = Ложь) Экспорт Контекст = Контекст(); @@ -972,15 +1272,19 @@ КонецФункции -// Проверяет, что установленное значение Контекста (или его свойство) имеет указанный экспортный метод. -// +// Проверяет, что установленное значение (или его свойство) имеет указанный экспортный метод. // // Параметры: -// ИмяМетода - Строка - Имя метода, наличие которого нужно проверить -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ИмяМетода - Строка - Имя метода, наличие которого нужно проверить. +// ОписаниеПроверки - Строка - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .ИмеетМетод("Метод1", "Проверка наличия экспортного метода Метод1") +// ; Функция ИмеетМетод(ИмяМетода, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -998,16 +1302,22 @@ КонецФункции #КонецОбласти -// Проверяет установленное значение Контекста (или его свойство), ожидается что оно начинается на указанное значение. + +// Проверяет, что установленное значение (или его свойство) начинается на указанное значение. // // При этом проверяемое значение должно быть строкой. // // Параметры: -// СтрокаПоиска - Строка - Строка поиска -// ОписаниеПроверки - Строка - Описание конкретной проверки +// СтрокаПоиска - Строка - Ожидается, что значение начинается с этой строки поиска. +// ОписаниеПроверки - Строка - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .НачинаетсяС("Привет", "Проверка, что значение начинается с 'Привет'") +// ; Функция НачинаетсяС(СтрокаПоиска, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1028,16 +1338,21 @@ КонецФункции -// Проверяет установленное значение Контекста (или его свойство), ожидается что оно заканчивается на указанное значение. +// Проверяет, что установленное значение (или его свойство) заканчивается на указанное значение. // // При этом проверяемое значение должно быть строкой. // // Параметры: -// СтрокаПоиска - Строка - Строка поиска -// ОписаниеПроверки - Строка - Описание конкретной проверки +// СтрокаПоиска - Строка - Ожидается, что значение заканчивается на этой строке поиска. +// ОписаниеПроверки - Строка - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .ЗаканчиваетсяНа("мир", "Проверка, что значение заканчивается на 'мир'") +// ; Функция ЗаканчиваетсяНа(СтрокаПоиска, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1058,14 +1373,19 @@ КонецФункции -// Проверяет каждый элемент установленного значения (или его свойства), все элементы должны иметь указанное свойство. +// Проверяет каждый элемент установленного значения (или его свойства); все элементы должны иметь указанное свойство. // // Параметры: -// ИмяСвойства - Строка -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ИмяСвойства - Строка - Имя свойства, наличие которого нужно проверить у каждого элемента. +// ОписаниеПроверки - Строка - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Коллекция) +// .КаждыйЭлементСодержитСвойство("Свойство1", "Проверка наличия свойства 'Свойство1' у каждого элемента") +// ; Функция КаждыйЭлементСодержитСвойство(ИмяСвойства, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1086,16 +1406,21 @@ КонецФункции -// Проверяет каждый элемент установленного значения (или его свойства), +// Проверяет каждый элемент установленного значения (или его свойства); // все элементы должны иметь указанное свойство, которое равно ожидаемому значению. // // Параметры: -// ИмяСвойства - Строка -// ОжидаемоеЗначение - Произвольный - Ожидаемое значение свойства -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ИмяСвойства - Строка - Имя свойства, наличие которого нужно проверить у каждого элемента. +// ОжидаемоеЗначение - Произвольный - Ожидаемое значение свойства для проверки. +// ОписаниеПроверки - Строка - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Движения) +// .КаждыйЭлементСодержитСвойствоСоЗначением("ВидДвижения", Приход, "Проверка, что свойство 'ВидДвижения' равно Приход у каждого элемента") +// ; Функция КаждыйЭлементСодержитСвойствоСоЗначением(ИмяСвойства, ОжидаемоеЗначение, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1125,14 +1450,20 @@ КонецФункции -// Проверяет элементы установленного значения (или его свойства), хотя бы один из них должен иметь указанное свойство. +// Проверяет элементы установленного значения (или его свойства); +// хотя бы один из них должен иметь указанное свойство. // // Параметры: -// ИмяСвойства - Строка -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ИмяСвойства - Строка - Имя свойства, наличие которого нужно проверить у элементов. +// ОписаниеПроверки - Строка - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Значение) +// .ЛюбойЭлементСодержитСвойство("Свойство1", "Проверка, что хотя бы один элемент содержит свойство 'Свойство1'") +// ; Функция ЛюбойЭлементСодержитСвойство(ИмяСвойства, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1159,16 +1490,21 @@ КонецФункции -// Проверяет элементы установленного значения (или его свойства), +// Проверяет элементы установленного значения (или его свойства); // хотя бы один из них должен иметь указанное свойство, которое равно ожидаемому значению. // // Параметры: -// ИмяСвойства - Строка -// ОжидаемоеЗначение - Произвольный - Ожидаемое значение свойства -// ОписаниеПроверки - Строка - Описание конкретной проверки +// ИмяСвойства - Строка - Имя свойства, наличие которого нужно проверить у элементов. +// ОжидаемоеЗначение - Произвольный - Ожидаемое значение свойства для проверки. +// ОписаниеПроверки - Строка - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// ЮТест.ОжидаетЧто(Движения) +// .ЛюбойЭлементСодержитСвойствоСоЗначением("Номенклатура", Товар, "Проверка, что есть строка с нужным товаром") +// ; Функция ЛюбойЭлементСодержитСвойствоСоЗначением(ИмяСвойства, ОжидаемоеЗначение, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1209,16 +1545,25 @@ КонецФункции // Проверяет установленное значение (или его свойства) на соответствие утверждениям предиката. -// см. ЮТест.Предикат +// См. ЮТест.Предикат. // // Параметры: -// Предикат - Массив из см. ЮТФабрика.ВыражениеПредиката - Набор утверждений, см. ЮТПредикаты.Получить -// - см. ЮТФабрика.ВыражениеПредиката -// - ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат -// ОписаниеПроверки - Строка, Неопределено - Описание конкретной проверки +// Предикат - Массив из см. ЮТФабрика.ВыражениеПредиката - Набор утверждений, см. ЮТПредикаты.Получить. +// - См. ЮТФабрика.ВыражениеПредиката. +// - ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат. +// ОписаниеПроверки - Строка, Неопределено - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// Предикат = ЮТест.Предикат(). +// Реквизит("Номенклатура").Равно(Номенклатура) +// .Получить(); +// +// ЮТест.ОжидаетЧто(СтрокаТаблицы) +// .СоответствуетПредикату(Предикат, "Проверка на соответствие утверждениям предиката") +// ; Функция СоответствуетПредикату(Предикат, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1237,18 +1582,27 @@ КонецФункции -// Проверяет каждый элемент установленного значения (или его свойства), +// Проверяет каждый элемент установленного значения (или его свойства); // все элементы должны соответствовать утверждениям предиката. -// см. ЮТест.Предикат +// См. ЮТест.Предикат. // // Параметры: -// Предикат - Массив из см. ЮТФабрика.ВыражениеПредиката - Набор утверждений, см. ЮТПредикаты.Получить -// - см. ЮТФабрика.ВыражениеПредиката -// - ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат -// ОписаниеПроверки - Строка, Неопределено - Описание конкретной проверки +// Предикат - Массив из см. ЮТФабрика.ВыражениеПредиката - Набор утверждений, см. ЮТПредикаты.Получить. +// - См. ЮТФабрика.ВыражениеПредиката. +// - ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат. +// ОписаниеПроверки - Строка, Неопределено - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// Предикат = ЮТест.Предикат(). +// Реквизит("Номенклатура").Равно(Номенклатура) +// .Получить(); +// +// ЮТест.ОжидаетЧто(Значение) +// .КаждыйЭлементСоответствуетПредикату(Предикат, "Проверка, что все элементы соответствуют утверждениям предиката") +// ; Функция КаждыйЭлементСоответствуетПредикату(Предикат, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1270,18 +1624,27 @@ КонецФункции -// Проверяет элементы установленного значения (или его свойства), +// Проверяет элементы установленного значения (или его свойства); // хотя бы один из них должен соответствовать утверждениям предиката. -// см. ЮТест.Предикат +// См. ЮТест.Предикат. // // Параметры: -// Предикат - Массив из см. ЮТФабрика.ВыражениеПредиката - Набор утверждений, см. ЮТПредикаты.Получить -// - см. ЮТФабрика.ВыражениеПредиката -// - ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат -// ОписаниеПроверки - Строка, Неопределено - Описание конкретной проверки +// Предикат - Массив из см. ЮТФабрика.ВыражениеПредиката - Набор утверждений, см. ЮТПредикаты.Получить. +// - См. ЮТФабрика.ВыражениеПредиката. +// - ОбщийМодуль - Модуль настройки предикатов, см. ЮТест.Предикат. +// ОписаниеПроверки - Строка, Неопределено - Описание конкретной проверки. // // Возвращаемое значение: -// ОбщийМодуль - Этот модуль для замыкания +// ЮТУтверждения - Этот модуль для продолжения формирования утверждений. +// +// Пример: +// Предикат = ЮТест.Предикат(). +// Реквизит("Номенклатура").Равно(Номенклатура) +// .Получить(); +// +// ЮТест.ОжидаетЧто(Значение) +// .ЛюбойЭлементСоответствуетПредикату(Предикат, "Проверка, что хотя бы один элемент соответствует утверждениям предиката") +// ; Функция ЛюбойЭлементСоответствуетПредикату(Предикат, ОписаниеПроверки = Неопределено) Экспорт Контекст = Контекст(); @@ -1316,7 +1679,11 @@ #Область СлужебныйПрограммныйИнтерфейс // Сбросить контекст. -// Используется для принудительного сброса контекста утверждения +// Используется для принудительного сброса контекста утверждения. +// Это позволяет очистить состояние текущих проверок и начать новую серию утверждений. +// +// Примечание: После вызова этой процедуры все предыдущие утверждения будут сброшены, +// и новые проверки можно будет выполнять с чистого листа. Процедура СброситьКонтекст() Экспорт ЮТКонтекстСлужебный.УстановитьКонтекстУтверждений(Неопределено);