`<meta http-equiv>` атрибут HTML

Baseline Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и во многих версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Атрибут http-equiv элемента <meta> позволяет задавать инструкции по обработке для браузера так, как если бы в ответе, содержащем документ, присутствовали определённые HTTP-заголовки. Эти метаданные являются метаданными уровня документа и применяются ко всей странице.

Если у элемента <meta> есть атрибут http-equiv, атрибут content задаёт соответствующее значение http-equiv. Например, следующий тег <meta> сообщает браузеру, что страницу нужно обновить через 5 минут:

<meta http-equiv="Refresh" content="300" />

Значение

В качестве значений http-equiv поддерживается только часть HTTP-заголовков. К ним относятся:

content-language

Задаёт язык документа по умолчанию, который используется вспомогательными технологиями или браузером при стилизации. Аналогичен HTTP-заголовку Content-Language. Вместо него используйте атрибут lang.

content-type

Объявляет тип мультимедиа (MIME-тип) и кодировку символов документа. Если указан атрибут content, его значение должно быть "text/html; charset=utf-8". Это эквивалентно элементу <meta> с указанным атрибутом charset и имеет те же ограничения на размещение в документе. Может использоваться только в документах, обслуживаемых с типом мультимедиа text/html, но не в документах с типом XML (application/xml или application/xhtml+xml). См. HTTP-заголовок Content-Type.

content-security-policy

Позволяет авторам страниц задавать политику безопасности содержимого (CSP) для текущей страницы, обычно чтобы указать разрешённые источники и конечные точки скриптов для защиты от атак с межсайтовым скриптингом. См. HTTP-заголовок Content-Security-Policy.

default-style

Задаёт имя набора таблиц стилей CSS по умолчанию.

refresh

Эквивалентен HTTP-заголовку Refresh. Эта инструкция задаёт:

Количество секунд до перезагрузки страницы, если атрибут content содержит неотрицательное целое число.
Количество секунд до перенаправления страницы на другой URL, если атрибут content содержит неотрицательное целое число, за которым следуют ;url= и действительный URL.

Отсчёт начинается после полной загрузки страницы, то есть после срабатывания событий load и pageshow. Подробнее см. раздел Вопросы доступности.

set-cookie

Устанавливает cookie для документа. Современные браузеры игнорируют эту директиву; вместо неё используйте HTTP-заголовок ответа Set-Cookie или document.cookie.

x-ua-compatible

Использовался устаревшими версиями снятого с поддержки браузера Microsoft Internet Explorer, чтобы он точнее следовал заданному поведению. Если атрибут content указан, его значение должно быть "IE=edge". Современные пользовательские агенты игнорируют эту директиву. Её название происходит от HTTP-заголовка X-UA-Compatible.

Предупреждение: Некоторые браузеры обрабатывают дополнительные заголовки, не перечисленные выше. Неизвестные заголовки и недопустимые значения игнорируются, что может привести к непоследовательному поведению в разных браузерах. В частности, не задавайте другие заголовки безопасности с помощью <meta http-equiv=, так как это может создать ложное ощущение защищённости!

Вопросы доступности

При использовании значения http-equiv="Refresh" интервал обновления страницы может оказаться слишком коротким. Люди, которые пользуются вспомогательными технологиями, например программой чтения с экрана, могут не успеть прочитать и понять содержимое страницы до автоматического перенаправления. Внезапные необъявленные обновления страницы также могут дезориентировать людей с нарушениями зрения.

Примеры

Отключение небезопасного встроенного кода и разрешение только ресурсов HTTPS

Этот HTML-элемент <meta> задаёт CSP по умолчанию, разрешающую загружать ресурсы (изображения, шрифты, скрипты и т. д.) только через HTTPS. Поскольку директивы unsafe-inline и unsafe-eval не заданы, встроенные скрипты будут заблокированы:

<meta http-equiv="Content-Security-Policy" content="default-src https:" />

Те же ограничения можно задать с помощью HTTP-заголовка Content-Security-Policy:

Content-Security-Policy: default-src https:

Настройка перенаправления страницы

В следующем примере используется http-equiv="refresh", чтобы указать браузеру выполнить перенаправление. Атрибут content="3;url=https://www.mozilla.org" перенаправит страницу на https://www.mozilla.org через 3 секунды:

<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

Спецификации

Спецификация
HTML> # attr-meta-http-equiv>

Совместимость с браузерами

	Компьютеры					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome для Android	Firefox для Android	Opera для Android	Safari для iOS	Samsung Internet	WebView для Android	WebView для iOS
`http-equiv`	1	12	1	≤12.1	≤4	18	4	≤12.1	≤3.2	1.0	4.4	≤3.2
`content-language`	≤59	12	1	≤46	≤10.1	≤59	4	≤43	≤10.3	≤7.0	≤59	≤10.3
`content-security-policy`	≤59	12	1	≤46	≤10.1	≤59	4	≤43	≤10.3	≤7.0	≤59	≤10.3
`content-type`	≤59	12	1	≤46	≤10.1	≤59	4	≤43	≤10.3	≤7.0	≤59	≤10.3
`refresh`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4	1

См. также

<meta name="referrer">
Метаданные: элемент <meta>
Предотвращение атак с помощью <meta> httparchive.org (2022)

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/meta/http-equiv

<meta http-equiv> атрибут HTML