Data publikacji: 20 maja 2025 r.
Gdy funkcja platformy internetowej zostanie zaimplementowana we wszystkich przeglądarkach, stanie się dostępna w ramach Baseline Newly available. Po 30 miesiącach funkcja ta staje się powszechnie dostępna w ramach Baseline, czyli progu, w którym większość witryn może wdrożyć funkcje bez obaw o kompatybilność. Z tego przewodnika dowiesz się, jak korzystać z funkcji Baseline i jak na podstawie danych o użytkownikach witryny wybrać cel Baseline.
Czym jest docelowa wartość odniesienia?
Cel Baseline to grupa funkcji internetowych, które deweloperzy mogą obsługiwać w zależności od ich stanu Baseline. Istnieją 2 rodzaje wartości docelowych w przypadku wartości bazowych: ruchome i stałe.
Cele ruchome, takie jak „Podstawowe – powszechnie dostępne” lub „Podstawowe – nowo dostępne”, to cele, których zestaw funkcji może się z czasem zmieniać. Cele ruchome są przydatne, gdy chcesz, aby zestaw obsługiwanych funkcji zmieniał się automatycznie wraz z wydawaniem nowych wersji przeglądarki.
Cele stałe to takie, w przypadku których zestaw cech nie zmienia się z czasem. Zazwyczaj cele stałe są oparte na latach kalendarzowych. Na przykład Baseline 2023 to stały cel, który zawiera zestaw funkcji internetowych, które w 2023 r. stały się dostępne w ramach Baseline. Punkt odniesienia 2023 nie obejmuje funkcji, które stały się punktem odniesienia po 2023 r., co oznacza, że zestaw funkcji punktu odniesienia 2023 nigdy się nie zmienia.
Stałe wartości docelowe mają sens w przypadkach, gdy najważniejsza jest przewidywalność i determinizm, ale z czasem mogą stać się nieaktualne. Dlatego, gdy używasz stałych wartości docelowych, warto regularnie je weryfikować.
Dlaczego warto wybrać cel?
Wdrażanie funkcji w internecie jest utrudnione ze względu na problemy z kompatybilnością, co sprawia, że internet nie jest tak dobry, jak mógłby być. Baseline nie tylko wyjaśnia kwestię obsługi funkcji w przeglądarkach, ale też pomaga zrozumieć, kiedy można używać określonych funkcji. Wybierając platformę docelową, która odzwierciedla Twoich odbiorców i wymagania, możesz mieć pewność, że korzystasz z funkcji w ramach tej grupy docelowej – bez konieczności sprawdzania poszczególnych funkcji.
Używanie danych do wybierania docelowej wartości odniesienia
Wybór odpowiedniego celu wartości bazowej powinien być w miarę możliwości oparty na danych. Gdy masz przed sobą dane, wybór celu staje się łatwiejszy i bardziej świadomy.
Jeśli masz dane monitorowania użytkowników rzeczywistych dotyczące swojej witryny, możesz dowiedzieć się, jak wartości docelowe wartości bazowych są mapowane na Twoich użytkowników. Jeśli na przykład korzystasz z Google Analytics, bezpłatnym sposobem na uzyskanie tych informacji jest użycie narzędzia do sprawdzania wartości bazowych Google Analytics.
Aby korzystać z tego narzędzia, musisz się uwierzytelnić za pomocą konta Google i przyznać narzędziu uprawnienia tylko do odczytu, aby mogło wyświetlać dane Google Analytics. Następnie wybierz usługę w Google Analytics, dla której chcesz wygenerować dane docelowe wartości bazowej. Po wykonaniu tych czynności otrzymasz dane wyjściowe podobne do tych:
Zaczynamy obserwować, że inne narzędzia wdrażają obsługę wartości bazowej, która może zapewnić dynamiczny wgląd w to, ilu odbiorców wspiera dany cel. Na przykład RUMvision zawiera panel informacyjny, który pokazuje, jaka część odbiorców obsługuje poszczególne lata Baseline.

