Prueba de baja de la reducción de usuario-agente

bookmark_border Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

La prueba de baja de la reducción de usuario-agente permitió que los sitios siguieran recibiendo la cadena de usuario-agente completa después de la reducción de la cadena de UA. La prueba finalizó el 23 de septiembre de 2023.

A partir de Chrome 101, la información disponible en la cadena de usuario-agente (UA) se reducirá con un enfoque por fases. Los sitios que no tuvieron tiempo de migrar del uso de la cadena de usuario-agente reducida a las Sugerencias de cliente de usuario-agente pueden participar en una prueba de baja para seguir recibiendo la cadena de usuario-agente completa.

El registro para la prueba de baja comenzará con la versión beta de Chrome 100. Esto permitirá que los sitios reciban la cadena de usuario-agente completa antes del lanzamiento de Chrome 101, en el que se reducirá la cadena de versión secundaria. Si quieres probar la prueba de origen en Chrome 100 beta antes de que se lance en el canal estable, asegúrate de registrarte y realizar la prueba antes de la fecha de lanzamiento de Chrome 100 (actualmente programada para el 31 de marzo de 2022).

A continuación, se incluye una descripción general de la prueba de baja y lo que puedes esperar. Si tienes comentarios para compartir o encuentras algún problema durante esta prueba, infórmanos en el repositorio de GitHub de UA Reduction.

¿Qué significa esto para los desarrolladores web?

Si te inscribes en la prueba de baja, los sitios seguirán recibiendo la cadena UA completa en navigator.userAgent y valores no reducidos en los getters de JavaScript navigator.platform y navigator.appVersion relacionados:

• El encabezado de la solicitud HTTP User-Agent
• El método get de JavaScript navigator.userAgent
• El método get de JavaScript navigator.platform
• El método get de JavaScript navigator.appVersion

Los sitios deben auditar su uso del encabezado User-Agent y las APIs relacionadas, y, si es necesario, prepararse para migrar a User-Agent Client Hints antes de que venza la prueba de baja. El objetivo es que venza esta prueba de baja una vez que se complete el lanzamiento de la reducción del usuario-agente.

¿Cómo puedo participar en la prueba de baja de la reducción de detalles en usuario-agente?

Regístrate para la prueba

Para registrarte en la prueba de origen y obtener un token para tus dominios, visita la página de prueba de baja de la reducción de usuario-agente. Si te registras como tercero, marca "Coincidencia de terceros".

Configuración

Una vez que te registres para la prueba, actualiza los encabezados de respuesta HTTP con lo siguiente:

1. Agrega Origin-Trial: <ORIGIN TRIAL TOKEN> a tu encabezado de respuesta HTTP. <ORIGIN TRIAL TOKEN> contiene el token que obtuviste cuando te registraste para la prueba de origen.
2. Agrega Accept-CH: Sec-CH-UA-Full a tu encabezado de respuesta HTTP. La configuración de Accept-CH solo hará que se envíe la cadena completa de User-Agent en las solicitudes posteriores al origen.
3. Si la cadena User-Agent completa es fundamental en la primera solicitud, agrega Critical-CH: Sec-CH-UA-Full al encabezado de respuesta HTTP, además de los encabezados Accept-CH y Origin-Trial.

4. Para los participantes que se unan a la prueba de baja de la reducción, sugerimos permitir que todos los dominios de terceros accedan a la cadena de usuario-agente completa. Si no extiendes el acceso de los dominios de terceros a la cadena de usuario-agente completa, se bloqueará su acceso a esta, independientemente de su registro en la prueba de baja de la reducción. Puedes permitir el acceso completo de la cadena de usuario-agente a dominios de terceros con una de las siguientes dos opciones:

   • Agrega un encabezado Permissions-Policy con los dominios de terceros que deben recibir la cadena de usuario-agente completa.
     • Para permitir todos los dominios de terceros, agrega Permissions-Policy: ch-ua-full=*.
     • Para permitir una lista nombrada de dominios de terceros, agrega Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
   • Agrega una metaetiqueta Accept-CH con los dominios de terceros que deben recibir la cadena de usuario-agente completa (solo en Chrome 100 y versiones posteriores).
     • Para permitir una lista nombrada de dominios de terceros, agrega <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
     • No es posible delegar a todos los dominios de terceros a través de * en la etiqueta meta.

5. Carga tu sitio web en Chrome 100 (o versiones posteriores) y sigue recibiendo la cadena de usuario-agente completa.

Demostración

Consulta https://uard-ot-demo.glitch.me para ver una demostración de la prueba (junto con el código fuente).

¿Cómo puedo validar que la prueba esté funcionando?

Para validar que la prueba de origen funcione, examina los encabezados de solicitud y asegúrate de lo siguiente:

1. El encabezado User-Agent contiene la versión completa. No debe contener ninguno de los valores reducidos (que se encuentran en la lista de muestras de cadenas de User-Agent reducidas). Una forma sencilla de saberlo es que la cadena de versión secundaria de Chrome no debe ser 0.0.0.
2. El encabezado Sec-CH-UA-Full se establece en ?1.

Los encabezados de la respuesta inicial que contienen el token de prueba de origen deben tener el siguiente aspecto:

Los encabezados de solicitud posteriores que contengan la cadena de usuario-agente completa deben tener el siguiente aspecto:

¿Cómo puedo dejar de participar en la prueba de baja de la reducción de usuario-agente?

En cualquier momento durante la prueba, puedes dejar de participar y recibir la cadena de usuario-agente reducida. Para dejar de participar, sigue estos pasos:

1. Envía un encabezado Accept-CH en tu respuesta HTTP que no incluya Sec-CH-UA-Full. Ten en cuenta que Accept-CH con un valor vacío es una forma válida de lograr esto si tu sitio no solicita ninguna otra sugerencia del cliente.
2. Quita el encabezado Origin-Trial de la prueba de baja de la reducción de usuario-agente de tu respuesta HTTP.
3. Si está configurado, quita Sec-CH-UA-Full del encabezado Critical-CH en tu respuesta HTTP.

¿En qué se diferencia esta prueba de otras pruebas de origen del usuario-agente?

Chrome está ejecutando dos pruebas de origen relacionadas con la reducción del usuario-agente. La primera fue la prueba de origen de reducción de usuario-agente, que permitió que los sitios recibieran la cadena de usuario-agente reducida para probar sus casos de uso y proporcionar comentarios antes de que se convirtiera en el comportamiento predeterminado de Chrome.

La segunda, a la que se hace referencia aquí, es una prueba de baja destinada a los sitios que necesitan un poco más de tiempo para migrar a la API de User-Agent Client Hints. Permite que los sitios sigan recibiendo la cadena de usuario-agente completa.

¿Cuánto durará la prueba de baja?

La prueba de baja de la reducción de usuario-agente se ejecutará desde Chrome 100 hasta Chrome 115. Chrome 116 será la primera versión en la que solo se enviará la cadena de usuario-agente completamente reducida.

¿Cómo puedo compartir comentarios sobre la prueba de depreciación de la reducción de detalles en usuario-agente?

Envía cualquier problema o comentario al repositorio de GitHub de User-Agent Reduction.