Iniziare a utilizzare le prove dell'origine

Testa una funzionalità della piattaforma web nuova o sperimentale.

Sam Dutton

Origin trials consente di accedere a funzionalità nuove o sperimentali, in modo da poterle testare e offrirle ai tuoi utenti per un periodo di tempo limitato. Una volta completata la prova e valutato il feedback, Chrome decide se la funzionalità deve essere resa disponibile a tutti.

Puoi registrarti a un origin trial per attivare una funzionalità per tutti gli utenti della tua origine, senza che debbano attivare flag o passare a una build alternativa di Chrome (anche se potrebbero dover eseguire l'upgrade). Una volta registrati, gli sviluppatori possono creare demo e prototipi utilizzando le nuove funzionalità. Le prove aiutano anche gli ingegneri di Chrome a capire come vengono utilizzate le nuove funzionalità e come potrebbero interagire con altre tecnologie web.

Disponibilità

Gli origin trial sono pubblici e aperti a tutti gli sviluppatori. Hanno una durata e un utilizzo limitati. La partecipazione è un processo autogestito con documentazione e assistenza limitate. I partecipanti devono essere disposti e in grado di lavorare in modo relativamente indipendente utilizzando la documentazione disponibile che, in questa fase, è probabilmente limitata alle specifiche e alle spiegazioni delle API. Cerchiamo di fornire indicazioni quando possibile.

Se ti registri per una prova, il team di Chrome ti chiederà periodicamente un feedback specifico sull'utilizzo della funzionalità di prova. Alcune funzionalità potrebbero essere sottoposte a più origin trial, man mano che il feedback viene incorporato e vengono apportate modifiche.

Gli origin trial sono disponibili anche per Firefox e Microsoft Edge.

Origin trial di terze parti

Per impostazione predefinita, una funzionalità di origin trial è disponibile solo sull' origine registrata per la prova. Alcune prove forniscono un'opzione di corrispondenza di terze parti al momento della registrazione. In questo modo, i fornitori di contenuti o servizi incorporati possono provare una nuova funzionalità su più siti, senza richiedere un token per ogni origine.

Scopri di più: Che cosa sono gli origin trial di terze parti?

Deprecation trial

Alcuni origin trial consentono di riattivare temporaneamente una funzionalità ritirata. Questi sono noti come deprecation trial. In alcuni contesti, vengono definiti origin trial "inversi".

Ad esempio, gli eventi di mutazione sono stati rimossi, a partire da Chrome 127. I siti che hanno bisogno di più tempo prima di rimuovere questi eventi possono registrarsi al deprecation trial per riattivare temporaneamente gli eventi sui siti specificati.

Partecipa a un origin trial

  1. Scegli un origin trial dall' elenco delle prove attive.
  2. Richiedi un token facendo clic sul pulsante Registrati e compilando il modulo.
  3. Fornisci il token su ogni pagina web per la quale vuoi che la funzionalità di prova sia attivata:
    • Come meta tag nel tag <head>: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
    • Come intestazione HTTP: Origin-Trial: TOKEN_GOES_HERE
    • Fornendo un token in modo programmatico.
  4. Prova la nuova funzionalità.
  5. Invia feedback. Per farlo, vai al sito dell'origin trial. Questo feedback non è pubblico ed è disponibile solo per un gruppo limitato di persone del team di Chrome. Ogni prova fornisce anche un link per il feedback spontaneo della community. In genere, questo link rimanda alla funzionalità su GitHub o su un altro canale pubblico.
  6. Quando il token scade, riceverai un'email con un link di rinnovo. Per farlo, ti verrà chiesto di inviare nuovamente un feedback.

Puoi registrarti più volte allo stesso origin trial, per origini diverse, e includere più token nella stessa pagina. Questa opzione può essere utile se devi fornire token validi per le risorse pubblicate da origini diverse, ad esempio codice incluso in più siti di tua proprietà.

Il framework degli origin trial cerca il primo token valido e poi ignora tutti gli altri token. Puoi convalidare questa operazione con Chrome DevTools.

Fornisci un token in modo programmatico

Anziché fornire un token come intestazione HTTP o come meta tag nell'HTML della pagina, come descritto in precedenza, puoi inserire un token con JavaScript:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

Utilizza questo metodo se partecipi a una prova di terze parti.

Token e iframe

Per accedere a una funzionalità di prova da un iframe, puoi fornire un token di prova in un meta tag, un'intestazione HTTP o in modo programmatico.

Come per tutti gli utilizzi dei token, l'origine registrata per il token deve corrispondere al contesto di JavaScript che accede alla funzionalità di prova: l'origine della pagina che include uno script in linea o il src di un <script> elemento per JavaScript incluso da un file esterno.

Token ed estensioni

Per utilizzare una funzionalità di prova all'interno di uno script di sfondo, popup, riquadro laterale o un documento fuori schermo, utilizza la chiavetrial_tokens nel tuo file manifest.json.

"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]

Gli script di contenuti vengono gestiti in modo diverso. Esporre una funzionalità a un mondo potrebbe essere fonte di confusione e non intuitivo. Anziché utilizzare trial_token del manifest, aggiungi il token alla pagina in uno dei seguenti modi:

Ricorda che i token sono associati a domini specifici, quindi devi registrarti per il dominio su cui è in esecuzione lo script di contenuti, anziché per l'ID dell'estensione.

Per registrare l'estensione per una prova, utilizza l'URL chrome-extension://YOUR_EXTENSION_ID, ad esempio chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

Rinnova la registrazione all'origin trial

Se un origin trial viene esteso, riceverai un'email di avviso che ti informa che devi rinnovare la registrazione e fornire un nuovo token per ogni origine registrata alla prova.

  1. Vai a Le mie registrazioni.
  2. Per ogni origine registrata per la prova estesa, fai clic su RINNOVA. Esempio della pagina Le mie registrazioni con i pulsanti RINNOVA
  3. Copia il nuovo token e rendilo disponibile per ogni pagina che deve rimanere registrata alla prova. Se necessario, puoi fornire più token.

Chrome ignora i token non validi o scaduti.

Visualizza le informazioni sull'origin trial

Visualizza le informazioni sugli origin trial disponibili per un sito dal riquadro Applicazione di Chrome DevTools.

Visualizzazione dei dettagli del frame del riquadro Applicazione di Chrome DevTools.

Funzionalità in origin trial

Di seguito sono riportate le demo delle API negli origin trial in corso

Risorse

Continua a leggere la nostra documentazione concettuale di Chrome:

Scopri di più sugli origin trial in Chrome:

Altri browser

Trova gli origin trial in altri browser:

Indietro
Varianti di Chrome
Avanti
Prove dell'origine di terze parti