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 okresu próbnego i przeanalizowaniu opinii zespół Chrome zdecyduje, czy udostępnić tę funkcję wszystkim użytkownikom.

Możesz zarejestrować się w programie testów wersji źródłowej, aby włączyć funkcję dla wszystkich użytkowników w źródle, bez konieczności włą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. Staramy się udzielać wskazówek, gdy tylko jest to możliwe.

Jeśli zarejestrujesz się na okres próbny, zespół Chrome będzie okresowo prosić Cię o opinię na temat korzystania z tej funkcji. 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.

Próby pochodzenia 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 demonstracyjnych pochodzących od innych 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 127. Witryny, które potrzebowały dodatkowego czasu na usunięcie tych zdarzeń, mogą zarejestrować się w próbnym wycofaniu, 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 tę samą wersję próbną pochodzenia wiele razy, dla różnych pochodzenia 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. 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 u innego dostawcy.

tokeny i elementy 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 pochodzenie musi być zgodne z kontekstem kodu JavaScript, który uzyskuje dostęp do funkcji wersji próbnej: albo pochodzenie strony, która zawiera skrypt wbudowany, albo src elementu <script> kodu JavaScript zawartego w pliku zewnętrznym.

Tokeny i rozszerzenia

Aby korzystać z funkcji próbnej w skrypcie uruchamianym w tle, wyskakującym okienku, panelu bocznym lub dokumencie poza ekranem, 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 na wersję próbną 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 wersji próbnej origin

Informacje o dostępnych dla witryny wersjach próbnych origin znajdziesz na panelu Aplikacja w Narzędziach deweloperskich w Chrome.

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.

Przykłady

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 demonstracje 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 wersji próbnych w Chrome:

Inne przeglądarki

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