Uso de pruebas de origen en Microsoft Edge

  • Artículo

Use las pruebas de origen para probar las API experimentales en su propio sitio en directo durante un período de tiempo limitado. Cuando se usan pruebas de origen, los usuarios de Microsoft Edge que visitan el sitio pueden ejecutar código que usa API experimentales.

Para ver una lista de las pruebas de origen disponibles y registrar el origen para probar cualquiera de las pruebas de origen, consulte Pruebas de origen de Microsoft Edge. Para evaluar la idoneidad del uso de las API experimentales en el sitio web, compruebe los requisitos mínimos de versión de Microsoft Edge y compruebe la fecha de expiración de la prueba.

Puede proporcionar comentarios a los ingenieros de características del explorador y a la comunidad de estándares web sobre el diseño de la API de la característica, los casos de uso o la experiencia con el uso de la API de la característica, mediante la pestaña Problemas del repositorio de la característica del explorador.

Funcionamiento del token de prueba de origen

El mecanismo de pruebas de origen permite a un usuario de la página web usar la API de características experimentales de la prueba de origen en su explorador Microsoft Edge, a pesar del estado predeterminado de la característica. El explorador Microsoft Edge del usuario detecta el token de la prueba de origen y, a continuación, activa automáticamente la marca de características del explorador que corresponde a la versión de prueba de origen para la que el token es válido. El usuario no necesita establecer ninguno edge://flags en Microsoft Edge.

Para admitir el uso de las API experimentales de una prueba de origen en el sitio web:

  1. Registre el dominio de origen en el que desea usar la característica experimental (por ejemplo, ) y, a continuación, https://example.comse genera un token de prueba de origen automáticamente.

  2. Copie el token en la página web dentro de un <head>/<meta> elemento o en un Origin-Trial encabezado de respuesta del servidor HTTP.

  3. Cuando un usuario de Microsoft Edge visita la página web y el explorador encuentra un token de prueba de origen, el explorador activa la característica de prueba de origen asociada.

Registro de una prueba de origen

Para registrarse para una prueba de origen:

  1. Vaya a Pruebas de origen de Microsoft Edge.

    Para registrarse en la versión de prueba de origen de Ad Selection API, consulte Registrarse en la API de selección de anuncios.

  2. Seleccione una prueba activa.

  3. Haga clic en el botón Acepto los términos de uso .

  4. Si se le pide, inicie sesión. Por ejemplo, inicie sesión en GitHub y, a continuación, autorice a la página Microsoft Edge Origin Trials a usar el inicio de sesión de la cuenta.

    Se abre el formulario Registro de prueba de Nuevo origen :

    Formulario de registro de prueba de Nuevo origen

  5. En el cuadro de texto Dominio, escriba una dirección URL de dominio (como https://example.com) o una dirección URL de subdominio (como ).https://beta.example.com

    Puede configurar el token de prueba de origen para admitir cualquiera de las siguientes opciones:

    • Un dominio único, como https://example.com, sin admitir sus subdominios.
    • Un único subdominio, como https://beta.example.com.
    • Un dominio, como https://example.com, y sus subdominios, como https://beta.example.com.

    No se admiten las rutas de acceso finales ni los parámetros de consulta. Si se escribe un URI que tiene una ruta de acceso final o un parámetro de consulta, como https://example.com/path/new-feature, se registrará el dominio raíz (como https://example.com) o el subdominio, omitiendo cualquier ruta de acceso final o parámetros de consulta.

  6. Establezca el botón de alternancia Habilitar token para subdominios .

    • Para habilitar el uso de la prueba de origen en un dominio (como https://example.com) sin admitir sus subdominios (por https://beta.example.comejemplo, ), asegúrese de que la opción Habilitar token para subdominios esté desactivada.

    • Para habilitar el uso de la prueba de origen solo en un subdominio específico (como https://beta.example.com), asegúrese de que la opción Habilitar token para subdominios esté desactivada.

    • Para habilitar el uso de la prueba de origen en un dominio (como https://example.com) y sus subdominios (por https://beta.example.comejemplo, ), active el botón de alternancia Habilitar token para subdominios.

  7. Haga clic en el botón Enviar .

    Se genera un token de prueba de origen y se muestra en la sección Registros cerca del formulario Registro de prueba de New Origin :

    Token generado que se muestra en la sección Registro

  8. Haga clic en el botón Copiar y pegue el token de prueba de origen en un lugar seguro y note para qué dominio es. También puede ver esta información en esta página web más adelante.

Uso del token de prueba de origen en el sitio web

Use el token en el sitio web de cualquiera de las siguientes maneras:

Opción 1: Metaetiqueta <> dentro del <elemento principal> de una página web

En el <head> elemento de una página web, incluya la siguiente <meta> etiqueta:

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

Reemplace EXAMPLE_TOKEN por el token.

Opción 2: Un encabezado HTTP en la respuesta del servidor HTTP

En la respuesta del servidor HTTP, agregue el siguiente encabezado HTTP:

Origin-Trial: EXAMPLE_TOKEN

Reemplace EXAMPLE_TOKEN por el token.

No participar en un experimento de prueba de origen

Para no participar en un experimento (prueba de origen) en el que esté inscrito, quite el token de prueba de origen de la <meta> etiqueta o de los encabezados de respuesta del servidor.

Realizar la detección de características y proporcionar una reserva correcta

Tratar las pruebas de origen como experimentales. Como procedimiento recomendado, en el código del sitio web, realice la detección de características y proporcione una reserva correcta para estos casos:

  • Si la API de características experimentales no está disponible en el explorador del usuario.
  • Si el token de prueba de origen expira.
  • Si el equipo de características de Microsoft Edge finaliza la prueba de origen.

Consulte Implementación de la detección de características en MDN.

Prueba de una prueba de origen en localhost

Para probar una característica de prueba de origen en localhost, vaya a edge://flags y active la marca de característica adecuada.

El mecanismo que detecta y usa tokens de prueba de origen de Microsoft Edge solo se admite para dominios habilitados para SSL, no para localhost.

Renovación de un token de prueba de origen

Los tokens de prueba de origen expiran en 6 semanas, de forma predeterminada. Cuando expire el token de prueba de origen, debe renovar el token, lo que significa generar un nuevo token nuevo para esta prueba de origen. Puede renovar el token antes de que expire.

Para renovar un token de prueba de origen:

  1. Vaya a Pruebas de origen de Microsoft Edge.

    Para obtener la versión de prueba de origen de Ad Selection API, consulte Registro para la API de selección de anuncios.

  2. En la sección Mis pruebas registradas , seleccione una prueba de origen.

  3. En la sección Registros , en una fila de token que contiene un distintivo expirado , haga clic en el botón Renovar :

    Interfaz de usuario para renovar un token

    Se genera y se muestra un token nuevo.

  4. En la fila que contiene el nuevo token, haga clic en el botón Copiar y pegue el token nuevo en el código.

Duración de una prueba de origen

Una prueba de origen puede durar hasta la fecha de expiración planeada o puede finalizar antes.

Fecha de expiración programada

Después de registrarse para una prueba, el token permanece válido hasta la fecha de expiración de la prueba que se muestra en la tarjeta informativa de la versión de prueba de origen. Después de la fecha de expiración de la prueba de origen, el token dejará de funcionar y la característica asociada a la versión de prueba de origen se considerará lista para enviarse, o bien la característica se retendrá para su posterior desarrollo.

Fin anticipado

Un equipo de características de Microsoft Edge puede decidir finalizar un experimento antes de la fecha de expiración de la prueba; por ejemplo:

  • Si la característica provoca un incidente de seguridad.
  • Si el equipo de características ha recopilado suficientes comentarios y ha llegado a la conclusión de que la API propuesta actualmente no satisface las necesidades de los desarrolladores web y debe producirse un rediseño importante.

Si un experimento finaliza temprano, el equipo de características propietario de la prueba de origen envía correos electrónicos a todos los desarrolladores inscritos en el experimento.

Proporcionar comentarios sobre una prueba de origen

Proporcione comentarios sobre la característica experimental. La pestaña Problemas del repositorio de GitHub de la característica permite un discurso público sobre la facilidad de uso y la estabilidad de la característica.

Para proporcionar comentarios sobre una prueba de origen:

  1. Vaya a Pruebas de origen de Microsoft Edge.

  2. Seleccione una prueba activa.

  3. Haga clic en el botón Comentarios . Se abre la pestaña Problemas del repositorio de GitHub del producto.

  4. Ver los problemas.

  5. Si se necesita un nuevo problema, haga clic en el botón Nuevo problema .

Para obtener la versión de prueba de origen de Ad Selection API, consulte Proporcionar comentarios sobre la prueba de origen en Registrarse para la API de selección de anuncios.

Consulte también

API de selección de anuncios:

Externo: