4. Предобработка Javascript

Обзор

В этом разделе приведены сведения о предварительной обработке при помощи JavaScript.

Предобработка Javascript

Предобработка JavaScript выполняется путём вызова функции JavaScript с единственным параметром «value» и заданным пользователем телом функции. Результатом шага предобработки является значение, которое возвращается из этой функции, например, для выполнения конвертации из градусов Фаренгейта в градусы Цельсия пользователю необходимо ввести:

return (value - 32) * 5 / 9

Это будет обёрнуто сервером в функцию JavaScript :

function (value)
       {
          return (value - 32) * 5 / 9
       }

Входной параметр «value» всегда передаётся как строка. Возвращаемое значение автоматически приводится к строке через метод ToString() (если он завершится с ошибкой, тогда эта ошибка возвращается в виде строкового значения), с несколькими исключениями:

• возврат неопределённого значения приведёт к ошибке
• возврат значения null приведет к тому, что входящее значение будет отброшено, очень похоже на предварительную обработку «Отбросить значение» на действие «Другое при ошибке».

Ошибки можно вернуть при помощи выбрасывания значений/объектов в качестве исключений (обычно это строки или объекты ошибок).

Например:

if (value == 0)
           throw "Zero input value"
       return 1/value

У каждого скрипта есть 10-секундный тайм-аут — время ожидания выполнения (в зависимости от скрипта, срабатывание тайм-аута может занять более длительное время); превышение времени ожидания вернёт ошибку. Также применяется ограничение heap памяти в 512 мегабайт (64 мегабайта до версии 6.0.19).

Байт-код шага предобработки JavaScript кэшируется и используется повторно, когда шаг применяется в следующий раз. Любые изменения в шагах предварительной обработки элемента данных вызовут сброс закэшированного скрипта и затем его перекомпиляцию.

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

Предобработка JavaScript реализована при помощи механизма JavaScript Duktape (https://duktape.org/).

Смотрите также: Дополнительные объекты и глобальные функции JavaScript

Использование макросов в скриптах

В коде JavaScript можно использовать пользовательские макросы. Если скрипт содержит пользовательские макросы, эти макросы раскрываются сервером/прокси до выполнения конкретных шагов предварительной обработки. Обратите внимание, что при тестировании шагов предварительной обработки в веб-интерфейсе, значения макросов не извлекаются автоматически и их нужно указывать вручную.

В примере ниже, если полученное значение превышает значение макроса {$THRESHOLD}, то вместо самого значения возвращается значение порога (если присутствует):

var threshold = '{$THRESHOLD}';
       return (!isNaN(threshold) && value > threshold) ? threshold : value;