Pierwsze kroki z testami origin

przetestować nową lub eksperymentalną funkcję platformy internetowej;

Sam Dutton

Wersje próbne origin zapewniają dostęp do nowej lub eksperymentalnej funkcji, dzięki której użytkownicy mogą wypróbować nowe funkcje przez ograniczony czas, zanim zostaną udostępnione wszystkim użytkownikom.

Gdy Chrome oferuje wersję próbną origin, możesz zarejestrować się w wersji próbnej, aby włączyć tę funkcję dla wszystkich użytkowników w Twojej domenie bez konieczności włączania jakichkolwiek flag czy przełączania się na alternatywną kompilację Chrome (chociaż może być konieczne uaktualnienie). Testowanie origin pozwala deweloperom tworzyć wersje demonstracyjne i prototypy z wykorzystaniem nowych funkcji. Testy pomagają również inżynierom Chrome zrozumieć, jak używane są nowe funkcje i jak mogą one współdziałać z innymi technologiami internetowymi.

Wersje próbne origin są publiczne i otwarte dla wszystkich deweloperów. Mają ograniczony czas trwania i ograniczony dostęp do nich. Udział w programie odbywa się samodzielnie z ograniczoną dokumentacją i pomocą. Uczestnicy powinni zgodzić się i umieć względnie niezależną pracę, korzystając z dostępnej dokumentacji. Na tym etapie prawdopodobnie ograniczają się one do specyfikacji i objaśnień interfejsu API, chociaż w miarę możliwości staramy się zapewnić wskazówki.

Jeśli zarejestrujesz się na okres próbny, zespół Chrome będzie okresowo prosić Cię o opinię na temat korzystania z tej funkcji. W miarę uwzględniania opinii i wprowadzania poprawek niektóre funkcje mogą zostać przetestowane pod różnymi środowiskami.

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

Testowanie origin innych firm

Wersje próbne origin są zwykle dostępne tylko na podstawie własnych danych i działają tylko w przypadku 1 zarejestrowanego źródła. Testowanie źródła innych firm umożliwia dostawcom umieszczonych treści wypróbowanie nowych funkcji w wielu witrynach bez konieczności używania tokena dla każdego źródła.

Dowiedz się więcej: Co to są zewnętrzne wersje próbne origin?

Okresy próbne wycofania

Nie wszystkie wersje próbne origin służą do testowania nowych interfejsów API. Niektóre wersje próbne umożliwiają tymczasowe ponowne włączenie wycofanej funkcji. Są to tzw. próby wycofania, a w niektórych kontekstach – „odwrotne” testowanie origin.

Na przykład pamięć podręczna aplikacji z Chrome 85 nie jest już domyślnie dostępna w Chrome. Witryny, które potrzebują więcej czasu na migrację z AppCache, mogą się zarejestrować do okresu próbnego wycofania, aby nadal korzystać z AppCache do wersji Chrome 93.

Weź udział w testach origin

  1. Wybierz wersję próbną origin z listy aktywnych wersji próbnych.
  2. Aby poprosić o token, kliknij przycisk Zarejestruj i wypełnij formularz.
  3. Podaj token na każdej stronie internetowej, na której chcesz włączyć funkcję próbną:
    • Jako metatag w tagu <head>: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
    • Jako nagłówek HTTP: Origin-Trial: TOKEN_GOES_HERE
    • Przez automatyczne udostępnianie tokena.
  4. Wypróbuj nową funkcję.
  5. Prześlij opinię. Możesz to zrobić na stronie testowania origin. Ta opinia nie jest dostępna publicznie i jest dostępna tylko dla ograniczonej grupy osób w zespole Chrome. Każda wersja próbna zawiera też link do spontanicznych opinii społeczności. Zwykle wskazuje to na funkcję na GitHubie lub innym kanale publicznym.
  6. Gdy token wygaśnie, otrzymasz e-maila z linkiem do odnowienia. Aby to zrobić, ponownie poprosimy Cię o przesłanie opinii.

W przypadku tego samego okresu próbnego możesz zarejestrować się kilka razy dla różnych źródeł i umieścić na tej samej stronie wiele tokenów. Może to być przydatne, gdy musisz udostępnić tokeny ważne na zasoby udostępniane z różnych źródeł, np. kod zawarty w wielu Twoich witrynach.

Platforma testowania origin szuka pierwszego prawidłowego tokena, a potem ignoruje wszystkie inne tokeny. Możesz to sprawdzić za pomocą Narzędzi deweloperskich w Chrome.

Automatyczne udostępnianie tokena

Zamiast podawać token jako nagłówek HTTP lub metatag w kodzie HTML strony, jak opisano wcześniej, możesz wstawić token za pomocą JavaScriptu:

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 wersji próbnej innej firmy.

Tokeny i elementy iframe

Aby uzyskać dostęp do funkcji próbnej z elementu iframe, możesz udostępnić token próbny w metatagu, nagłówku HTTP lub automatycznie.

Tak jak w przypadku każdego użycia tokena, źródło zarejestrowane dla tokena musi być zgodne z kontekstem JavaScriptu, który uzyskuje dostęp do funkcji próbnej: źródłem strony zawierającej wbudowany skrypt lub src elementu <script> w przypadku kodu JavaScriptu uwzględnionego w pliku zewnętrznym.

Tokeny i rozszerzenia

Aby korzystać z funkcji próbnej w skrypcie w tle, wyskakującym okienku lub dokumentie nieekranowym, dodaj parametr trial_token do pliku manifest.json.

Skrypty treści są obsługiwane w inny sposób. Przedstawienie funkcji w jednym świecie może być mylące i nieintuicyjne. Zamiast używać polecenia trial_token w pliku manifestu dodaj token do strony. W tym celu wstaw nagłówek za pomocą funkcji declaritiveNetRequest lub automatycznie w skrypcie treści. Pamiętaj, że tokeny są powiązane z konkretnymi domenami, więc zarejestruj jedną z nich dla domeny, w której działa skrypt treści, a nie dla identyfikatora rozszerzenia.

Aby zarejestrować rozszerzenie na potrzeby wersji próbnej, użyj adresu URL chrome-extension://YOUR_EXTENSION_ID, np. chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

Odnów rejestrację w wersji próbnej origin

Jeśli okres próbny origin zostanie przedłużony, otrzymasz e-maila z ostrzeżeniem, że należy odnowić rejestrację i podać nowy token dla każdego źródła zarejestrowanego w tym okresie próbnym.

  1. Otwórz stronę Moje rejestracje.

  2. W przypadku każdego punktu początkowego zarejestrowanego w ramach rozszerzonego okresu próbnego kliknij przycisk ODNOWI. Zrzut ekranu pokazujący stronę Moje rejestracje na stronie Moje rejestracje w Chrome, na której widoczne są przyciski ODNÓW

  3. Skopiuj nowy token i udostępnij go dla każdej strony, która powinna pozostać zarejestrowana w okresie próbnym. W razie potrzeby możesz podać kilka tokenów – Chrome zignoruje nieprawidłowe lub wygasłe tokeny.

Wyświetl informacje o testowaniu origin

Wyświetl informacje o testach origin dostępnych dla strony w panelu Aplikacja w Narzędziach deweloperskich w Chrome.

Informacje o źródle próbnym witryny wyświetlane w widoku szczegółów ramki panelu w Narzędziach deweloperskich w Chrome**.

Możesz też użyć dekodera tokena testowego, aby wyświetlić dane zakodowane w tokenie.

Narzędzie do dekodera wersji próbnej origin pokazujące zdekodowane wartości próbne origin.

Wersje demonstracyjne origin

Więcej informacji