Co zrobić, jeśli mój dostawca usług analitycznych lub RUM nie ma jeszcze raportu dotyczącego wartości docelowej Baseline?
Jeśli używasz narzędzia analitycznego lub RUM, które nie udostępnia jeszcze raportu dotyczącego wartości docelowej linii bazowej, ale zawiera dane o wersjach przeglądarek, możesz połączyć dane z rzeczywistych warunków z mapowaniami wersji przeglądarek z modułu baseline-browser-mapping. Moduł udostępnia funkcję JavaScriptu – getAllVersions() – która przypisuje przeglądarki według nazwy i wersji do roku podstawowego oraz stanu obsługi funkcji powszechnie dostępnych. Te mapowania mogą być podawane jako tablice, obiekty z kluczami lub pliki CSV. Na przykład moduł sprawdzania wartości bazowych Google Analytics używa tego modułu do łączenia danych analitycznych z wartościami bazowymi.
Wyniki tej funkcji są też dostępne w postaci hostowanych plików JSON lub CSV, które są aktualizowane codziennie. Plik all_versions_with_supports.csv zawiera dane, które możesz dopasować do danych o wersji przeglądarki dostawców usług analitycznych za pomocą tych pól:
browser: nazwa przeglądarki używana wbaseline-browser-mappingversion: wersja przeglądarki. Niektóre przeglądarki używają tylko numeru wersji głównej, a inne numeru wersji major.minor.year: zestaw funkcji roku bazowego, które obsługuje ta wersja przeglądarki. Jeśli wersja przeglądarki została wydana przed lipcem 2015 r., kiedy to można było określić obsługę Baseline, to pole będzie zawierać znakpre_baseline.supports: to pole zawiera wartośćwidelylubnewlyw przypadku wersji przeglądarek, które obsługują te zestawy funkcji, a w przypadku wersji, które nie obsługują żadnego z tych zestawów funkcji, jest puste. Wszystkie wersje przeglądarek, które obsługują funkcję Nowo dostępne, obsługują też funkcję Ogólnie dostępne.release_date: data wydania tej wersji przeglądarki (jeśli jest dostępna);engine: Nazwa silnika w przypadku przeglądarek, które są oparte na przeglądarce podstawowej. Uwzględniamy tylko przeglądarki oparte na Blink, ale w przyszłości możemy uwzględnić także inne silniki przeglądarek.engine_version: wersja Chromium, którą implementuje ta wersja przeglądarki. Służy do określania, który zestaw funkcji Baseline jest obsługiwany przez wersję niższego poziomu.
Ten plik jest często aktualizowany w miarę publikowania nowych wersji przeglądarek i zmiany stanu obsługi różnych przeglądarek. Pamiętaj, aby codziennie odświeżać dane.
Co zrobić, jeśli nie mam danych o pomocy od prawdziwych użytkowników?
W przypadku funkcji, które są w stanie podstawowym, możesz nie mieć dostępu do danych użytkownika rzeczywistych użytkowników. Dobra wiadomość jest taka, że ogólne informacje o obsłudze różnych celów Baseline możesz uzyskać dzięki statystykom archiwum RUM, a nawet filtrować je na poziomie kraju. Te dane nie będą dotyczyć użytkowników Twojej witryny. Jest to ogólne narzędzie informacyjne, które pokazuje, że te założenia są zazwyczaj bezpieczne:
- Nowsze wartości docelowe Baseline, takie jak bieżący rok lub rok poprzedni, prawdopodobnie będą miały najmniejsze wsparcie wśród użytkowników. Podobnie jak w przypadku innych urządzeń docelowych z poziomu podstawowego, z czasem będą one lepiej obsługiwane.
- Starsze wartości odniesienia, zwłaszcza Baseline Widely available, będą dobrze obsługiwane. W razie wątpliwości wybierz opcję „Szeroko dostępne”, która zmienia się w miarę upływu 30-miesięcznego okresu.
- Nawet starsze cele podstawowe, które wykraczają poza 30-miesięczny okres powszechnej dostępności, będą miały najlepszą obsługę. Chociaż opcja „Szeroko dostępne” jest dobrym domyślnym celem, w przypadku specjalnych zastosowań, które wymagają ścisłych umów SLA, może być konieczne użycie innych opcji.
Nawet jeśli wybierzesz docelową wersję Baseline starszą niż 5 lat, prawdopodobnie będziesz w stanie wdrożyć funkcje, których obecnie nie używasz. W najlepszym przypadku możesz już korzystać z tych funkcji, ale z użyciem polyfilli, które mogą nie być potrzebne.
Jak wymusić w projekcie wybraną docelową wartość odniesienia?
Browserslist to powszechnie stosowana metoda kierowania na przeglądarki, które chcesz obsługiwać. Jest on używany w pakietach i innych powiązanych narzędziach, takich jak Babel i PostCSS, aby określić, czy niektóre fragmenty kodu wymagają przekształcenia lub uzupełnienia.
Możesz teraz używać Baseline z Browserslist, aby po wybraniu celu Baseline określić go jako prawidłowe zapytanie Browserslist. Dzięki temu narzędzia w projekcie będą przekształcać kod zgodnie z wybranym przez Ciebie celem. Więcej informacji znajdziesz w artykule Korzystanie z Baseline w połączeniu z Browserslist.
Co z funkcjami, które nie spełniają mojego docelowego poziomu podstawowego?
Po wybraniu celu podstawowego możesz mieć funkcje, których chcesz używać, ale które nie mieszczą się w tym celu. Baseline nie podaje, co należy w tym przypadku zrobić, a decyzja o skorzystaniu z tych funkcji zależy od typu tworzonej witryny i oczekiwanej grupy odbiorców.
Na przykład witryny e-commerce lub B2B mogą mieć niższy próg pomocy i rozwiązywać problemy w miarę zgłaszania ich przez użytkowników, podczas gdy witryny rządowe mogą wymagać wysokiego progu pomocy. Ważna zasada jest taka, że nie wszystkie funkcje internetowe działają w ten sam sposób. Istnieje wiele sposobów kategoryzowania funkcji pod względem ich działania, ale jednym z nich jest podział na grupy, który może być przydatny:
- Ulepszenie: jeśli funkcja jest używana w nieobsługiwanej przeglądarce, nie powoduje to problemów. Może to pogorszyć wrażenia użytkownika, ale prawdopodobnie nie będzie to dla niego zauważalne. Przykład:
loading="lazy". - Dodatkowe: funkcja zapewnia pewne dodatkowe korzyści, które mogą być zauważalne, np. zmiany w stylu strony lub niektóre funkcje. Jeśli funkcja jest nieobsługiwana, użytkownicy mogą nie zauważyć różnicy, chyba że porównają ją w przeglądarce, która ją obsługuje. Przykład: Subgrid
- Krytyczne: jeśli funkcja jest nieobsługiwana, użytkownik będzie miał negatywne wrażenia, a nawet może dojść do całkowitego uszkodzenia. Przykład: interfejs File System Access API używany jako centralna i niezbędna funkcja.
Może się też okazać, że niektóre funkcje spoza Twojego celu są obsługiwane lepiej, niż myślisz. Możesz sprawdzić, ilu użytkowników obsługuje daną funkcję. Can I Use może sprawdzać obsługę poszczególnych funkcji na podstawie danych analitycznych. RUMvision umożliwia też szczegółowe analizowanie danych na poziomie funkcji, jeśli jest to dla Ciebie przydatne.
W ten sposób możesz użyć docelowej wartości bazowej, aby zmniejszyć liczbę funkcji, które musisz dokładnie rozważyć. Nie musisz się martwić o wszystko, co mieści się w Twoim zakresie docelowym. Jeśli poza Twoim docelowym środowiskiem jest 1 lub 2 funkcje, które byłyby szczególnie przydatne, możesz je dokładniej zbadać i zdecydować, czy użyć kodu polyfill, czy zastosować progresywne ulepszanie.
Podsumowanie
Każda aplikacja internetowa ma inne wymagania – od witryny e-commerce, która może tolerować więcej problemów z niezgodnością, po witrynę rządową, która musi być dostępna i działać dla jak największej liczby użytkowników. Musisz samodzielnie przeprowadzić te obliczenia. Celem Baseline nie jest podpowiadanie Ci, jakie decyzje podejmować w kwestii wdrażania nowych funkcji internetowych, ale raczej jak to robić.