Ждать: получить обещанную сумму, а не использовать Обещание как число

Полная собственная управляемая форма вызывает клиентскую асинхронную функцию. Показываем и Обещание результата, и ожидание обычного значения без реальной сети или таймера.

Подготовка

1. В отдельной учебной базе платформы 8.5.1.1343 создайте внешнюю обработку УчебнаяФорма85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.

2. В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте полный модуль урока, включая клиентские и серверные помощники, на уровне модуля.

3. Не создавайте вручную ЗначениеПримера, ПолеПримера и кнопку: код создаёт их полностью. Каждый урок запускайте в отдельной копии своей формы.

4. Сохраните свою EPF и откройте её в учебной базе. Собственное количество начинается с 3, цена книги задана в коде как 250; исходный расчёт равен 750.

5. Связанный реквизит помечен как СохраняемыеДанные для изучения поведения формы. Это признак реквизита формы, а не автоматическая запись книги, файла или документа в базу.

6. Команда расчёта имеет ИзменяетСохраняемыеДанные = Ложь. Уроки изменяют только свой интерфейс и значения собственной формы, не конфигурацию и не рабочие данные.

7. Запуск и вид в 1С не проверены. Компоновку, сочетания клавиш и расположение команд осмотрите вручную в указанном клиенте; не переносите настройки на рабочие формы без отдельной проверки.

Перем Занято;

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный));
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита, "", "Количество книг", Истина));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = 3;
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Количество собственных книг";


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Выполнить собственный учебный шаг";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Асинх Процедура УчебноеДействие(Команда)
    Если Занято = Истина Тогда
        Возврат;
    КонецЕсли;
    Занято = Истина;
    ИсходноеКоличество = ЗначениеПримера;
    Попытка
        ОбещаннаяСумма = РассчитатьСуммуАсинх(ИсходноеКоличество);
        Сообщить(ТипЗнч(ОбещаннаяСумма) = Тип("Обещание"));
        Сумма = Ждать ОбещаннаяСумма;
        ОбычнаяСумма = Ждать (ИсходноеКоличество * 250);
        Сообщить(ТипЗнч(Сумма) = Тип("Число"));
        Сообщить(Сумма = ОбычнаяСумма);
        Сообщить(Сумма = ИсходноеКоличество * 250);
        Сообщить(СтрШаблон("Снимок количества %1; полученная сумма %2", ИсходноеКоличество, Сумма));
    Исключение
        Занято = Ложь;
        Сообщить("Учебный асинхронный расчёт остановлен из-за неправильного количества");
        ВызватьИсключение;
    КонецПопытки;
    Занято = Ложь;
КонецПроцедуры

&НаКлиенте
Асинх Функция РассчитатьСуммуАсинх(Знач Количество)
    Если ТипЗнч(Количество) <> Тип("Число") Тогда
        ВызватьИсключение "Количество должно быть числом";
    КонецЕсли;
    Если Количество < 1 ИЛИ Количество > 10 ИЛИ Количество <> Цел(Количество) Тогда
        ВызватьИсключение "Для урока нужно целое количество от 1 до 10";
    КонецЕсли;
    Результат = Ждать (Количество * 250);
    Возврат Результат;
КонецФункции

Разбор по шагам

1. Вставить весь модуль собственной формы. Обе асинхронные подпрограммы имеют &НаКлиенте: на серверный общий модуль этот код не переносится.

2. Сохранить количество в отдельный снимок до вызова. Асинхронная функция принимает его по значению; она не изменяет реквизит формы.

3. Вызов функции возвращает Обещание. Проверка ТипЗнч показывает это до использования Ждать.

4. Ждать ОбещаннаяСумма даёт уже число. Отдельное Ждать над обычным числовым выражением демонстрирует разрешённое неявное преобразование в наполненное обещание.

5. Попытка охватывает вызов и ожидание. При ошибке флаг Занято сбрасывается перед повторным исключением; успешный проход тоже сбрасывает его.

Как проверить результат

1. Начальное количество 3: четыре проверки Истина и сумма 750. Для 5 сумма 1250; нажать собственную кнопку ещё раз должно быть можно.

2. Для 0/11 расчёт должен перейти в обработчик ошибки. После исправления числа собственная кнопка снова запускает расчёт; флаг не остаётся Истина.

Ожидаемый результат

Ждать показан в правильном клиентском контексте с конкретным результатом и обработкой ошибок, без неопределённого внешнего обещания.

На что обратить внимание

1. Асинх доступен только в клиентской процедуре или функции. Ждать разрешён только внутри такой подпрограммы.

2. Этот пример не создаёт задержку, поток, фоновое задание или сетевой запрос. Наполненное значение не доказывает заметное ожидание в интерфейсе.

3. Если поле изменилось за время настоящей внешней операции, результат относится к сохранённому снимку. Перед записью рабочих данных нужна отдельная проверка актуальности.

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