Iniziare a utilizzare le prove dell'origine

Testare una funzionalità nuova o sperimentale della piattaforma web.

Sam Dutton

Le prove dell'origine ti consentono di accedere a una funzionalità nuova o sperimentale per creare funzionalità che gli utenti possono provare per un periodo di tempo limitato prima che venga resa disponibile per tutti.

Quando Chrome offre una prova dell'origine per una funzionalità, puoi registrarti alla prova per abilitare la funzionalità per tutti gli utenti sulla tua origine, senza richiedere l'attivazione/la disattivazione di qualsiasi flag o il passaggio a una build alternativa di Chrome (anche se potrebbero dover eseguire l'upgrade). Le prove dell'origine consentono agli sviluppatori di creare demo e prototipi utilizzando nuove funzionalità. Le prove aiutano inoltre gli ingegneri di Chrome a capire come vengono utilizzate le nuove funzionalità e come potrebbero interagire con altre tecnologie web.

Le prove dell'origine sono pubbliche e aperte a tutti gli sviluppatori. Sono limitati in durata e utilizzo. La partecipazione è un processo autogestito con documentazione e assistenza limitate. I partecipanti devono essere disposti ed in grado di lavorare in modo relativamente indipendente utilizzando la documentazione disponibile, che, in questa fase, sarà probabilmente limitata alle specifiche e spiegazioni dell'API, anche se cerchiamo di fornire indicazioni, se possibile.

Se ti registri a una prova, il team di Chrome ti chiederà periodicamente un feedback specifico sull'utilizzo della funzionalità di prova. Alcune funzionalità possono essere sottoposte a più prove dell'origine, poiché vengono incorporati feedback e vengono apportati aggiustamenti.

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

Prove dell'origine di terze parti

In genere le prove dell'origine sono disponibili solo su base proprietaria: funzionano solo per una singola origine registrata. Le prove dell'origine 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 le prove dell'origine di terze parti?

Prove relative al ritiro

Non tutte le prove dell'origine consentono di testare nuove API. Alcune prove consentono di riattivare temporaneamente una funzionalità deprecata. Queste sono note come prove di deprecazione e, in alcuni contesti, sono state chiamate prove "inverse".

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

Partecipare a una prova dell'origine

  1. Scegli una prova dell'origine dall'elenco di prove attive.
  2. Richiedi un token facendo clic sul pulsante Registra e compilando il modulo.
  3. Fornisci il token su ogni pagina web per cui vuoi abilitare la funzionalità della prova:
  4. Prova la nuova funzionalità.
  5. Invia feedback. Esegui questa operazione tramite il sito della prova dell'origine. Questo feedback non è pubblico ed è disponibile solo per un gruppo limitato di persone nel team di Chrome. Ogni prova fornisce anche un link per ricevere feedback spontanei della community. In genere punta alla funzionalità su GitHub o su qualche altro canale pubblico.
  6. Alla scadenza del token, riceverai un'email con un link per il rinnovo. Per farlo, ti verrà nuovamente chiesto di inviare un feedback.

Puoi registrarti più volte per la stessa prova dell'origine, per origini diverse e includere più token nella stessa pagina. Questo 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 delle prove dell'origine cerca il primo token valido, quindi ignora tutti gli altri token. Puoi convalidare questa informazione con Chrome DevTools.

Fornisci un token in modo programmatico

Anziché fornire un token sotto forma di intestazione HTTP o 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 meta tag, in un'intestazione HTTP o in modo a livello di programmazione.

Per quanto riguarda l'utilizzo di tutti i 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 incorporato 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 uno script in background, un popup o un documento fuori schermo, aggiungi un trial_token al file manifest.json.

Gli script di contenuti vengono gestiti in modo diverso. Esporre un elemento a un mondo potrebbe essere complicato e non intuitivo. Anziché utilizzare trial_token del manifest, aggiungi il token alla pagina inserendo un'intestazione utilizzando declaritiveNetRequest o in modo programmatico direttamente nello script dei contenuti. Ricorda che i token sono associati a domini specifici, pertanto ti consigliamo di registrarne uno per il dominio su cui viene eseguito lo script dei contenuti, anziché l'ID estensione.

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

Rinnova la registrazione alla prova dell'origine

Se una prova dell'origine viene estesa, riceverai un avviso via email in cui ti verrà comunicato 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 RINNOVA. Screenshot della pagina Le mie registrazioni della prova dell&#39;origine di Chrome, che mostra 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 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 mostrate nella visualizzazione dei dettagli del frame del riquadro **Applicazione** di Chrome DevTools.

Puoi anche utilizzare il nostro decoder 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 delle prove dell&#39;origine decodificati.

Demo della prova dell'origine

Scopri di più