Prova del ritiro della riduzione dello user agent
bookmark_border Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

La prova del 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 da Chrome 101, le informazioni disponibili nella stringa User-Agent (UA) verranno ridotte utilizzando un approccio graduale. I siti che non hanno avuto il tempo di eseguire la migrazione dall'utilizzo della stringa dello user agent ridotta e passare ai client hint User-Agent possono partecipare a una prova di ritiro per continuare a ricevere la stringa completa dello user agent.

La registrazione per la prova del ritiro inizierà con la versione beta di Chrome 100. Consentirà ai siti di ricevere la stringa User-Agent completa prima del rilascio di Chrome 101, in cui la stringa della versione secondaria verrà ridotta. Se vuoi testare la prova dell'origine su Chrome 100 Beta prima del lancio nel canale stabile, assicurati di registrarti e testare prima della data di rilascio di Chrome 100 (attualmente prevista per il 31 marzo 2022).

Di seguito è riportata una panoramica della prova del ritiro e cosa aspettarsi. Se hai feedback da condividere o riscontri problemi durante la prova, non esitare a contattarci nel repository GitHub di UA Reduction.

Che cosa significa per gli sviluppatori web?

Se partecipi alla prova del ritiro, i siti continueranno a ricevere la stringa UA completa in navigator.userAgent e i valori non ridotti nei getter JavaScript navigator.platform e navigator.appVersion correlati:

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 controllare l'utilizzo dell'intestazione User-Agent e delle API correlate e, se necessario, prepararsi a eseguire la migrazione ai suggerimenti client User-Agent prima della scadenza della prova di ritiro. L'intenzione è di far scadere questa prova di ritiro al termine dell'implementazione della riduzione degli User-Agent.

Come faccio a partecipare alla prova del ritiro della riduzione dell'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 una terza parte che si registra, seleziona "Corrispondenza con terze parti".

Configurazione

Dopo aver effettuato la registrazione per la prova, aggiorna le intestazioni di risposta HTTP con quanto segue:

Aggiungi Origin-Trial: <ORIGIN TRIAL TOKEN> all'intestazione della risposta HTTP. <ORIGIN TRIAL TOKEN> contiene il token che hai ricevuto durante la registrazione per la prova dell'origine.
Aggiungi Accept-CH: Sec-CH-UA-Full all'intestazione della risposta HTTP. L'impostazione Accept-CH comporterà l'invio della stringa User-Agent completa solo nelle richieste successive all'origine.
Se la stringa completa dello user-agent è fondamentale alla prima richiesta, aggiungi Critical-CH: Sec-CH-UA-Full all'intestazione di risposta HTTP, oltre alle intestazioni Accept-CH e Origin-Trial.
Per i partecipanti che si uniscono alla prova di ritiro della riduzione, consigliamo di consentire a tutti i domini di terze parti di accedere alla stringa user agent completa. Il mancato prolungamento dell'accesso dei domini di terze parti alla stringa completa dello user agent comporterà il blocco dell'accesso alla stringa completa dello user agent, indipendentemente dalla registrazione alla prova di ritiro della riduzione. Puoi consentire l'accesso completo alla stringa dello user agent ai domini di terze parti utilizzando una delle due opzioni seguenti:
- Aggiungi un'intestazione Permissions-Policy con i domini di terze parti che devono 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 metatag Accept-CH con i domini di terze parti che devono ricevere la stringa completa dello user agent (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 eseguire la delega a tutti i domini di terze parti tramite * nel tag meta.
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 (oltre al codice sorgente).

Come faccio a verificare che la prova funzioni?

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

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

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

Le intestazioni di 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 della funzionalità di riduzione degli user-agent?

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

Invia un'intestazione Accept-CH nella risposta HTTP che non include Sec-CH-UA-Full. Tieni presente che Accept-CH con un valore vuoto è un modo valido per farlo se il tuo sito non richiede altri indicatori client.
Rimuovi l'intestazione Origin-Trial per la prova del ritiro della riduzione dello user agent dalla risposta HTTP.
Se impostato, rimuovi Sec-CH-UA-Full dall'intestazione Critical-CH nella risposta HTTP.

In che modo questa prova è diversa dalle altre prove dell'origine dell'agente utente?

In Chrome sono in corso due prove delle origini relative alla riduzione dello user agent. La prima è stata la sperimentale di origine per la riduzione dello user agent, che ha consentito ai siti di ricevere la stringa dello user agent ridotta per testare i casi d'uso e fornire feedback prima che diventasse il comportamento predefinito in Chrome.

Il secondo, a cui si fa riferimento qui, è un periodo di prova di ritiro destinato ai siti che hanno bisogno di un po' più di tempo per eseguire la migrazione all'API User-Agent Client Hints. Consente ai siti di continuare a ricevere la stringa User-Agent completa.

Quanto durerà la prova del ritiro?

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

Come faccio a condividere un feedback per la prova del ritiro della riduzione dello user agent?

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