Prova del ritiro della riduzione dello user agent

La prova relativa al ritiro della riduzione dello user agent ha consentito ai siti di continuare a ricevere la stringa completa dello user agent dopo la riduzione della stringa UA. La prova è terminata il 23 settembre 2023.

A partire dalla versione 101 di Chrome, le informazioni disponibili nella stringa User-Agent (UA) verranno ridotte mediante un approccio graduale. I siti che non hanno avuto il tempo di interrompere l'utilizzo della stringa User-Agent ridotta e di passare verso User-Agent Client Hints possono partecipare a una prova relativa al ritiro per continuare a ricevere la stringa User-Agent completa.

La registrazione per la prova relativa al ritiro inizierà con Chrome 100 Beta. Consentirà ai siti di ricevere la stringa completa dello user agent prima della release 101 di Chrome, con la conseguente riduzione della stringa della versione secondaria. Se vuoi testare la prova dell'origine su Chrome 100 Beta prima del lancio sul canale stabile, assicurati di registrarti e testare l'origine di Chrome 100 prima della data di rilascio (attualmente prevista per il 31 marzo 2022).

Di seguito è riportata una panoramica della prova relativa al ritiro e di cosa aspettarsi. Se hai feedback da condividere o se riscontri problemi durante la prova, faccelo sapere nel repository GitHub di riduzione di UA.

Cosa cambia per gli sviluppatori web?

Con la registrazione alla prova relativa al ritiro, i siti continueranno a ricevere la stringa UA completa in navigator.userAgent e i valori non ridotti nei relativi getter JavaScript navigator.platform e navigator.appVersion:

  • L'intestazione della richiesta HTTP User-Agent
  • Il getter JavaScript navigator.userAgent
  • Il getter JavaScript navigator.platform
  • Il getter JavaScript navigator.appVersion

I siti devono comunque verificare l'utilizzo dell'intestazione User-Agent e delle relative API e, se necessario, prepararsi a eseguire la migrazione a User-Agent Client Hints prima della scadenza della prova relativa al ritiro. L'intento è quello di far scadere questa prova sul ritiro al termine dell'implementazione della riduzione dello user agent.

Come faccio a partecipare alla prova relativa al ritiro di Riduzione dello user agent?

Registrati per la prova

Per registrarti alla prova dell'origine e ricevere un token per i tuoi domini, visita la pagina della prova relativa al ritiro della riduzione dello user agent. Se sei un terzo che effettua la registrazione, seleziona "Corrispondenza di terze parti".

Configurazione

Dopo esserti registrato alla prova, aggiorna le intestazioni delle risposte HTTP con i seguenti elementi:

  1. Aggiungi Origin-Trial: <ORIGIN TRIAL TOKEN> all'intestazione della risposta HTTP. <ORIGIN TRIAL TOKEN> contiene il token che hai ricevuto durante la registrazione alla prova dell'origine.
  2. Aggiungi Accept-CH: Sec-CH-UA-Full all'intestazione della risposta HTTP. Con l'impostazione Accept-CH, verrà inviata la stringa completa dello user agent solo per le richieste successive all'origine.
  3. Se la stringa completa dello user agent è fondamentale alla prima richiesta, aggiungi Critical-CH: Sec-CH-UA-Full all'intestazione della risposta HTTP, oltre alle intestazioni Accept-CH e Origin-Trial.

  4. Per i partecipanti alla prova relativa al ritiro della riduzione, suggeriamo di consentire a tutti i domini di terze parti l'accesso alla stringa completa dello user agent. La mancata estensione dell'accesso alla stringa completa dello user agent ai domini di terze parti bloccherà l'accesso completo alla stringa dello user agent, indipendentemente dalla registrazione della prova per il ritiro della riduzione. Puoi consentire l'accesso completo alla stringa User-Agent ai domini di terze parti in uno dei seguenti modi:

    • Aggiungi un'intestazione Permissions-Policy con i domini di terze parti che dovrebbero ricevere la stringa User-Agent completa.
      • Per consentire tutti i domini di terze parti, aggiungi Permissions-Policy: ch-ua-full=*.
      • Per consentire un elenco denominato di domini di terze parti, aggiungi Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
    • Aggiungi un meta tag Accept-CH con i domini di terze parti che devono ricevere la stringa dello user agent completa (solo in Chrome 100 e versioni successive).
      • Per consentire un elenco denominato di domini di terze parti, aggiungi <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
      • Non è possibile delegare tutti i domini di terze parti tramite * nel meta tag.

  5. Carica il tuo sito web in Chrome 100 (o versioni successive) e continua a ricevere la stringa User-Agent completa.

Demo

Visita la pagina https://uard-ot-demo.glitch.me per una dimostrazione della prova (insieme al codice sorgente).

Come faccio a verificare che la prova funzioni?

Per verificare che la prova dell'origine funzioni, esamina le intestazioni della richiesta e verifica quanto segue:

  1. L'intestazione User-Agent contiene la versione completa. Non deve contenere i valori ridotti (disponibili nell'elenco di esempi di stringhe user agent ridotte). Un modo semplice per capire è che la stringa della versione secondaria di Chrome non deve essere 0.0.0.
  2. L'intestazione Sec-CH-UA-Full è impostata su ?1.

Le intestazioni della risposta iniziale contenenti il token della prova dell'origine dovrebbero avere il seguente aspetto:

Le intestazioni della richiesta successive contenenti la stringa completa dello user agent dovrebbero avere il seguente aspetto:

Come faccio a interrompere la partecipazione alla prova relativa al ritiro di Riduzione dello user agent?

In qualsiasi momento durante la prova, puoi interrompere la partecipazione e ricevere la stringa User-Agent ridotta. Per interrompere la partecipazione:

  1. Invia nella risposta HTTP un'intestazione Accept-CH che non include Sec-CH-UA-Full. Tieni presente che Accept-CH con un valore vuoto è un modo valido per eseguire questa operazione se il tuo sito non richiede altri client hint.
  2. Rimuovi l'intestazione Origin-Trial per la prova relativa al ritiro dello user agent dalla risposta HTTP.
  3. Se impostato, rimuovi Sec-CH-UA-Full dall'intestazione Critical-CH nella risposta HTTP.

Qual è la differenza tra questa prova e altre prove dell'origine dello user agent?

Chrome sta eseguendo due prove dell'origine relative alla riduzione dello user agent. La prima è stata la prova dell'origine della riduzione dello user agent, che ha consentito ai siti di ricevere la stringa dello user agent ridotta per testare i loro casi d'uso e fornire feedback prima che diventasse il comportamento predefinito in Chrome.

La seconda, a cui viene fatto riferimento qui, è una prova relativa al ritiro, destinata ai siti che richiedono più tempo per eseguire la migrazione all'API User-Agent Client Hints. Consente ai siti di continuare a ricevere la stringa completa dello user agent.

Quanto durerà la prova relativa al ritiro?

La prova relativa al ritiro della riduzione dello user agent sarà eseguita da Chrome 100 a Chrome 115. Chrome 116 sarà la prima release a cui viene inviata solo la stringa User-Agent completamente ridotta.

Come faccio a condividere un feedback per la prova relativa alla riduzione dello user agent?

Invia eventuali problemi o feedback al repository GitHub di riduzione dello user agent.