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 dana funkcja powinna być udostępniona 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 postaci wbudowanych elementów mogą wypróbować nową funkcję w wielu witrynach bez konieczności uzyskiwania tokena dla każdego źródła.

Dowiedz się więcej: Co to są próby pochodzenia z innej firmy?

Przywrócenie wycofanej 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 „odwrotne” próby pochodzenia.

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 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 na funkcję w GitHub lub innym publicznym kanale.
  6. Gdy token wygaśnie, otrzymasz e-maila z linkiem do 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. 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 pochodzenie musi być zgodne z kontekstem kodu JavaScript, który uzyskuje dostęp do funkcji wersji próbnej: albo pochodzenie strony zawierającej skrypt wbudowany, albo src elementu <script> kodu JavaScript zawartego w pliku zewnętrznym.

Tokeny i rozszerzenia

Aby użyć funkcji próbnej w skrypcie tła, wyskakującym okienku, sidepanel 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 wersji próbnej origin

Jeśli okres próbny dostawy zostanie przedłużony, otrzymasz e-maila z ostrzeżeniem, że musisz odnowić rejestrację i podać nowy token dla każdej dostawy objętej okresem próbnym.

  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: