upload_progress_json_output

Директива `upload_progress_json_output` позволяет выводить информацию о прогрессе загрузки в формате JSON.

Синтаксисupload_progress_json_output;
По умолчаниюnone
Контекстhttp, server, location
Аргументыnone

Описание

Директива upload_progress_json_output является частью модуля отслеживания прогресса загрузки NGINX, который облегчает мониторинг загрузки файлов при их передаче на backend servers. При использовании этой директивы прогресс загрузки может быть получен в формате JSON, что удобно для интеграции с JavaScript-приложениями. Этот JSON-вывод позволяет разработчикам получать подробные данные о прогрессе, которые могут отображаться на клиентских интерфейсах, чтобы информировать пользователей о состоянии загрузки. Она работает в связке с другими директивами, в частности upload_progress, которая должна быть настроена для отслеживания прогресса с указанной shared memory zone и временем ожидания. Без неё данные об отслеживании прогресса недоступны.

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

location /upload {
    upload_progress name 1m;
    upload_progress_json_output;
}

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

Ответы в формате JSON зависят от активного отслеживания загрузки; без действительного идентификатора отслеживания загрузки ответ может быть пустым.

Убедитесь, что ваше приложение корректно выполняет разбор JSON, чтобы избежать ошибок во время выполнения.

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