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, per creare funzionalità che gli utenti possono provare per un periodo di tempo limitato prima che la funzionalità sia resa disponibile per tutti.

Quando Chrome offre una prova dell'origine per una funzionalità, puoi registrarti alla prova per attivare la 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). Origin trials consente agli sviluppatori di creare demo e prototipi utilizzando nuove funzionalità. Le prove aiutano anche gli ingegneri di Chrome a capire come vengono utilizzate le nuove funzionalità e come possono interagire con altre tecnologie web.

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 ed essere in grado di lavorare in modo relativamente indipendente utilizzando la documentazione disponibile, che in questa fase sarà probabilmente limitata alle specifiche e alle spiegazioni delle API, anche se 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à possono essere sottoposte a più prove dell'origine, man mano che vengono integrati i feedback e vengono apportati aggiustamenti.

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

Prove di origini di terze parti

In genere, le prove delle origini sono disponibili solo come proprietarie: funzionano solo per una singola origine registrata. Le prove delle origini di terze parti consentono ai fornitori di contenuti incorporati di 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

Non tutte le prove dell'origine sono finalizzate al test di nuove API. Alcuni trial consentono di riattivare temporaneamente una funzionalità ritirata. Queste sono chiamate prove di ritiro e in alcuni contesti sono state definite prove di origine "inversa".

Ad esempio, da Chrome 85 AppCache non è più disponibile in Chrome per impostazione predefinita. I siti che hanno bisogno di più tempo per eseguire la migrazione da AppCache possono registrarsi per la prova relativa al ritiro per continuare a utilizzare AppCache fino a Chrome 93.

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. Puoi farlo tramite il sito di prova dell'origine. Questo feedback non è pubblico ed è disponibile soltanto per un gruppo limitato di persone del team di Chrome. Ogni prova fornisce anche un link per un feedback spontaneo da parte della community. In genere questo rimanda alla funzionalità su GitHub o su un altro canale pubblico.
  6. Alla scadenza del token, 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 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 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 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 in cui include uno script incorporato o l'src di un elemento <script> per JavaScript incluso da un file esterno.

Token ed estensioni

Per utilizzare una funzionalità di prova all'interno di uno 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 dei contenuti vengono gestiti in modo diverso. L'esposizione di una funzionalità a un solo mondo potrebbe essere confusa e non intuitiva. Anziché utilizzare trial_token del manifest, aggiungi il token alla pagina inserendo un'intestazione utilizzando declarativeNetRequest o programmaticamente direttamente nello script dei contenuti. Ricorda che i token sono associati a domini specifici, quindi ti consigliamo di registrarne uno per il dominio su cui viene eseguito 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 alla prova dell'origine

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

  1. Vai alla pagina Le mie registrazioni.

  2. Per ogni origine registrata per la prova estesa, fai clic sul pulsante RINNOVI.Screenshot della pagina Le mie registrazioni della prova di Chrome originale, che mostra i pulsanti RINNOVI

  3. Copia il nuovo token e rendilo disponibile per ogni pagina che deve rimanere registrata alla prova. Se necessario, puoi fornire più token: Chrome ignorerà i token non validi o scaduti.

Visualizzare le informazioni sulla prova dell'origine

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

Informazioni sulla prova dell&#39;origine per un sito visualizzato nella 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 delle prove dell'origine

Scopri di più