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

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

A partir de Chrome 101, se reducirá la información disponible en la cadena usuario-agente (UA) con un enfoque por fases. Los sitios que no tuvieron tiempo de migrar del uso de la cadena de usuario-agente reducida y que cambiaron a User-Agent Client Hints 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. Permitirá que los sitios reciban la cadena de usuario-agente completa antes de la versión 101 de Chrome, en la que se reducirá la cadena de la versión secundaria. Si deseas probar la prueba de origen en la versión beta de Chrome 100 antes de su lanzamiento en el canal estable, asegúrate de registrarte y realizar pruebas antes de la fecha de lanzamiento de Chrome 100 (actualmente programado para el 31 de marzo de 2022).

A continuación, se incluye una descripción general de la prueba de baja y qué esperar. Si tienes comentarios para compartir o tienes algún problema durante esta prueba, comunícate con nosotros en el repositorio de GitHub de reducción de UA.

¿Qué significa esto para los desarrolladores web?

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

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

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

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

Regístrate para la prueba

Si quieres registrarte para la prueba de origen y obtener un token para tus dominios, visita la página de la prueba de baja de la reducción de usuario-agente. Si usted es un tercero que se está registrando, marque "Coincidencia de terceros".

Configuración

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

  1. Agrega Origin-Trial: <ORIGIN TRIAL TOKEN> al encabezado de respuesta HTTP. <ORIGIN TRIAL TOKEN> contiene el token que obtuviste cuando te registraste en la prueba de origen.
  2. Agrega Accept-CH: Sec-CH-UA-Full al encabezado de respuesta HTTP. Si configuras Accept-CH, solo se enviará la cadena de usuario-agente completa en las solicitudes posteriores al origen.
  3. Si la string de usuario-agente completa es crítica 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. A los participantes que se unan a la prueba de baja de la reducción, te sugerimos que permitas que todos los dominios de terceros accedan a la cadena de usuario-agente completa. Si no se extiende el acceso a la string de usuario-agente completa a dominios de terceros, se bloqueará el acceso completo a dicha string, independientemente de su propio registro de prueba de baja de la reducción. Para permitir el acceso completo a la cadena de usuario-agente a dominios de terceros, utiliza una de las siguientes dos opciones:

    • Agrega un encabezado Permissions-Policy con los dominios de terceros que deben recibir la string de usuario-agente completa.
      • Para permitir todos los dominios de terceros, agrega Permissions-Policy: ch-ua-full=*.
      • Para permitir una lista con nombre 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 con nombre 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 metaetiqueta.

  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 valido que la prueba esté funcionando?

Para validar que la prueba de origen funcione, examina los encabezados de la solicitud y asegúrate de que se cumpla 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 usuario-agente reducidas). Una manera fácil de saber es que la cadena de la 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 deberían verse de la siguiente manera:

Los encabezados de solicitudes posteriores que contengan la string de usuario-agente completa deberían verse de la siguiente manera:

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

En cualquier momento de 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 de Client Hint.
  2. Quita de tu respuesta HTTP el encabezado Origin-Trial de la prueba de baja de la reducción de usuario-agente.
  3. Si se configura, quita Sec-CH-UA-Full del encabezado Critical-CH en tu respuesta HTTP.

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

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

La segunda, a la que se hace referencia aquí, es una prueba de baja destinada a 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 string de usuario-agente completa.

¿Cuánto durará la prueba de baja?

La prueba de baja de la reducción de usuario-agente se ejecutará de Chrome 100 a 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 amortización de la reducción de usuario-agente?

Envía cualquier problema o comentario al repositorio de GitHub de reducción de usuario-agente.