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

Данные совместимости Browser API и резервные пути

Сочетайте открытые данные, проверку во время работы и безопасные резервные действия.

BotBrowser Team

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

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

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

Таблица совместимости показывает, какие версии стоит проверять, но не гарантирует защищённый контекст, разрешение пользователя или завершение операции сервером. Соедините открытые данные с проверкой прямо перед вызовом и заметным резервным действием, сохраняющим введённые данные. BotBrowser может повторить это наблюдение в разрешённом контролируемом контексте, но не выдаёт разрешение и не доказывает удалённый результат. Так решение воспроизводимо и не требует профиля или содержимого аккаунта.

Нейтральная схема от данных совместимости через проверку возможности к основному или резервному действию

Кратко

  • Используйте MDN Browser Compatibility Data и соответствующий стандарт W3C или WHATWG; указывайте дату ревизии.
  • Проверяйте возможность непосредственно перед действием. Наличие свойства не доказывает успех вызова.
  • Сохраняйте доступный с клавиатуры резервный путь и введённые данные; объясняйте отличия.
  • Разделяйте возможность браузера, разрешение, подтверждение приложения и результат сервера.
  • BotBrowser повторяет разрешённый синтетический сценарий в контролируемом контексте, но не выдаёт разрешения и не подтверждает удалённую транзакцию.

Содержание

Читать данные как свидетельство

Возможность платёжного интерфейса служит конкретным примером: Payment Request API: согласие и безопасный запасной путь применяет эту модель к canMakePayment() и обычному оформлению заказа.

MDN Browser Compatibility Data содержит версии, заметки, флаги, защищённый контекст и частичную поддержку. Читайте заметки вместе с ячейками. Стандарт HTML WHATWG и WebAuthn W3C задают нормативные условия. Руководство MDN по проверке возможностей рекомендует проверку во время работы вместо разбора user-agent. О функциях, которые остаются экспериментальными или доступны только в пробном режиме, рассказывает материал Origin Trials и экспериментальные функции Web Platform.

Для каждой API запишите происхождение и контекст, метод, состояния разрешения и исключений, видимый сигнал успеха и владельца резервного пути. Метод может существовать, но отклониться из-за политики, отмены или отсутствия активации. Разрешённая promise также может предшествовать ошибке сервера; храните эти наблюдения раздельно. Чем наличие функции отличается от её качества, объясняет материал Поддержка функции браузером не равна качеству функции.

Проектировать решение о возможности

НаблюдениеРешениеВидимый результатГраница
Метод и контекст доступныПопробовать один разПоказать прогресс и отменуБраузер
Метод отсутствует или контекст блокируетРезервный путьСохранить задачу и объяснить отличиеКонтекст
Разрешение отклонено или отмененоПредложить резервный путь без циклаСохранить контроль и вводРазрешение
Вызов выбросил ошибкуКлассифицировать и остановитьВосстановимая ошибка и действиеВыполнение
Вызов завершёнПроверить подтверждение приложенияПодтвердить наблюдаемый результатБраузер + приложение

Проверяйте прямо перед действием: фокус, разрешение и состояние меняются. Не разбирайте user-agent и не выводите тип устройства. Резервный путь должен сохранять задачу и работать с клавиатурой и ассистивными технологиями.

Проверять резервный путь fixture

Fixture ниже покрывает отсутствие метода и отклонённую promise. Подменяйте только navigator.share, очищайте DOM и проверяйте статус и кнопку. Ожидается completed без резервного пути либо missing/denied/failed с кнопкой «Копировать ссылку». Это проверка ветвления интерфейса, а не универсальной поддержки или сервиса.

async function shareOrCopy() {
  const host = document.createElement('div');
  host.innerHTML = '<p id="status" role="status"></p><button id="fallback" hidden>Копировать ссылку</button>';
  document.body.append(host);
  const status = host.querySelector('#status');
  const fallback = host.querySelector('#fallback');
  if (typeof navigator.share !== 'function') {
    fallback.hidden = false;
    status.textContent = 'Используйте резервный путь';
    const r = { state: 'missing', action: 'copy-link' };
    host.remove();
    return r;
  }
  try {
    await navigator.share({ title: 'Синтетический элемент', url: '/fixture' });
    status.textContent = 'Отправлено';
    const r = { state: 'completed', action: 'none' };
    host.remove();
    return r;
  } catch (error) {
    fallback.hidden = false;
    status.textContent = 'Используйте резервный путь';
    const r = { state: error?.name === 'NotAllowedError' ? 'denied' : 'failed', action: 'copy-link' };
    host.remove();
    return r;
  }
}

