Протестируйте новую или экспериментальную функцию веб-платформы.
Пробные версии Origin предоставляют вам доступ к новой или экспериментальной функции, чтобы вы могли протестировать эту функцию и предложить ее своим пользователям в течение ограниченного времени. После завершения пробной версии и оценки отзывов Chrome решает, следует ли сделать функцию доступной для всех.
Вы можете зарегистрироваться для пробной версии origin, чтобы включить функцию для всех пользователей вашего origin , не требуя от них переключения каких-либо флагов или переключения на альтернативную сборку Chrome (хотя им может потребоваться обновление). После регистрации разработчики могут создавать демонстрации и прототипы с использованием новых функций. Пробные версии также помогают инженерам Chrome понять, как используются новые функции и как они могут взаимодействовать с другими веб-технологиями.
Доступность
Испытания Origin являются публичными и открытыми для всех разработчиков. Они ограничены по продолжительности и использованию. Участие — это самоуправляемый процесс с ограниченной документацией и поддержкой. Участники должны быть готовы и способны работать относительно независимо, используя доступную документацию, которая на данном этапе, вероятно, ограничена спецификациями API и пояснениями. Мы стараемся предоставлять руководство, когда это возможно.
Если вы зарегистрируетесь на пробную версию, команда Chrome будет периодически запрашивать у вас конкретные отзывы об использовании пробной версии. Некоторые функции могут проходить несколько испытаний в Origin, поскольку отзывы включаются и вносятся коррективы.
Пробные версии Origin также доступны для Firefox и Microsoft Edge .
Испытания сторонних источников
По умолчанию пробная функция Origin доступна только на зарегистрированном для пробной версии Origin . Некоторые пробные версии предоставляют опцию сопоставления третьей стороны при регистрации. Это позволяет поставщикам встроенного контента или услуг пробовать новую функцию на нескольких сайтах, не требуя токена для каждого Origin.
Узнайте больше: Что такое испытания сторонних источников?
Испытания по устареванию
Некоторые пробные версии origin позволяют вам временно повторно включить устаревшую функцию. Они известны как пробные версии deprecation . В некоторых контекстах их называют «обратными» пробными версиями origin.
Например, события мутации были удалены , начиная с Chrome 127. Сайты, которым требовалось дополнительное время перед удалением этих событий, могут зарегистрироваться для участия в пробной версии по удалению , чтобы временно включить события на определенных сайтах.
Примите участие в испытании Origin
- Выберите исходную пробную версию из списка активных пробных версий .
- Запросите токен, нажав кнопку «Зарегистрироваться» и заполнив форму.
- Укажите токен на каждой веб-странице, для которой вы хотите включить пробную версию:
- Как метатег в <head>:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
- В качестве заголовка HTTP:
Origin-Trial: TOKEN_GOES_HERE
- Путем предоставления токена программным способом .
- Как метатег в <head>:
- Попробуйте новую функцию.
- Отправьте отзыв. Сделайте это через сайт пробной версии Origin. Этот отзыв не является публичным и доступен только ограниченной группе людей в команде Chrome. Каждый пробный вариант также предоставляет ссылку для спонтанной обратной связи сообщества. Обычно это указывает на функцию на GitHub или каком-либо другом публичном канале.
- Когда срок действия вашего токена истечет, вы получите письмо со ссылкой на продление. Для этого вам снова предлагается отправить отзыв.
Вы можете зарегистрироваться на один и тот же пробный период источника несколько раз, для разных источников и включить несколько токенов на одну и ту же страницу. Это может быть полезно, если вам нужно предоставить токены, которые действительны для ресурсов, обслуживаемых из разных источников, например, код, включенный на нескольких сайтах, которыми вы владеете.
Фреймворк испытаний происхождения ищет первый действительный токен, а затем игнорирует все остальные токены. Вы можете проверить это с помощью Chrome DevTools .
Предоставьте токен программно
Вместо предоставления токена в виде заголовка HTTP или метатега в HTML-коде вашей страницы, как было описано ранее, вы можете внедрить токен с помощью JavaScript:
const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);
Используйте этот метод, если вы участвуете в стороннем исследовании .
Токены и фреймы
Чтобы получить доступ к пробной функции из iframe, вы можете указать пробный токен в метатеге, заголовке HTTP или программно .
Что касается любого использования токена, источник, зарегистрированный для токена, должен соответствовать контексту JavaScript, который обращается к пробной функции: либо источник страницы, включающей встроенный скрипт, либо src
элемента <script>
для JavaScript, включенного из внешнего файла.
Токены и расширения
Чтобы использовать пробную функцию внутри фонового скрипта , всплывающего окна , боковой панели или внеэкранного документа , используйте ключ trial_tokens
в файле manifest.json .
"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]
Скрипты контента обрабатываются по-разному. Демонстрация функции в одном мире может быть запутанной и неинтуитивной. Вместо использования trial_token
манифеста добавьте токен на страницу одним из следующих способов:
- Вставьте заголовок с помощью
declarativeNetRequest
- Программно добавьте его непосредственно в скрипт вашего контента.
Помните, что токены привязаны к определенным доменам, поэтому вам необходимо зарегистрироваться для домена, на котором запущен скрипт контента, а не для вашего идентификатора расширения.
Чтобы зарегистрировать расширение для пробной версии, используйте URL-адрес chrome-extension://YOUR_EXTENSION_ID
, например chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk
.
Возобновить регистрацию в исследовании Origin
Если пробная версия Origin будет продлена, вы получите электронное письмо с предупреждением о необходимости продлить регистрацию и предоставить новый токен для каждой версии Origin, зарегистрированной в пробной версии.
- Перейдите в раздел «Мои регистрации» .
- Для каждого источника, зарегистрированного для продленной пробной версии, нажмите ПРОДЛИТЬ .
- Скопируйте новый токен и сделайте его доступным для каждой страницы, которая должна остаться зарегистрированной в пробной версии. При необходимости вы можете предоставить несколько токенов.
Chrome игнорирует недействительные или просроченные токены.
Просмотреть информацию об испытании Origin
Просмотрите информацию о доступных для сайта пробных версиях Origin на панели «Приложение» в Chrome DevTools .
Вы также можете использовать наш пробный декодер токенов Origin для просмотра данных, закодированных в токене.
Демо
На следующих сайтах показаны примеры развертывания токенов.
Как предоставить пробный токен Origin
- Токен в метатеге
- Токен в заголовке
- Токен, внедренный сторонним скриптом
- Функция, доступная в iframe
- Примеры кросс-источников iframe
Инструменты для испытаний Origin
Особенности в исходном испытании
Ниже приведены демонстрации API, находящихся в стадии текущих испытаний Origin.
Ресурсы
Продолжайте читать нашу документацию по концепции Chrome:
Узнайте больше о пробных версиях Origin в Chrome:
- Руководство для веб-разработчиков
- Объяснитель исходного судебного разбирательства
- Проведение испытания Origin
- Процесс запуска новых функций в Chromium
- Намерение объяснить: демистификация процесса доставки Blink
- Просмотр информации об испытаниях Origin в DevTools из Chrome 94
Другие браузеры
Найдите пробные версии Origin в других браузерах: