Pierwsze kroki z testami origin

testować nową lub eksperymentalną funkcję platformy internetowej.

Sam Dutton

Wersje próbne origin dają dostęp do nowej lub eksperymentalnej funkcji, dzięki czemu możesz przetestować tę funkcję i zaproponować ją użytkownikom przez ograniczony czas. Po zakończeniu testów i przeanalizowaniu opinii zespół Chrome zdecyduje, czy udostępnić tę funkcję wszystkim użytkownikom.

Możesz zarejestrować się w ramach wersji próbnej pochodzenia, aby włączyć funkcję dla wszystkich użytkowników w pochodzeniu, bez konieczności przełączania flag lub przełączania się na inną wersję Chrome (chociaż może być konieczna aktualizacja). Po zarejestrowaniu deweloperzy mogą tworzyć wersje demonstracyjne i prototypy, korzystając z nowych funkcji. Testy pomagają też inżynierom Chrome zrozumieć, jak są używane nowe funkcje i jak mogą one współdziałać z innymi technologiami internetowymi.

Dostępność

Testy Origin są publiczne i otwarte dla wszystkich deweloperów. Ich czas trwania i wykorzystanie są ograniczone. Udział w programie jest procesem samodzielnym, w którym dokumentacja i pomoc są ograniczone. Uczestnicy powinni być gotowi i w stanie pracować stosunkowo samodzielnie, korzystając z dostępnej dokumentacji, która na tym etapie prawdopodobnie ogranicza się do specyfikacji i opisów interfejsów API. W miarę możliwości staramy się udzielać wskazówek.

Jeśli zarejestrujesz się w programie testów, zespół Chrome będzie okresowo prosić Cię o opinie na temat korzystania z funkcji testu. Niektóre funkcje mogą być testowane na różnych rynkach, ponieważ uwzględniamy opinie użytkowników i wprowadzamy poprawki.

Wersje próbne origin są też dostępne w Firefox i Microsoft Edge.

Testy pochodzenia pochodzące od innych firm

Domyślnie funkcja testowania origin jest dostępna tylko w źródle zarejestrowanym na potrzeby testowania. Niektóre wersje próbne oferują opcję dopasowania do innych firm podczas rejestracji. Dzięki temu dostawcy treści lub usług w ramach wielu witryn mogą wypróbować nową funkcję bez konieczności uzyskiwania tokena dla każdego źródła.

Dowiedz się więcej: Co to są próby wersji beta pochodzące od zewnętrznych firm?

Przywracanie wycofanych funkcji

Niektóre wersje próbne origin umożliwiają tymczasowe ponowne włączenie wycofanej funkcji. Nazywamy je testami wycofywania. W niektórych kontekstach są one określane jako „testy pochodzenia wstecznego”.

Na przykład zdarzenia mutacji zostały usunięte od wersji Chrome 127. Witryny, które potrzebowały dodatkowego czasu na usunięcie tych zdarzeń, mogą zarejestrować się w ramach trybu wycofywania, aby tymczasowo ponownie włączyć te zdarzenia w wybranych witrynach.

Udział w testach źródła

  1. Wybierz wersję próbną pochodzenia z listy aktywnych wersji próbnych.
  2. Poproś o token, klikając przycisk Zarejestruj się i wypełniając formularz.
  3. Podaj token na każdej stronie internetowej, na której chcesz włączyć wersję próbną:
    • Jako metatag w sekcji <head>: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
    • Jako nagłówek HTTP: Origin-Trial: TOKEN_GOES_HERE
    • automatycznie udostępniając token.
  4. Wypróbuj nową funkcję.
  5. Prześlij opinię. Zrób to na stronie próbnej wersji źródłowej. Te opinie nie są publiczne i są dostępne tylko dla ograniczonej grupy osób z zespołu Chrome. Każdy okres próbny zawiera też link do spontanicznych opinii społeczności. Zwykle wskazuje to na funkcję w GitHub lub innym publicznym kanale.
  6. Gdy token wygaśnie, otrzymasz e-maila z linkiem do jego odnowienia. Aby to zrobić, ponownie prześlij opinię.

Możesz zarejestrować się na wersję próbną tego samego źródła kilka razy, dla różnych źródeł, i umieścić na tej samej stronie wiele tokenów. Może się to przydać, jeśli chcesz podać tokeny, które są ważne w przypadku zasobów pochodzących z różnych źródeł, np. kodu zawartego w wielu witrynach należących do Ciebie.

Framework testów pochodzenia szuka pierwszego prawidłowego tokena, a potem ignoruje wszystkie pozostałe tokeny. Możesz to sprawdzić za pomocą Narzędzi deweloperskich w Chrome.

Przekazywanie tokena za pomocą kodu

Zamiast podawać token w nagłówku HTTP lub w metatagu w kodzie HTML strony, jak opisano wcześniej, możesz wstrzyknąć go za pomocą kodu JavaScript:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

Użyj tej metody, jeśli korzystasz z okresu próbnego w usłudze innej firmy.

Tokeny i iframe

Aby uzyskać dostęp do funkcji okresu próbnego z poziomu ramki w HTML, możesz podać token okresu próbnego w metatagu, nagłówku HTTP lub programowo.

W przypadku każdego użycia tokena jego źródło musi być zgodne z kontekstem kodu JavaScript, który uzyskuje dostęp do funkcji wersji próbnej: albo źródło strony, która zawiera skrypt wbudowany, albo src elementu <script> kodu JavaScript zawartego w pliku zewnętrznym.

Tokeny i rozszerzenia

Aby korzystać z funkcji trial w skrypcie uruchamianym w tle, wyskakującym okienku, panelu bocznym lub pozaekranowym dokumencie, użyj klucza trial_tokens w pliku manifest.json.

"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]

Skrypty treści są obsługiwane inaczej. Udostępnianie funkcji w jednym świecie może być mylące i nieintuicyjne. Zamiast używać trial_token w pliku manifestu, dodaj token do strony w jeden z tych sposobów:

Pamiętaj, że tokeny są powiązane z określonymi domenami, więc musisz zarejestrować domenę, w której działa skrypt treści, a nie identyfikator rozszerzenia.

Aby zarejestrować rozszerzenie na potrzeby okresu próbnego, użyj adresu URL chrome-extension://YOUR_EXTENSION_ID, na przykład chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

Odnawianie rejestracji wersji próbnej origin

Jeśli okres próbny dostawcy zostanie przedłużony, otrzymasz e-maila z ostrzeżeniem, że musisz odnowić rejestrację i podać nowy token dla każdego dostawcy zarejestrowanego w ramach okresu próbnego.

  1. Otwórz Moje rejestracje.
  2. W przypadku każdego źródła zarejestrowanego na potrzeby wydłużonego okresu próbnego kliknij ODNOWIĆ.Przykład strony Moje rejestracje z przyciskami odnawiania
  3. Skopiuj nowy token i udostępnij go na każdej stronie, która ma pozostać objęta wersją próbną. W razie potrzeby możesz podać kilka tokenów.

Chrome ignoruje nieprawidłowe lub wygasłe tokeny.

Wyświetlanie informacji o testowaniu origin

Informacje o testach origin dostępnych dla witryny możesz wyświetlić na panelu Aplikacja w Narzędziach Chrome dla programistów.

Widok szczegółów ramki w panelu Aplikacja w Narzędziach deweloperskich w Chrome.

Aby wyświetlić dane zakodowane w tokenie, możesz też użyć naszego dekodera tokena próbnego.

Narzędzie do dekodowania wersji próbnej origin, które pokazuje zdekodowane wartości wersji próbnej origin.

Prezentacje

Przykłady wdrożenia tokenów znajdziesz na tych stronach:

Jak podać token wersji próbnej origin

Narzędzia do testowania Origin

Funkcje w wersji próbnej origin

Poniżej znajdziesz prezentacje interfejsów API, które są obecnie testowane w ramach origin trial.

Zasoby

Czytaj dalej naszą dokumentację pojęć w Chrome:

Więcej informacji o testach pochodzenia w Chrome:

Inne przeglądarki

Znajdź wersje próbne w innych przeglądarkach: