Поделиться через

Использование пробных версий источника в Microsoft Edge

  • Статья

Используйте пробные версии источника, чтобы опробовать экспериментальные API на вашем собственном динамическом сайте в течение ограниченного периода времени. При использовании пробных версий источника пользователи Microsoft Edge, посещающие ваш сайт, могут выполнять код, использующий экспериментальные API.

Чтобы просмотреть список доступных пробных версий источника и зарегистрировать источник, чтобы опробовать любую из пробных версий источника, см. статью Пробные версии источника Microsoft Edge. Чтобы оценить пригодность использования экспериментальных API на веб-сайте, проверка минимальные требования к версии Для Microsoft Edge и проверка дату окончания срока действия пробной версии.

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

Принцип работы маркера пробной версии источника

Механизм origin-trials позволяет пользователю веб-страницы использовать API экспериментальных функций пробной версии источника в браузере Microsoft Edge, несмотря на состояние off-by-by-default компонента. Браузер Microsoft Edge пользователя обнаруживает маркер исходной пробной версии, а затем автоматически включает флаг функции браузера, соответствующий исходной пробной версии, для которой маркер действителен. Пользователю не нужно задавать какие-либо edge://flags параметры в Microsoft Edge.

Для поддержки использования экспериментальных API-интерфейсов пробной версии источника на веб-сайте:

  1. Зарегистрируйте домен источника, в который вы хотите использовать экспериментальную функцию (например, https://example.com), а затем для вас будет создан маркер пробной версии источника.

  2. Скопируйте маркер на веб-страницу <head>/<meta> в элементе или в заголовке Origin-Trial ответа HTTP-сервера.

  3. Когда пользователь Microsoft Edge посещает веб-страницу и браузер находит маркер пробной версии источника, браузер включает связанную функцию origin-trial.

Регистрация для получения пробной версии источника

Чтобы зарегистрироваться для получения пробной версии источника, выполните приведенные далее действия.

  1. Перейдите в раздел Пробные версии источника Microsoft Edge.

    Чтобы зарегистрироваться для получения пробной версии api выбора рекламы, ознакомьтесь с разделом Регистрация в API выбора рекламы.

  2. Выберите активную пробную версию.

  3. Нажмите кнопку Принимаю условия использования .

  4. При появлении запроса войдите в систему. Например, войдите в GitHub, а затем авторизуйте страницу пробных версий источника Microsoft Edge для использования входа в учетную запись.

    Откроется форма регистрации пробной версии нового источника :

    Форма регистрации пробной версии нового источника

  5. В текстовом поле Домен введите URL-адрес домена (например https://example.com, ) или URL-адрес поддомена (например https://beta.example.com, ).

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

    • Один домен, например https://example.com, без поддержки его поддоменов.
    • Один поддомен, например https://beta.example.com.
    • Домен, например https://example.com, и его поддомены, например https://beta.example.com.

    Конечные пути и параметры запроса не поддерживаются. Если введен универсальный код ресурса (URI), имеющий конечный путь или параметр запроса, например https://example.com/path/new-feature, корневой домен (например https://example.com, ) или поддомен будут зарегистрированы, игнорируя все параметры конечного пути или запроса.

  6. Установите переключатель Включить маркер для поддоменов?

    • Чтобы включить использование пробной версии источника в домене (например https://example.com, ) без поддержки его поддоменов (например https://beta.example.com, ), убедитесь, что переключатель Включить маркер для поддоменов? отключен.

    • Чтобы включить использование пробной версии источника только в определенном поддомене (например https://beta.example.com, ), убедитесь, что переключатель Включить маркер для поддоменов? отключен.

    • Чтобы включить использование пробной версии источника в домене (например https://example.com, ) и его поддоменах (например, https://beta.example.com), включите переключатель Включить маркер для поддоменов? .

  7. Нажмите кнопку Отправить .

    Создается маркер пробной версии источника, который отображается в разделе Регистрация рядом с формой регистрации пробной версии нового источника :

    Созданный маркер, отображаемый в разделе Регистрация

  8. Нажмите кнопку Копировать , а затем вставьте маркер пробной версии источника в безопасное место, указав, для какого домена он находится. Эти сведения также можно просмотреть на этой веб-странице позже.

Использование маркера пробной версии источника на веб-сайте

Используйте маркер на веб-сайте в любом из следующих способов:

Вариант 1. Мета-тег <> в головном <> элементе веб-страницы

В элементе <head> веб-страницы добавьте следующий <meta> тег:

<meta http-equiv="origin-trial" content="EXAMPLE_TOKEN">

Замените EXAMPLE_TOKEN маркером.

Вариант 2. Заголовок HTTP в ответе HTTP-сервера

В ответе HTTP-сервера добавьте следующий заголовок HTTP:

Origin-Trial: EXAMPLE_TOKEN

Замените EXAMPLE_TOKEN маркером.

Отказ от пробного эксперимента источника

Чтобы отказаться от эксперимента (пробной версии источника), в который вы зарегистрированы, удалите маркер пробной версии источника из <meta> тега или из заголовков ответов сервера.

Обнаружение функций и обеспечение корректного резервного копирования

Рассматривайте пробные версии источника как экспериментальные. Как правило, в коде веб-сайта выполните обнаружение функций и предоставьте оптимальный резервный вариант для таких случаев:

  • Если API экспериментальных функций недоступен в браузере пользователя.
  • Если срок действия маркера исходной пробной версии истекает.
  • Если команда функций Microsoft Edge завершает пробную версию источника.

См . раздел Реализация обнаружения функций в MDN.

Тестирование пробной версии источника по адресу localhost

Чтобы протестировать функцию исходной пробной версии на странице localhost, перейдите edge://flags по адресу и включите соответствующий флаг функции.

Механизм, который обнаруживает и использует маркеры исходной пробной версии Microsoft Edge, поддерживается только для доменов с поддержкой SSL, но не для localhost.

Продление маркера пробной версии источника

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

Чтобы продлить маркер пробной версии источника, выполните приведенные далее действия.

  1. Перейдите в раздел Пробные версии источника Microsoft Edge.

    Пробную версию исходного API выбора рекламы см. в статье Регистрация для использования API выбора рекламы.

  2. В разделе Мои зарегистрированные пробные версии выберите исходную пробную версию.

  3. В разделе Регистрация в строке маркера, содержащей эмблему с истекшим сроком действия , нажмите кнопку Продлить :

    Пользовательский интерфейс для обновления маркера

    Создается и отображается новый токен.

  4. В строке, содержащей новый маркер, нажмите кнопку Копировать , а затем вставьте новый маркер в код.

Длительность пробной версии источника

Исходная пробная версия может длиться до запланированной даты окончания срока действия или может завершиться раньше.

Дата истечения срока действия по расписанию

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

Ранний конец

Группа поддержки Microsoft Edge может решить завершить эксперимент раньше, до истечения срока действия пробной версии. Например:

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

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

Предоставление отзывов о пробной версии источника

Оставьте отзыв об экспериментальной функции. Вкладка Проблемы репозитория GitHub компонента позволяет публично обсуждать удобство использования и стабильность функции.

Чтобы предоставить отзыв о пробной версии источника, выполните следующие действия.

  1. Перейдите в раздел Пробные версии источника Microsoft Edge.

  2. Выберите активную пробную версию.

  3. Нажмите кнопку Отзыв . Откроется вкладка Проблемы в репозитории GitHub продукта.

  4. Просмотрите проблемы.

  5. Если требуется новая проблема, нажмите кнопку Создать проблему .

Сведения о пробной версии источника API выбора рекламы см. в статье Предоставление отзывов о пробной версии источника в разделе Регистрация для использования API выбора рекламы.

См. также

API выбора рекламы:

Внешний: