process(…)

jsAPI.process(requestName: string, items: Record<string, any>, callbacks?: IAppCallback) : void

Вызов процесса, определенного ранее на стороне XRAD.
Метод jsAPI.process выполняет XHR-запрос {API_URL}/callAction и автоматически формирует параметры запроса.

Аргумент

Тип

По умолчанию

Описание

requestName

string

-

Имя запроса

items

Record<string, any>

-

Значения items, отправляемые в теле запроса {API_URL}/callAction. Допускается использовать пустой объект {} если не требуется отправки значений.

callbacks.onSuccess

string

(res: unknown) => void

Функция обратного вызова, которая сработает, если запрос завершился успешно. Принимает один аргумент - ответ сервера (res)

callbacks.onError

string

(err: unknown) => void

Функция обратного вызова, которая сработает, если запрос завершился с ошибкой. Принимает один аргумент - возникшая ошибка/ошибки (err)

// Вызов без дополнительных параметров
jsAPI.process("MY_PROCESS");

// Вызов с items
jsAPI.process("MY_PROCESS", {
    P1000_MY_ITEM_1: "Value 1",
    P1000_MY_ITEM_2: "Value 2"
});

// Вызов с items и обработчиком успешного ответа
jsAPI.process(
    "MY_PROCESS",
    {
        P1000_MY_ITEM_1: "Value 1",
        P1000_MY_ITEM_2: "Value 2"
        },
    {
        onSuccess: function(res) {
            console.log('onSuccess', res);
        }
    }
);

// Вызов с items, обработчиками успешного ответа и ошибки
jsAPI.process(
    "MY_PROCESS",
    {
        P1000_MY_ITEM_1: "Value 1",
        P1000_MY_ITEM_2: "Value 2"
    },
    {
        onSuccess: function(res) {
            console.log('onSuccess', res); // Ответ сервера
        },
        onError: function(err) {
            console.error('onError', err); // Ошибка сервера
        }
    }
);