Iniziare a utilizzare le prove dell'origine

Testare una funzionalità della piattaforma web nuova o sperimentale.

Sam Dutton

Origin trials consente di accedere a una funzionalità nuova o sperimentale, in modo da poterla testare e offrirla ai tuoi utenti per un periodo di tempo limitato. Una volta completata la prova e valutato il feedback, Chrome decide se rendere la funzionalità disponibile per tutti.

Puoi registrarti per una prova dell'origine per attivare una funzionalità per tutti gli utenti della tua origine, senza richiedere loro di attivare o disattivare i flag o di passare a una build alternativa di Chrome (anche se potrebbe essere necessario 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 comprendere come vengono utilizzate le nuove funzionalità e come possono interagire con altre tecnologie web.

Disponibilità

Le prove delle origini sono pubbliche e aperte a tutti gli sviluppatori. La loro durata e il loro utilizzo sono limitati. La partecipazione è un processo autogestito con documentazione e assistenza limitate. I partecipanti devono essere disposti e in grado di lavorare in modo relativamente autonomo utilizzando la documentazione disponibile, che, in questa fase, è probabilmente limitata alle specifiche e alle spiegazioni dell'API. Cerchiamo di fornire indicazioni, se possibile.

Se ti registri per una prova, il team di Chrome ti chiederà periodicamente un feedback specifico sul tuo utilizzo della funzionalità di prova. Alcune funzionalità potrebbero essere sottoposte a più prove di origine, man mano che vengono incorporati i feedback e apportate modifiche.

Le prove dell'origine sono disponibili anche per Firefox e Microsoft Edge.

Prove di origini di terze parti

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

Scopri di più: Che cosa sono i trial delle origini di terze parti?

Prove relative al ritiro

Alcuni Origin trials ti consentono di riattivare temporaneamente una funzionalità ritirata. Si tratta delle prove di ritiro. In alcuni contesti, vengono chiamate prove dell'origine "inversa".

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 per la prova del ritiro per riattivarli temporaneamente su siti specifici.

Partecipare a una prova dell'origine

  1. Scegli una prova dell'origine 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 attivare la funzionalità di prova:
  4. Prova la nuova funzionalità.
  5. Invia feedback. Per farlo, vai al sito della prova dell'origine. Questo feedback non è pubblico ed è disponibile solo per un gruppo limitato di persone del team di Chrome. Ogni prova fornisce anche un link per i feedback spontanei della community. In genere rimanda alla funzionalità su GitHub o su un altro canale pubblico.
  6. Quando il token scade, riceverai un'email con un link per il rinnovo. Per farlo, ti verrà chiesto di inviare nuovamente un feedback.

Puoi registrarti per la stessa prova dell'origine più volte, per origini diverse e includere più token nella stessa pagina. Ciò può essere utile se devi fornire token validi per le risorse pubblicate da origini diverse, ad esempio il codice incluso su più siti di tua proprietà.

Il framework dei trial delle origini cerca il primo token valido e ignora tutti gli altri token. Puoi convalidare questa operazione con Chrome DevTools.

Fornire un token in modo programmatico

Anziché fornire un token come intestazione HTTP o come meta tag nel codice HTML della pagina, come descritto in precedenza, puoi iniettare 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 stai partecipando 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 tag meta, un'intestazione HTTP o programmaticamente.

Come per tutto l'utilizzo 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 elemento <script> per JavaScript incluso da un file esterno.

Token ed estensioni

Per utilizzare una funzionalità di prova all'interno di un script in background, popup, riquadro laterale o documento offscreen, utilizza la chiave trial_tokens nel file manifest.json.

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

Gli script di contenuti vengono gestiti in modo diverso. L'esposizione di una funzionalità a un mondo potrebbe essere confusa e non intuitiva. 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 viene eseguito lo script dei contenuti anziché per l'ID dell'estensione.

Per registrare l'estensione per una prova, utilizza l'URLchrome-extension://YOUR_EXTENSION_ID, ad esempiochrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

Rinnovare la registrazione alla prova dell'origine

Se la prova di un'origine viene estesa, riceverai un avviso via email che ti comunica 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 RINNOVI. Esempio di pagina Le mie registrazioni, con i pulsanti RINNOVO
  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.

Visualizzare le informazioni sulla prova dell'origine

Visualizza le informazioni sulle prove dell'origine disponibili per un sito dal riquadro Applicazione in Chrome DevTools.

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

Puoi anche utilizzare il nostro decodificatore di token di prova dell'origine per visualizzare i dati codificati in un token.

Strumento di decodifica della prova dell&#39;origine che mostra i valori decodificati della prova dell&#39;origine.

Demo

I seguenti siti mostrano esempi di implementazione dei token.

Come fornire un token di prova dell'origine

Strumenti per le prove dell'origine

Funzionalità della prova dell'origine

Di seguito sono riportate le demo per le API in corso di prova di origine

Risorse

Continua a leggere la nostra documentazione relativa ai concetti di Chrome:

Scopri di più sulle prove delle origini in Chrome:

Altri browser

Trovare le prove dell'origine in altri browser: