js_import

Директива `js_import` интегрирует модули JavaScript в конфигурацию NGINX, позволяя импортировать скрипты NJS.

Синтаксисjs_import string; | js_import string string string;
По умолчаниюnone
Контекстstream, stream server
Аргументы1 or 3

Описание

Директива js_import — мощная возможность модуля JavaScript (NJS) в NGINX, которая позволяет пользователям импортировать JavaScript-файлы и модули непосредственно в их конфигурации NGINX. Эта директива облегчает повторное использование функций JavaScript, позволяя применять модульную архитектуру для обработки различных задач веб-сервера, таких как обработка запросов, фильтрация и формирование ответов. Она поддерживает один или три аргумента, что обеспечивает гибкость конфигурации в зависимости от сценария использования.

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

Принцип работы js_import тесно связан с существующими возможностями NJS, который предназначен для расширения функциональности NGINX с помощью синтаксиса JavaScript. Поэтому импортированные скрипты могут использовать полный набор возможностей NJS, включая поддержку ECMAScript 5.1 и более новых конструкций, что обеспечивает богатые и современные возможности для скриптинга операций NGINX.

Пример конфига

js_import my_script.js;

# or with parameters:
js_import my_script.js my_module myFunction;

Убедитесь, что путь к файлу JavaScript указан правильно относительно каталога конфигурации NGINX.

Если вы используете несколько импортов, следите за конфликтами имён между функциями или переменными.

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

← Ко всем директивам