Как начать работу с экспериментами с источником

Протестируйте новую или экспериментальную функцию веб-платформы.

Sam Dutton

Эксперименты с источником дают доступ к новой или экспериментальной функции, чтобы вы могли протестировать ее и предложить своим пользователям на ограниченное время. После завершения тестирования и оценки отзывов команда Chrome решает, следует ли сделать функцию доступной для всех.

Вы можете зарегистрироваться для участия в эксперименте с источником, чтобы включить функцию для всех пользователей вашего источника. Им не придется переключать экспериментальные функции или переходить на альтернативную сборку Chrome (хотя может потребоваться обновление). После регистрации разработчики могут создавать демоверсии и прототипы с использованием новых функций. Кроме того, пробные версии помогают инженерам Chrome понять, как используются новые функции и как они могут взаимодействовать с другими веб-технологиями.

Доступность

Эксперименты с источником общедоступны и открыты для всех разработчиков. Они ограничены по времени и использованию. Участие в программе предполагает самостоятельное управление с ограниченной документацией и поддержкой. Участники должны быть готовы работать относительно независимо, используя доступную документацию, которая на этом этапе, скорее всего, ограничивается спецификациями API и пояснениями. Мы стараемся давать рекомендации, когда это возможно.

Если вы зарегистрируетесь для участия в тестировании, команда Chrome будет периодически запрашивать у вас отзывы об использовании тестируемой функции. Некоторые функции могут проходить несколько экспериментов с источником, поскольку мы учитываем отзывы и вносим корректировки.

Эксперименты с источником также доступны для Firefox и Microsoft Edge.

Сторонние эксперименты с источником

По умолчанию функция, участвующая в эксперименте с источником, доступна только в источнике, зарегистрированном для эксперимента. При регистрации в некоторых пробных версиях доступен вариант сопоставления со сторонними сервисами. Это позволяет поставщикам встроенного контента или сервисов тестировать новые функции на нескольких сайтах без необходимости получать токен для каждого источника.

Подробнее о сторонних экспериментах с источником…

Эксперименты с устаревшими функциями

Некоторые эксперименты с источником позволяют временно включить устаревшую функцию. Такие эксперименты называются экспериментами с устаревшими функциями. В некоторых контекстах их называют "обратными" экспериментами с источником.

Например, начиная с Chrome 127, была прекращена поддержка событий изменения DOM. Если вам нужно больше времени, чтобы удалить эти события, зарегистрируйтесь в эксперименте с устаревшей функцией, чтобы временно включить их на определенных сайтах.

Как принять участие в эксперименте с источником

  1. Выберите эксперимент из списка активных.
  2. Запросите токен, нажав кнопку Зарегистрироваться и заполнив форму.
  3. Укажите токен на каждой веб-странице, для которой вы хотите включить пробную функцию:
  4. Попробуйте новую функцию.
  5. Отправить отзыв Это можно сделать на сайте тестирования. Отзыв не будет опубликован. Его увидят только некоторые сотрудники команды Chrome. В каждом испытании также есть ссылка для отправки отзывов. Обычно это ссылка на функцию на GitHub или другом общедоступном канале.
  6. Когда срок действия токена истечет, вы получите электронное письмо со ссылкой для его продления. Для этого вам снова нужно будет отправить отзыв.

Вы можете зарегистрироваться в одном и том же эксперименте с источником несколько раз для разных источников и добавить несколько токенов на одну страницу. Это может быть полезно, если вам нужно предоставить токены, действительные для ресурсов, обслуживаемых из разных источников, например для кода, включенного в несколько принадлежащих вам сайтов.

Фреймворк экспериментов с источником ищет первый действительный токен, а затем игнорирует все остальные. Это можно проверить с помощью инструментов разработчика в Chrome.

Как предоставить токен программно

Вместо того чтобы указывать токен в HTTP-заголовке или метатеге HTML-кода страницы, как описано выше, вы можете внедрить его с помощью JavaScript:

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

Используйте этот способ, если вы участвуете в пробной версии стороннего сервиса.

Токены и окна iframe

Чтобы получить доступ к экспериментальной функции из iframe, вы можете указать токен в метатеге, HTTP-заголовке или программно.

Как и в случае с любым использованием токена, источник, зарегистрированный для токена, должен соответствовать контексту JavaScript, который обращается к пробной функции: либо источнику страницы, содержащей встроенный скрипт, либо src элемента <script> для JavaScript, включенного из внешнего файла.

Токены и расширения

Чтобы использовать экспериментальную функцию в фоновом скрипте, всплывающем окне, боковой панели или закадровом документе, добавьте ключ trial_tokens в файл manifest.json.

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

Скрипты содержимого обрабатываются по-другому. Если функция будет доступна только в одном мире, это может запутать пользователей. Вместо использования trial_token манифеста добавьте токен на страницу одним из следующих способов:

Помните, что токены привязаны к определенным доменам, поэтому вам нужно зарегистрироваться для домена, на котором выполняется скрипт контента, а не для идентификатора расширения.

Чтобы зарегистрировать расширение для пробной версии, используйте URL chrome-extension://YOUR_EXTENSION_ID, например chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

Как продлить регистрацию в эксперименте с источником

Если эксперимент с источником продлевается, вы получите электронное письмо с предупреждением о том, что вам нужно продлить регистрацию и предоставить новый токен для каждого источника, зарегистрированного в эксперименте.

  1. Перейдите в раздел My Registrations (Мои регистрации).
  2. Для каждого источника, зарегистрированного для расширенного пробного периода, нажмите RENEW (Продлить). Пример страницы &quot;Мои регистрации&quot; с кнопками &quot;Продлить&quot;
  3. Скопируйте новый токен и добавьте его на все страницы, которые должны участвовать в тестировании. При необходимости можно указать несколько токенов.

Chrome игнорирует недействительные или просроченные токены.

Как посмотреть информацию об эксперименте с источником

Информацию об экспериментах с источником, доступных для сайта, можно посмотреть на панели Приложение в инструментах разработчика Chrome.

Подробные сведения о фрейме на панели &quot;Приложение&quot; в инструментах разработчика Chrome.

Функции в эксперименте с источником

Ниже приведены демонстрации API в текущих экспериментах с источником.

Ресурсы

Продолжайте читать документацию по концепциям Chrome:

Дополнительную информацию об экспериментах с источником в Chrome можно найти по следующим ссылкам:

Другие браузеры

Эксперименты с источником в других браузерах:

Назад
Модификации Chrome
Далее
Эксперименты с источником сторонних разработчиков