Что такое заголовок Content-Disposition и для чего он нужен?

Что такое Content-Disposition?

Content-Disposition — это HTTP-заголовок ответа, который определяет, как браузер должен обрабатывать передаваемое содержимое. Он особенно полезен при скачивании файлов, так как позволяет серверу указать, что ответ нужно сохранить как файл, а не отобразить в окне браузера.

Основные значения

• inline — содержимое отображается в браузере (например, PDF или изображение).
• attachment — браузер предлагает скачать файл, часто с указанием имени через параметр filename.

Пример использования

На сервере (Node.js с Express) можно задать заголовок так:

app.get('/download', (req, res) => {
  const file = 'report.pdf';
  res.setHeader('Content-Disposition', `attachment; filename="${file}"`);
  res.sendFile(file);
});

Это заставит браузер скачать файл с именем report.pdf.

Где применяется

Заголовок используется в веб-приложениях для управления загрузкой файлов, экспорта данных (CSV, PDF) и предотвращения отображения бинарных данных в браузере. Он также важен для безопасности, так как помогает избежать инлайн-отображения потенциально опасных файлов.

Вывод: Content-Disposition необходим для корректной обработки файлов на клиенте, особенно когда нужно принудительно скачать файл или задать его имя. Применяйте его в любом API, где требуется передача файлов.