upload_progress_jsonp_parameter
Директива `upload_progress_jsonp_parameter` задаёт имя параметра JSONP, используемого для возврата информации о прогрессе загрузки в формате JSONP.
Описание
Директива upload_progress_jsonp_parameter используется в модуле отслеживания прогресса загрузки NGINX для задания имени параметра запроса, который будет использоваться для JSONP-колбэков. Когда приложение на стороне клиента делает запрос для получения прогресса загрузки, оно может включить этот параметр в URL запроса. NGINX распознаёт параметр и форматирует данные ответа соответствующим образом, позволяя выполнить ответ как вызов JavaScript-функции, тем самым обеспечивая плавный опыт мониторинга прогресса загрузки в приложениях, которым требуется JSONP для запросов между доменами.
Директиву необходимо определить в соответствующем контексте, например внутри блоков http, server или location, в зависимости от того, где требуется отслеживание прогресса загрузки. Типовой шаблон использования позволяет разработчикам настраивать имя параметра колбэка по мере необходимости для клиентского приложения. Значение, задаваемое этой директивой, должно быть строкой, указывающей желаемое имя для параметра JSONP, например 'callback', что даёт клиентам возможность получать форматированные отчёты о прогрессе непосредственно в указанные функции-обработчики.
Важно убедиться, что имя параметра, определённое в этой директиве, совпадает с тем, которое ожидает приложение на стороне клиента, чтобы избежать проблем с получением обновлений о прогрессе загрузки. Эта директива работает совместно с общей системой отчётности о прогрессе загрузки, предлагаемой NGINX, которая использует общую память и событийно-ориентированную модель для эффективного отслеживания состояния и прогресса загрузок.
Пример конфига
location /upload {
track_uploads my_zone 10s;
upload_progress_jsonp_parameter callback;
}Убедитесь, что имя параметра совпадает с тем, что ожидает клиентское приложение, чтобы избежать проблем с тем, что JSONP callback не срабатывает.
Не забудьте включить директиву track_uploads в том же или родительском контексте, чтобы обеспечить отслеживание прогресса загрузки.