Атрибут decoding (от английского decoding, «декодирование») подсказывает браузеру, как превращать файл картинки в пиксели: вместе с показом страницы или отдельно от него. Закрывающий тег для него не нужен: атрибут пишется внутри открывающего тега, например decoding="async", а у самого <img> закрывающего тега нет.
У атрибута три значения: sync, async и auto. Главное, что нужно знать сразу: это именно подсказка, и её эффект в обычной вёрстке трудно заметить. Я сравнил все три значения на картинке 6000 на 6000 пикселей и не увидел разницы, поэтому в статье нет обещаний вроде «страница станет быстрее». Зато есть полезный метод decode(), о котором тоже расскажу.
<img src="photo.jpg" alt="Фото"
width="800" height="600"
decoding="async">
В этой статье
- Что такое атрибут decoding в HTML и зачем он нужен
- Для каких тегов работает decoding: img и SVG image
- Какие значения принимает decoding: sync, async и auto
- Что на самом деле меняет decoding
- Метод decode(): дождаться картинки перед показом
- Когда decoding нужен и когда его можно не писать
- Decoding в JavaScript: свойство decoding и new Image()
- Частые ошибки в атрибуте decoding
- Шпаргалка по атрибуту decoding
Что такое атрибут decoding в HTML и зачем он нужен
Файл картинки (JPEG, PNG, WebP) хранит сжатые данные. Прежде чем показать картинку, браузер разворачивает их в пиксели. Эта работа называется декодированием, и для больших картинок она заметна. Атрибут decoding подсказывает, как её выполнить: вместе с остальной отрисовкой страницы или отдельно.
Важно, чем decoding не является. Он не меняет момент скачивания файла: за это отвечает loading. Не меняет и размер картинки: его задают width и height. Он касается только последнего шага, когда файл уже на месте.
sync: расшифровать вместе с показом, содержимое ждёт картинку.async: расшифровать отдельно, остальное содержимое не ждёт картинку.auto: решение за браузером. Так работает любая картинка без атрибута.
Для каких тегов работает decoding: img и SVG image
Атрибут есть у тега <img> и у элемента image внутри <svg>. Свойство decoding у этих двух элементов существует, а у остальных тегов нет: я проверил <iframe>, <video>, <picture>, <source>, <input>, <object>, <canvas> и <embed>.
| Тег | Что делает decoding | Пример записи |
|---|---|---|
<img> | Подсказывает, как декодировать картинку | <img src="a.jpg" alt="Кот" decoding="async"> |
image внутри <svg> | То же для картинки внутри SVG | <image href="a.png" width="100" height="100" decoding="async"/> |
Если картинка расположена внутри <picture>, атрибут пишут у вложенного img. Обычное место атрибута рядом с src и alt.
Какие значения принимает decoding: sync, async и auto
Допустимы три значения. Остальные браузер не принимает: страницу они не ломают, но атрибут будет считаться равным auto. Ниже результаты проверки свойства img.decoding в браузере, на котором я проверял.
| Запись | Свойство img.decoding | Пример записи |
|---|---|---|
sync | sync | decoding="sync" |
async | async | decoding="async" |
auto | auto | decoding="auto" |
ASYNC, Async | async: регистр не важен | decoding="ASYNC" |
async с пробелом в начале | auto: пробел делает значение неверным | decoding=" async" |
| Пустое значение | auto | decoding="" |
| Любой другой текст | auto | decoding="garbage" |
Если атрибута нет совсем, свойство тоже возвращает auto. Это значение по умолчанию, поэтому писать decoding="auto" незачем: оно ничего не меняет.
Пример: какие значения decoding принимает браузер
Выберите значение и посмотрите, что записано в атрибуте и что вернуло свойство. Строка «По стандарту» показывает, допустима ли запись.
Свойство возвращает ваш браузер, результат может отличаться от моих замеров. Картинка создаётся прямо в демонстрации.
Что на самом деле меняет decoding
Теоретически разница понятна: при async браузер может показать текст и остальные элементы, не дожидаясь расшифровки большой картинки. На практике браузер волен выбрать иное, поэтому эффект зависит от него.
Я проверил это замером. На странице появлялась картинка 6000 на 6000 пикселей, а скрипт измерял самый длинный перерыв между кадрами. В браузере, на котором я проверял, получилось: для sync, async и auto самый длинный перерыв составил около 400 миллисекунд. Разницы между значениями я не увидел. Из этого не следует, что атрибут бесполезен: на других картинках, в других браузерах и на слабых устройствах результат может быть иным. Но обещать ускорение нельзя.
| Атрибут | На какой вопрос отвечает | Пример записи |
|---|---|---|
loading | Когда скачивать файл: сразу или когда понадобится | loading="lazy" |
decoding | Как превращать скачанный файл в пиксели | decoding="async" |
width и height | Какого размера оставить место под картинку | width="800" height="600" |
Если вы хотите ускорить страницу, начните с этих трёх соседей и со сжатия файла. decoding оставьте напоследок: в одиночку он редко что-то меняет. Подробности о подходе описаны в статье Tune The Web.
Метод decode(): дождаться картинки перед показом
У самой картинки в JavaScript есть метод decode(). Он возвращает промис, который завершается, когда файл загружен и расшифрован. Метод полезен, когда нужно вставить картинку на страницу сразу готовой, без рывка.
| Ситуация | Что получилось | Пример записи |
|---|---|---|
| Верный файл | Промис завершился, naturalWidth уже больше нуля | await img.decode() |
| Битый адрес | Ошибка EncodingError | img.src = 'missing.png' |
Нет src | Ошибка EncodingError | new Image().decode() |
Смена src во время ожидания | Ошибка EncodingError | img.src = 'other.png' |
| Повторный вызов | Работает, оба промиса завершаются | img.decode(); img.decode(); |
| Картинка уже вставлена в страницу | Работает так же | document.body.append(img); await img.decode(); |
Ошибку нужно обрабатывать: без catch битая картинка превратится в необработанную ошибку в консоли.
const img = new Image();
img.src = 'photo.jpg';
img.decode()
.then(() => box.append(img))
.catch(() => console.log('Не вышло'));
Пример: показ картинки сразу и через decode()
Выберите файл и способ показа. Строка про naturalWidth показывает, готова ли картинка в момент вставки.
Время и размеры считает ваш браузер. Для верного файла результат почти мгновенный, потому что файл создан на этой же странице.
Когда decoding нужен и когда его можно не писать
Большинству картинок атрибут не нужен: значение по умолчанию подходит. Он имеет смысл в нескольких случаях.
| Случай | Что записать | Пример записи |
|---|---|---|
| Лента или галерея с большими картинками | async | <img src="a.jpg" alt="" width="800" height="600" decoding="async"> |
| Большая картинка, добавляемая скриптом | Метод decode() перед вставкой | img.decode().then(() => box.append(img)) |
| Картинка и текст должны появиться вместе | sync | <img src="a.jpg" alt="" decoding="sync"> |
| Маленькие значки и логотипы | Ничего не писать | <img src="logo.svg" alt="Лого"> |
| Остальные случаи | Ничего не писать | <img src="a.jpg" alt=""> |
Это рекомендации по смыслу, а не результат замеров: измеримой разницы я не получил. Ориентир простой: писать async там, где картинок много и они большие, а во всём остальном полагаться на значение по умолчанию.
Decoding в JavaScript: свойство decoding и new Image()
Атрибут доступен как свойство decoding у картинки. Запись в свойство меняет атрибут, а чтение приводит значение к допустимому.
| Действие | Что получилось | Пример записи |
|---|---|---|
| Чтение без атрибута | Вернулось auto | img.decoding |
| Запись допустимого значения | Атрибут в разметке изменился | img.decoding = 'async' |
| Запись неверного значения | Атрибут записан как есть, а свойство возвращает auto | img.decoding = 'junk' |
У картинки, созданной скриптом через new Image(), свойство записывают так же. Рядом с ним обычно задают width и height, как для любой картинки.
const img = new Image();
img.decoding = 'async';
img.width = 800;
img.height = 600;
img.src = 'photo.jpg';
console.log(img.decoding); // "async"
Частые ошибки в атрибуте decoding
Большинство ошибок связано с тем, что от decoding ждут слишком многого или путают его с соседним loading.
| Ошибка | Что происходит | Как исправить |
|---|---|---|
decoding="fast", decoding="true" | Неизвестное значение читается как auto | Писать только sync, async или auto |
decoding=" async" | Пробел делает значение неверным, свойство возвращает auto | Писать без пробелов |
decoding="auto" | Это и так значение по умолчанию, запись ничего не меняет | Убрать атрибут |
Ждут, что async ускорит скачивание | Атрибут не влияет на скачивание, только на последний шаг | Для отложенной загрузки использовать loading |
Путают decoding="async" и loading="lazy" | Первое про декодирование, второе про момент скачивания | Разделять задачи: один атрибут на один вопрос |
Ждут от async заметного эффекта | В моём замере разницы между значениями не было | Считать значение подсказкой, не гарантией |
decoding="async" у каждого значка | Для маленьких файлов выгоды нет | Оставить значение по умолчанию |
new Image().decode() до присвоения src | Ошибка EncodingError | Сначала записать src, потом вызвать decode() |
Не обработали ошибку decode() | Для битого адреса появляется необработанная ошибка | Добавить catch |
Меняют src, пока decode() ждёт | Ожидание завершается ошибкой EncodingError | Вызывать decode() заново после смены |
decoding у picture, source или iframe | У этих тегов такого атрибута нет | Записать атрибут у вложенного img |
img.decoding = 'junk' | Атрибут остаётся junk, а свойство возвращает auto | Записывать только допустимые значения |
Шпаргалка по атрибуту decoding
Всё главное из статьи в одной таблице.
| Задача | Как записать | Пример записи |
|---|---|---|
| Декодировать отдельно от показа | Значение async | <img src="a.jpg" alt="" decoding="async"> |
| Декодировать вместе с показом | Значение sync | <img src="a.jpg" alt="" decoding="sync"> |
| Оставить выбор браузеру | Без атрибута | <img src="a.jpg" alt=""> |
| Допустимые значения | Три значения без пробелов | sync | async | auto |
| Вставить картинку готовой | Метод decode() | img.decode().then(() => box.append(img)) |
| Обработать ошибку | catch у промиса | img.decode().catch(() => {}) |
| Прочитать значение | Свойство decoding | img.decoding |
| Не путать | loading отвечает за скачивание | loading="lazy" |