Добавьте ограниченный тайм-аут и очистку в finally. Проверяйте сообщение, фокус и сохранённый ввод; не меняйте посторонние свойства браузера. О том, как тесты платформы дополняют такие проверки, рассказывает материал Web Platform Tests для уверенности в возможностях браузера.

Прогрессивное улучшение и приватность

Начните с основной задачи: обычный input файла, выбираемый URL, текстовый адрес, семантическая форма или резюме часто работают без дополнительной API. При отказе Share предложите копирование или почту без скрытого повторного запроса. При отмене WebAuthn оставьте путь пароля. Доступность является частью совместимости: объявляйте статус, переносите фокус и подписывайте действие. Храните только feature, ревизию источника, контекст, состояние, результат, резервный путь и дату; исключайте учётные данные, местоположение и снимки.

Применение правила к распространённым API.

Для Web Share копирование ссылки или почтовый редактор сохраняют задачу, если метод отсутствует, нет временной активации или человек отменил действие. Для API буфера обмена отклонённая promise может означать политику разрешений или потерю фокуса; оставьте текст выбираемым и дайте явную кнопку. Для Geolocation предложите введённый адрес или поиск на карте и различайте небезопасный контекст, отказ и тайм-аут. Для File System Access сохраняйте <input type="file"> и объясняйте, что резервный путь отправляет копию, а не даёт постоянный доступ. Для WebAuthn различайте неподдерживаемый аутентификатор, отмену и отказ сервера, сохраняя вход по паролю.

Детерминированные fixture и журнал.

Fixture должна иметь синтетический origin, цель и видимый результат. Подменяйте только собственную поверхность, сбрасывайте DOM и используйте /fixture. Записывайте missing, denied, failed или completed; тайм-аут не превращайте в «не поддерживается». Проверяйте статус, фокус, подпись и сохранение ввода. После успешного вызова при необходимости запрашивайте тестовый endpoint приложения, сохраняя браузерное наблюдение и подтверждение отдельно.

В журнале нужна строка на API: источник и ревизия, версии, защищённый контекст, ожидаемое разрешение, fixture, состояние, резервное действие и владелец. Пересматривайте запись после выпуска браузера, изменения политики, обновления framework или исправления доступности. Храните нормализованные состояния, а не идентификаторы, учётные данные, координаты или неотредактированные снимки.

Полномочия, доступность и решение.

Браузер сообщает возможность и разрешение; транспорт сообщает о доставке ответа; приложение решает авторизацию и смысл записи; хранилище решает срок хранения. Указывайте полномочия рядом с каждым утверждением. Проверьте клавиатурой: активируйте основной элемент, вызовите отсутствие или отказ и убедитесь в видимом фокусе резервного элемента. Статус не должен зависеть только от цвета.

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

Возможности и ограничения BotBrowser

BotBrowser может запустить разрешённую fixture в изолированном контексте и сравнить видимые ветви между заявленными версиями. Это удобно для HTTPS, отказа разрешения, отклонённой promise и клавиатурного резервного пути. Он не может выдать разрешение или подтвердить удалённую запись. Фиксируйте профиль, версию, origin, ревизию fixture и видимое утверждение.

BotBrowser не делает небезопасный origin безопасным, не выдаёт разрешения, не отменяет политику ОС и не гарантирует API на каждом origin. Успешный вызов не доказывает запись на сервере или завершение операции. Сопоставляйте наблюдение с подтверждением приложения и не меняйте профиль из-за отсутствующей возможности.

См. также события WebDriver BiDi и автоматизацию и Credential Management для входа.

Итог

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

FAQ

Зелёная ячейка гарантирует результат?

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

Нужно ли повторять каждый отказ?

Нет. Классифицируйте отмену и отказ; повторяйте только при ограниченном правиле идемпотентности.

BotBrowser доказывает удалённую операцию?

Нет. Он доказывает наблюдение браузера; подтверждение даёт сервис-владелец.

Что записывать в журнал?

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

Источники

#Browser API#Совместимость#Проверка#Прогрессивное Улучшение#Fallback

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

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

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