Назад в Центр знаний
Платформа

Network Information API для адаптивного контента

Используйте необязательные сетевые подсказки для обратимого выбора ресурсов с учётом стандартов, приватности и границ BotBrowser.

BotBrowser Team

Документация

Нужна структурированная документация по теме Платформа?

Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.

WICG и MDN описывают Network Information API как необязательную приблизительную подсказку браузера через navigator.connection, а не как тест пропускной способности или идентификатор. BotBrowser может настроить сообщаемые RTT и downlink в профиле, но не гарантирует реальную скорость маршрута или универсальную доступность API. Надёжный ответ: сначала отрисовать полный базовый вариант, проверить каждое свойство и сделать необязательные изменения обратимыми.

Кратко

  • Считайте effectiveType, rtt, downlink и saveData оценками или предпочтениями.
  • Обязательный контент, разрешения и решения аккаунта не должны зависеть от API.
  • Используйте политики baseline и reduced, измеряйте результат и предусматривайте восстановление.
  • Объясняйте заметные изменения, уважайте явный выбор и не храните исходные значения.
  • BotBrowser задаёт сообщаемые значения для тестов, но не моделирует физическую пропускную способность.

Содержание

Схема с резервным режимом для выбора адаптивного контента по сетевым подсказкам

Что предоставляет API

NetworkInformation может предоставлять effectiveType, rtt, downlink, saveData и иногда type. Первое группирует условия как slow-2g, 2g, 3g и 4g; следующие два являются оценками; saveData выражает просьбу сократить расход данных. W3C/WICG определяет интерфейс, а MDN описывает доступность. Значения могут быть округлены, устареть, отсутствовать или измениться.

Считайте API необязательной возможностью. При отсутствии объекта, undefined, типе unknown или неожиданном значении обязательный текст, элементы управления и навигация должны оставаться доступными. Не делайте выводов о стране, устройстве, личности или гарантированной скорости по одной категории.

Обратимое правило решения

Начните с политики, работающей без подсказок. Называйте поведение, а не предполагаемый класс устройства, и ставьте явный выбор пользователя выше оценки.

const connection = navigator.connection;
const reduced = Boolean(
  connection && (connection.saveData || connection.effectiveType === 'slow-2g' || connection.effectiveType === '2g')
);
const policy = reduced ? 'reduced' : 'baseline';
// Только обратимая необязательная работа; обязательный контент загружается.
ВопросПравилоОжидаемый резерв
Предзагружать необязательную статью?Временно использовать saveData или осторожный тип.Пропустить предзагрузку, оставить ссылку.
Запускать автопросмотр?Учесть политику, настройку воспроизведения и состояние страницы.Показать постер и кнопку запуска.
Доставлять обязательный документ?Никогда не блокировать его этой API.Загрузить и объяснить улучшения.

4g не гарантирует завершение большой передачи, а отсутствие значения не доказывает медленную сеть. Наблюдайте завершение, ошибки декодирования, отмену, задержку ввода и восстановление реального запроса.

Изменения, приватность и резервный режим

Объект может отправлять change. Используйте событие для паузы или отмены ожидаемого улучшения, но не удаляйте доступный контент. Применяйте debounce, ограничивайте повторы, снимайте слушатели при уничтожении и предлагайте ясный повтор. Сохраняйте введённые данные, размеры макета, клавиатурный доступ и доступные статусы загрузки.

Сетевые подсказки могут усиливать отпечаток вместе с другими сигналами. Используйте их временно и предпочитайте метку reduced исходным rtt, downlink и effectiveType в идентификаторах, долгих журналах и аналитике. Уменьшенное изображение или отложенная предзагрузка не дают разрешения собирать больше данных. Обязательные запросы, разрешения и аккаунты независимы. Подробнее о том, что раскрывают эти подсказки и как предусмотреть резервный режим без них, см. Network Information API: приватность и резервный режим.

Адаптивные изображения, отложенная загрузка, обратное давление потоков, ограниченные кэши, отмена и серверный базовый HTML полезны без API. Объясняйте существенную стоимость до передачи и позволяйте запросить полное разрешение.

Тесты и границы BotBrowser

Проверьте отсутствие navigator.connection, частичные свойства, saveData: true и событие change во время прерванной необязательной передачи. Отдельно проверьте unknown. Убедитесь, что текст, клавиатура и восстановление работают без бесконечных повторов.

BotBrowser поддерживает профильные политики сообщаемых значений, включая RTT и downlink, чтобы проверить реакцию приложения. Это меняет значения браузера в тестовом контексте; не меняет пропускную способность прокси, не измеряет физический маршрут, не гарантирует API и не определяет классификацию сайта.

Используйте спецификацию Network Information, справочник MDN NetworkInformation и обзор API MDN. См. также руководства об отпечатке Network Information и Client Hints.

Итог

Используйте Network Information как временный вход обратимой политики ресурсов. Сохраняйте полный базовый вариант, уважайте намерение пользователя, измеряйте реальный запрос и храните минимум доказательств. Следующий шаг: запустите пример при отсутствии API до включения адаптивного улучшения.

Частые вопросы

Нет. Это округлённая и изменчивая оценка, на которую влияет другой трафик. Надёжнее результат реального запроса.

Каково следующее безопасное действие?

Добавьте проверку возможности, базовую фикстуру и один ограниченный повтор. До сбора метрик получите проверку доступности и приватности.

Как восстановить отменённое улучшение?

Сохраните базовый контент и покажите одну кнопку повтора. Не перезагружайте страницу на каждое изменение оценки.

Как обращаться с кэшем?

Используйте явный вариант продукта, а не подробный сетевой отпечаток как ключ. Без подсказки должна быть полная выдача.

Когда пересматривать политику?

После смены браузера, набора медиа или нагрузки. Повторите тесты отсутствия API, частичных свойств, unknown, saveData и прерванной передачи.

Отсутствие API требует уменьшить контент?

Нет. Это неизвестное состояние. Сохраняйте базовый вариант и уменьшайте только объяснимую обратимую необязательную работу.

Гарантирует ли BotBrowser медленный или быстрый маршрут?

Нет. Он задаёт сообщаемые значения для тестов, но не физическую скорость, прокси, универсальную доступность или ответ сайта.

Что записывать?

Политику, версию нагрузки, завершение, отмену и восстановление. Избегайте исходных значений и удаляйте временную диагностику.

Источники

#Network Information API#Адаптивный Контент#effectiveType#Веб-Производительность#Приватность

Эта статья входит в руководство: Поверхности веб-платформы: карта проверки

Выполните ту же проверку в BotBrowser

Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.