Co to jest Web API?

Web API (lub Browser API) to zbiór interfejsów wbudowanych w nowoczesne przeglądarki internetowe, które pozwalają JavaScript'owi na interakcję z funkcjami przeglądarki, sprzętem i systemem operacyjnym. Przykłady obejmują Fetch API do żądań sieciowych, Geolocation API do współrzędnych GPS, WebGL do grafiki 3D, Clipboard API do kopiowania/wklejania i setki innych. Każdy API jest definiowany przez organy stanowiące standardy internetowe, takie jak W3C i WHATWG, a dostawcy przeglądarek wdrażają je we własnym tempie.

Ponieważ wsparcie przeglądarek jest bardzo zróżnicowane — niektóre API są powszechnie obsługiwane, inne są eksperymentalne lub specyficzne dla dostawcy — deweloperzy często muszą sprawdzić, które API są faktycznie dostępne w danej przeglądarce przed ich użyciem. Detekcja funkcji (sprawdzenie, czy API istnieje na window przed jego wywołaniem) to standardowe podejście.

Opis narzędzia

To narzędzie testuje, które Web API są dostępne w Twojej bieżącej przeglądarce w czasie rzeczywistym. Łączy żywą detekcję przeglądarki z danymi kompatybilności przeglądarki z MDN, aby dać Ci kompleksowy przegląd tego, które API są obsługiwane, w której wersji stały się dostępne i czy któreś z nich są jeszcze eksperymentalne.

Funkcje

  • Detekcja na żywo: Testuje każde API względem obiektu window Twojej rzeczywistej przeglądarki i natychmiast raportuje status obsługiwanego, nieobsługiwanego lub nieznanego
  • Dane kompatybilności MDN: Pokazuje minimalną wersję Chrome'a, Firefox'a, Safari'ego i Edge'a, która obsługuje każde API, pochodzące z oficjalnego pakietu @mdn/browser-compat-data
  • Flagowanie eksperymentalnych API: Wyraźnie oznacza API, które są jeszcze eksperymentalne lub ukryte za flagami funkcji
  • Tester wyrażeń niestandardowych: Wprowadź dowolne wyrażenie JavaScript, aby ocenić je na żywo w swojej przeglądarce i zobaczyć wynik lub błąd
  • Filtrowanie i wyszukiwanie: Filtruj według statusu obsługi (obsługiwane/nieobsługiwane/nieznane) i wyszukuj po nazwie API, aby szybko znaleźć to, czego potrzebujesz

Jak to działa

Narzędzie ładuje listę wpisów Web API z pakietu MDN Browser Compat Data w czasie kompilacji. Gdy otworzysz stronę, ocenia każdą nazwę API jako właściwość globalnego obiektu window — jeśli właściwość istnieje i nie jest pusta, API jest oznaczane jako obsługiwane. Dane wersji MDN są wstępnie załadowane i wyświetlane obok wyniku detekcji na żywo.

Porady

  • Użyj filtru statusu, aby wyświetlić tylko API obsługiwane w Twojej przeglądarce — przydatne do audytu dostępnych funkcji przed napisaniem kodu.
  • Użyj pola wyrażenie niestandardowe, aby przetestować bardziej złożone sprawdzenia funkcji, takie jak typeof navigator.bluetooth !== 'undefined' lub 'serviceWorker' in navigator.
  • Eksperymentalne API mogą być dostępne w niektórych kompilacjach przeglądarki, ale nie w stabilnych wydaniach — zawsze sprawdź dokumentację MDN przed poleganiem na nich w produkcji.