Ожидает наступления некоторого состояния за счет вызова функции, проверяющей условия его достижения с периодичностью 1 раз в секунду (без цикла ожидания по времени).
Синтаксис
ОжидатьСостояния(<ОписаниеОповещения>, <Таймаут>)Полное описание, параметры и ограничения
ТестируемоеПриложение.ОжидатьСостояния (TestedApplication.WaitForCondition)
ТестируемоеПриложение (TestedApplication)
ОжидатьСостояния (WaitForCondition)
Доступен, начиная с версии 8.3.16.
Синтаксис:
ОжидатьСостояния(<ОписаниеОповещения>, <Таймаут>)
Параметры:
<ОписаниеОповещения> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание функции, которая будет возвращать:
Истина - если состояние достигнуто,
Ложь - в противном случае.
<Таймаут> (необязательный)
Тип: Число.
Время в секундах, в течение которого выполняется ожидание состояния.
Значение по умолчанию: 60.
Возвращаемое значение:
Тип: Булево.
Истина - если функция, проверяющая достижение состояния, вернула Истина.
Ложь - закончился тайм-аут или функция проверки вернула Ложь.
Описание:
Ожидает наступления некоторого состояния за счет вызова функции, проверяющей условия его достижения с периодичностью 1 раз в секунду (без цикла ожидания по времени).
Доступность:
Тонкий клиент, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.16.
Методическая информация
Практические примеры
Автоматизировать отмену своего файлового диалога без чтения файла
До нажатия кнопки ставим в очередь результат Отмена, ждём собственный статус и очищаем оставшуюся учебную очередь.
Где и как запускать
Полный клиентский модуль формы обработки в менеджере тестов, запущенном с /TESTMANAGER. Это не модуль тестируемой таблицы.
Подготовка
Создайте собственную пустую учебную конфигурацию УчебнаяКонфигурацияСинтаксиса. Первый урок содержит полный модуль отдельной внешней обработки УчебнаяТаблицаТестирования; её данные только в памяти.
Запустите два отдельных тонких клиента собственной учебной базы: тестируемый с /TESTCLIENT -TPort15380, менеджер с /TESTMANAGER. Порт 15380 — собственный учебный; убедитесь, что на нём не работает другой клиент. Не подключайте менеджер к рабочей базе/чужому приложению.
В тестируемом клиенте вручную откройте собственную обработку из первого урока. В менеджере создайте другую внешнюю обработку с командой ВыполнитьПример; полный код одного теста вставьте в её модуль формы.
Перед каждым тестом закройте и заново откройте таблицу в тестируемом клиенте. Исходно в ней A-01/Книга/3, B-02/Ручка/1, C-00/Бумага/2, без ранее установленной сортировки и редактирования.
Каждый тест ищет точный учебный заголовок и таблицу ТаблицаТоваров внутри этой формы. Не заменяйте селекторы на * или первый найденный элемент рабочего приложения.
Это код штатного механизма тестирования 1С, не браузерная проверка HTML. В данном окружении выполнение UI-тестов в настоящей 1С не подтверждено.
&НаКлиенте
Процедура ВыполнитьПример(Команда)
Приложение = Новый ТестируемоеПриложение("127.0.0.1", 15380);
Приложение.УстановитьСоединение();
ИсходныйЛимит = Неопределено;
ОшибкаТеста = "";
Попытка
Форма = Приложение.ПолучитьОбъект(Тип("ТестируемаяФорма"), "Учебная таблица guide-owned-ui-2026", , 10);
Таблица = Форма.ПолучитьОбъект(Тип("ТестируемаяТаблицаФормы"), , "ТаблицаТоваров", 10);
ИсходныйЛимит = Приложение.ПолучитьМаксимальноеВремяВыполненияДействия();
Приложение.УстановитьМаксимальноеВремяВыполненияДействия(10);
Кнопка = Форма.ПолучитьОбъект(Тип("ТестируемаяКнопкаФормы"), , "КнопкаУчебныйДиалогФайла", 10);
Приложение.ОчиститьРезультатДиалогаВыбораФайла();
ОшибкаДиалога = "";
Попытка
Приложение.УстановитьРезультатДиалогаВыбораФайла(Ложь);
Кнопка.Нажать();
ПараметрыПроверки = Новый Структура("Форма,ИмяПоля,ОжидаемыйТекст", Форма, "ПолеУчебногоСтатуса", "Отмена");
Условие = Новый ОписаниеОповещения("УчебноеПолеДостиглоСостояния", ЭтотОбъект, ПараметрыПроверки);
Если Не Приложение.ОжидатьСостояния(Условие, 5) Тогда
ВызватьИсключение "Отмена собственного файлового диалога не подтверждена статусом";
КонецЕсли;
Исключение
ОшибкаДиалога = ОписаниеОшибки();
КонецПопытки;
Попытка
Приложение.ОчиститьРезультатДиалогаВыбораФайла();
Исключение
ВызватьИсключение "Учебная очередь не очищена: " + ОписаниеОшибки() + "; ошибка диалога: " + ОшибкаДиалога;
КонецПопытки;
Если Не ПустаяСтрока(ОшибкаДиалога) Тогда
ВызватьИсключение ОшибкаДиалога;
КонецЕсли;
Сообщить("Собственный диалог отменён, файлы не читались");
Исключение
ОшибкаТеста = ОписаниеОшибки();
КонецПопытки;
ОшибкиЗавершения = ЗавершитьСобственныйУчебныйТест(Приложение, ИсходныйЛимит);
Если Не ПустаяСтрока(ОшибкаТеста) Или Не ПустаяСтрока(ОшибкиЗавершения) Тогда
ВызватьИсключение "Ошибка учебного UI-теста: " + ОшибкаТеста + " " + ОшибкиЗавершения;
КонецЕсли;
Сообщить("Сценарий завершён без исключения. Отдельно сверяйте контрольные Истина и видимые данные учебного клиента");
КонецПроцедуры
&НаКлиенте
Функция ЗавершитьСобственныйУчебныйТест(Приложение, ИсходныйЛимит)
ОшибкиЗавершения = "";
Если ТипЗнч(ИсходныйЛимит) = Тип("Число") Тогда
Попытка
Приложение.УстановитьМаксимальноеВремяВыполненияДействия(ИсходныйЛимит);
Исключение
ОшибкиЗавершения = "Не восстановлен лимит действий: " + ОписаниеОшибки();
КонецПопытки;
КонецЕсли;
Попытка
Приложение.РазорватьСоединение();
Исключение
ОшибкиЗавершения = ОшибкиЗавершения + " Не разорвано соединение: " + ОписаниеОшибки();
КонецПопытки;
Возврат ОшибкиЗавершения;
КонецФункции
&НаКлиенте
Функция УчебноеПолеДостиглоСостояния(ДополнительныеПараметры) Экспорт
Поле = ДополнительныеПараметры.Форма.НайтиОбъект(Тип("ТестируемоеПолеФормы"), , ДополнительныеПараметры.ИмяПоля, 1);
Если Поле = Неопределено Тогда
Возврат Ложь;
КонецЕсли;
Возврат Поле.ПолучитьОтображаемыйТекст() = ДополнительныеПараметры.ОжидаемыйТекст;
КонецФункцииРазбор по шагам
Сначала открываем собственную таблицу в отдельном клиенте тестирования. Подключаемся только к 127.0.0.1:15380, ищем точный заголовок и внутреннее имя таблицы с таймаутами 10 секунд.
Нужен расширенный fixture с собственным диалогом и статусом. Он не открывает и не записывает выбранный файл, только обрабатывает результат диалога.
УстановитьРезультатДиалогаВыбораФайла вызывается до кнопки, открывающей диалог. Значения ставятся в очередь; одна установка применяется к одному вызову диалога.
Ложь имитирует отмену; имя файла и индекс фильтра при этом не нужны. Для Истина они обязательны — не переносите сокращённый вызов в пример выбора.
Показать диалог завершает через экспортную процедуру с массивом имён или Неопределено. Ожидаем собственный текст Отмена через функцию, не немедленно после Нажать.
Очищаем очередь только отдельного собственного теста. Если системный диалог открылся без подготовленного результата, действия менеджера могут выдавать ошибку до ручного закрытия; не кликайте произвольное окно.
После теста восстанавливаем исходный лимит действий и отдельно пытаемся разорвать соединение, даже при исключении. Ошибки завершения не скрываем; разрыв соединения не закрывает тестируемое приложение.
Как проверить результат
Статус собственного fixture стал Отмена в пределах ожидания; отсутствие подтверждения вызывает объясняющую ошибку.
Не выбран/прочитан/записан ни один файл. Очередь учебных результатов очищена и соединение разорвано.
Ожидаемый результат
Подготовлен конкретный безопасный тест отмены диалога с правильной очередностью действий.
На что обратить внимание
Не очищайте очередь общих тестов или чужого менеджера.
При сбое очереди закрывайте только фактически распознанный собственный системный диалог вручную.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Ожидать видимость и нужное значение без бесконечного цикла
Проверяем появление своей формы и состояние поля через экспортную функцию. Все ожидания имеют конечные таймауты.
Где и как запускать
Полный клиентский модуль формы обработки в менеджере тестов, запущенном с /TESTMANAGER. Это не модуль тестируемой таблицы.
Подготовка
Создайте собственную пустую учебную конфигурацию УчебнаяКонфигурацияСинтаксиса. Первый урок содержит полный модуль отдельной внешней обработки УчебнаяТаблицаТестирования; её данные только в памяти.
Запустите два отдельных тонких клиента собственной учебной базы: тестируемый с /TESTCLIENT -TPort15380, менеджер с /TESTMANAGER. Порт 15380 — собственный учебный; убедитесь, что на нём не работает другой клиент. Не подключайте менеджер к рабочей базе/чужому приложению.
В тестируемом клиенте вручную откройте собственную обработку из первого урока. В менеджере создайте другую внешнюю обработку с командой ВыполнитьПример; полный код одного теста вставьте в её модуль формы.
Перед каждым тестом закройте и заново откройте таблицу в тестируемом клиенте. Исходно в ней A-01/Книга/3, B-02/Ручка/1, C-00/Бумага/2, без ранее установленной сортировки и редактирования.
Каждый тест ищет точный учебный заголовок и таблицу ТаблицаТоваров внутри этой формы. Не заменяйте селекторы на * или первый найденный элемент рабочего приложения.
Это код штатного механизма тестирования 1С, не браузерная проверка HTML. В данном окружении выполнение UI-тестов в настоящей 1С не подтверждено.
&НаКлиенте
Процедура ВыполнитьПример(Команда)
Приложение = Новый ТестируемоеПриложение("127.0.0.1", 15380);
Приложение.УстановитьСоединение();
ИсходныйЛимит = Неопределено;
ОшибкаТеста = "";
Попытка
Форма = Приложение.ПолучитьОбъект(Тип("ТестируемаяФорма"), "Учебная таблица guide-owned-ui-2026", , 10);
Таблица = Форма.ПолучитьОбъект(Тип("ТестируемаяТаблицаФормы"), , "ТаблицаТоваров", 10);
ИсходныйЛимит = Приложение.ПолучитьМаксимальноеВремяВыполненияДействия();
Приложение.УстановитьМаксимальноеВремяВыполненияДействия(10);
Появилась = Приложение.ОжидатьОтображениеОбъекта(Тип("ТестируемаяФорма"), "Учебная таблица guide-owned-ui-2026", , 5);
Сообщить(Появилась);
Таблица.Активизировать();
Таблица.ПерейтиКПервойСтроке();
ПараметрыПроверки = Новый Структура("Форма,ИмяПоля,ОжидаемыйТекст", Форма, "ТоварыКоличество", "3");
Условие = Новый ОписаниеОповещения("УчебноеПолеДостиглоСостояния", ЭтотОбъект, ПараметрыПроверки);
Сообщить(Приложение.ОжидатьСостояния(Условие, 5));
Сообщить(Не Приложение.ОжидатьОтображениеОбъекта(Тип("ТестируемаяФорма"), "НеСуществуетGuideOwnedUI2026", , 1));
Исключение
ОшибкаТеста = ОписаниеОшибки();
КонецПопытки;
ОшибкиЗавершения = ЗавершитьСобственныйУчебныйТест(Приложение, ИсходныйЛимит);
Если Не ПустаяСтрока(ОшибкаТеста) Или Не ПустаяСтрока(ОшибкиЗавершения) Тогда
ВызватьИсключение "Ошибка учебного UI-теста: " + ОшибкаТеста + " " + ОшибкиЗавершения;
КонецЕсли;
Сообщить("Сценарий завершён без исключения. Отдельно сверяйте контрольные Истина и видимые данные учебного клиента");
КонецПроцедуры
&НаКлиенте
Функция ЗавершитьСобственныйУчебныйТест(Приложение, ИсходныйЛимит)
ОшибкиЗавершения = "";
Если ТипЗнч(ИсходныйЛимит) = Тип("Число") Тогда
Попытка
Приложение.УстановитьМаксимальноеВремяВыполненияДействия(ИсходныйЛимит);
Исключение
ОшибкиЗавершения = "Не восстановлен лимит действий: " + ОписаниеОшибки();
КонецПопытки;
КонецЕсли;
Попытка
Приложение.РазорватьСоединение();
Исключение
ОшибкиЗавершения = ОшибкиЗавершения + " Не разорвано соединение: " + ОписаниеОшибки();
КонецПопытки;
Возврат ОшибкиЗавершения;
КонецФункции
&НаКлиенте
Функция УчебноеПолеДостиглоСостояния(ДополнительныеПараметры) Экспорт
Поле = ДополнительныеПараметры.Форма.НайтиОбъект(Тип("ТестируемоеПолеФормы"), , ДополнительныеПараметры.ИмяПоля, 1);
Если Поле = Неопределено Тогда
Возврат Ложь;
КонецЕсли;
Возврат Поле.ПолучитьОтображаемыйТекст() = ДополнительныеПараметры.ОжидаемыйТекст;
КонецФункцииРазбор по шагам
Сначала открываем собственную таблицу в отдельном клиенте тестирования. Подключаемся только к 127.0.0.1:15380, ищем точный заголовок и внутреннее имя таблицы с таймаутами 10 секунд.
ОжидатьОтображениеОбъекта возвращает Булево, не найденный объект. Для дальнейших действий объект получают отдельно.
ОжидатьСостояния вызывает функцию, возвращающую Истина/Ложь, с периодичностью по механизму тестирования. Не пишем цикл Пока со сном в клиентском обработчике.
Экспортная функция получает дополнительные параметры уведомления. Ищет конкретное поле с таймаутом 1 секунда и сравнивает отображаемое значение.
Отрицательная проверка заведомо отсутствующей собственной формы ожидает всего 1 секунду. Ложь — нормальный результат истечения ожидания, не исключение.
После теста восстанавливаем исходный лимит действий и отдельно пытаемся разорвать соединение, даже при исключении. Ошибки завершения не скрываем; разрыв соединения не закрывает тестируемое приложение.
Как проверить результат
Три контрольных Истина: форма есть, количество первой Книги равно 3, отсутствующая форма не появилась.
Если количество уже менялось предыдущим тестом, закройте и заново откройте fixture; не подменяйте ожидаемое значение фактическим ради зелёного результата.
Ожидаемый результат
Показано ограниченное ожидание объекта и состояния с настоящей экспортной функцией проверки.
На что обратить внимание
ОжидатьСостояния не принимает обычную процедуру без возвращаемого Булево.
Слишком долгие действия внутри функции проверки могут увеличить реальную длительность ожидания.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.