Что такое Web API?

Web API (или Browser API) — это набор интерфейсов, встроенных в современные веб-браузеры, которые позволяют JavaScript взаимодействовать с функциями браузера, оборудованием и операционной системой. Примеры включают Fetch API для сетевых запросов, Geolocation API для GPS-координат, WebGL для трёхмерной графики, Clipboard API для копирования/вставки и сотни других. Каждый API определяется органами веб-стандартов, такими как W3C и WHATWG, а поставщики браузеров реализуют их в собственном темпе.

Поскольку поддержка браузерами варьируется широко — некоторые API поддерживаются универсально, другие являются экспериментальными или специфичными для поставщика — разработчикам часто требуется проверить, какие API действительно доступны в данном браузере перед их использованием. Определение функций (проверка наличия API на объекте window перед его вызовом) — это стандартный подход.

Описание инструмента

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

Возможности

  • Живое определение: Проверяет каждый API для объекта window вашего браузера и мгновенно сообщает о поддерживаемом, неподдерживаемом или неизвестном статусе
  • Данные совместимости MDN: Показывает минимальную версию Chrome, Firefox, Safari и Edge, которая поддерживает каждый API, из официального пакета @mdn/browser-compat-data
  • Отметка экспериментальных API: Чётко отмечает API, которые всё ещё являются экспериментальными или находятся за флагами функций
  • Тестер пользовательских выражений: Введите любое выражение JavaScript для его вычисления в реальном времени в вашем браузере и посмотрите результат или ошибку
  • Фильтрация и поиск: Фильтруйте по статусу поддержки (поддерживается/не поддерживается/неизвестно) и ищите по названию API, чтобы быстро найти нужное

Как это работает

Инструмент загружает список записей Web API из пакета MDN Browser Compat Data во время сборки. Когда вы открываете страницу, он вычисляет каждое имя API как свойство глобального объекта window — если свойство существует и не равно null, API отмечается как поддерживаемый. Данные версии MDN предварительно загружаются и отображаются вместе с результатом живого определения.

Советы

  • Используйте фильтр статуса для отображения только API, поддерживаемых в вашем браузере — полезно для проверки доступных функций перед написанием кода.
  • Используйте поле пользовательского выражения для проверки более сложных проверок функций, таких как typeof navigator.bluetooth !== 'undefined' или 'serviceWorker' in navigator.
  • Экспериментальные API могут быть доступны в некоторых сборках браузера, но не в стабильных выпусках — всегда проверяйте документацию MDN перед использованием их в production.