Aan de slag met origin trials

Een nieuwe of experimentele webplatformfunctie testen.

Sam Dutton

Met origin trials krijg je toegang tot een nieuwe of experimentele functie, zodat je deze functie kunt testen en tijdelijk aan je gebruikers kunt aanbieden. Nadat de proefperiode is afgerond en de feedback is beoordeeld, beslist Chrome of de functie voor iedereen beschikbaar moet worden gemaakt.

Je kunt je registreren voor een origin-test om een functie aan te zetten voor alle gebruikers op je origin, zonder dat ze flags hoeven aan te zetten of over te schakelen naar een alternatieve build van Chrome (hoewel ze misschien wel moeten upgraden). Na registratie kunnen ontwikkelaars demo's en prototypes bouwen met de nieuwe functies. De tests helpen Chrome-engineers ook om inzicht te krijgen in hoe nieuwe functies worden gebruikt en hoe ze kunnen communiceren met andere webtechnologieën.

Beschikbaarheid

Origin trials zijn openbaar en beschikbaar voor alle ontwikkelaars. Ze zijn beperkt in duur en gebruik. Deelname is een zelfbeheerd proces met beperkte documentatie en support. Deelnemers moeten bereid en in staat zijn om relatief onafhankelijk te werken met de beschikbare documentatie, die in deze fase waarschijnlijk beperkt is tot API-specificaties en uitleg. We proberen waar mogelijk richtlijnen te geven.

Als je je registreert voor een proefperiode, vraagt het Chrome-team je periodiek om specifieke feedback over je gebruik van de proeffunctie. Sommige functies kunnen meerdere origin trials doorlopen, omdat feedback wordt verwerkt en aanpassingen worden doorgevoerd.

Origin trials zijn ook beschikbaar voor Firefox en Microsoft Edge.

Origin trials van derden

Standaard is een functie voor een origin trial alleen beschikbaar op de origin die is geregistreerd voor de trial. Sommige proeven bieden een optie voor overeenkomsten met derden bij de registratie. Zo kunnen aanbieders van ingesloten content of services een nieuwe functie op meerdere sites uitproberen zonder dat ze voor elke oorsprong een token nodig hebben.

Meer informatie: Wat zijn origin trials van derden?

Proefperioden na beëindiging

Met sommige origin trials kun je een beëindigde functie tijdelijk opnieuw aanzetten. Deze worden proefperioden na beëindiging genoemd. In sommige contexten worden ze 'omgekeerde' origin trials genoemd.

Mutatiegebeurtenissen zijn bijvoorbeeld verwijderd vanaf Chrome 127. Sites die extra tijd nodig hadden voordat ze deze gebeurtenissen verwijderden, kunnen zich registreren voor de proefperiode na beëindiging om de gebeurtenissen tijdelijk weer aan te zetten op bepaalde sites.

Deelnemen aan een origin trial

  1. Kies een origin trial uit de lijst met actieve origin trials.
  2. Vraag een token aan door op de knop Registreren te klikken en het formulier in te vullen.
  3. Voer de token in op elke webpagina waarvoor je de proeffunctie wilt aanzetten:
  4. Probeer de nieuwe functie uit.
  5. Feedback indienen. Doe dit via de site van de origin trial. Deze feedback is niet openbaar en is alleen beschikbaar voor een beperkte groep mensen in het Chrome-team. Elke proefperiode biedt ook een link voor spontane communityfeedback. Dit verwijst meestal naar de functie op GitHub of een ander openbaar kanaal.
  6. Als je token verloopt, krijg je een e-mail met een verlengingslink. Hiervoor wordt je opnieuw gevraagd feedback in te dienen.

Je kunt je meerdere keren registreren voor dezelfde origin trial, voor verschillende origins, en meerdere tokens op dezelfde pagina opnemen. Dit kan handig zijn als je tokens moet verstrekken die geldig zijn voor bronnen die afkomstig zijn van verschillende oorsprongen, zoals code die is opgenomen op meerdere sites waarvan je de eigenaar bent.

Het framework voor origin trials zoekt naar de eerste geldige token en negeert daarna alle andere tokens. U kunt dit valideren met Chrome DevTools.

Een token programmatic aanleveren

In plaats van een token te verstrekken als HTTP-header of als metatag in de HTML van je pagina, zoals eerder beschreven, kun je een token injecteren met JavaScript:

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

Gebruik deze methode als u deelneemt aan een proefperiode van derden.

Tokens en iframes

Als je toegang wilt tot een proeffunctie vanuit een iframe, kun je een proeftoken invoeren in een metatag, een HTTP-header of programmatisch.

Zoals voor alle tokengebruik geldt, moet de oorsprong die voor de token is geregistreerd, overeenkomen met de context van JavaScript die toegang heeft tot de proeffunctie: de oorsprong van de pagina die een inline script bevat of de src van een <script>-element voor JavaScript dat is opgenomen in een extern bestand.

Tokens en extensies

Als je een proeffunctie wilt gebruiken in een achtergrondscript, pop-up, zijvenster of offscreen document, gebruik je de trial_tokens-sleutel in je manifest.json-bestand.

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

Contentscripts worden anders verwerkt. Het kan verwarrend en onintuïtief zijn om een functie aan één wereld bloot te stellen. In plaats van de trial_token van het manifest te gebruiken, voeg je de token op een van de volgende manieren toe aan de pagina:

Onthoud dat tokens aan specifieke domeinen zijn gekoppeld. Je moet je dus registreren voor het domein waarop het contentscript wordt uitgevoerd, niet voor je extensie-ID.

Als je je extensie wilt registreren voor een proefperiode, gebruik je de URL chrome-extension://YOUR_EXTENSION_ID, bijvoorbeeld chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

Inschrijving voor origin trial verlengen

Als een origin trial wordt verlengd, krijg je een e-mailwaarschuwing dat je de registratie moet verlengen en een nieuw token moet verstrekken voor elke oorsprong die is ingeschreven voor de origin trial.

  1. Ga naar Mijn registraties.
  2. Klik voor elke oorsprong die is geregistreerd voor de verlengde proefperiode op RENEW (Verlengen). Voorbeeld van de pagina Mijn registraties met de knoppen VERLENGEN
  3. Kopieer de nieuwe token en maak deze beschikbaar voor elke pagina die ingeschreven moet blijven voor de proefperiode. Je kunt zo nodig meerdere tokens invoeren.

Chrome negeert ongeldige of verlopen tokens.

Informatie over de origin trial bekijken

Bekijk informatie over de origin trials die beschikbaar zijn voor een site in het deelvenster Applicatie in Chrome DevTools.

Weergave van framegegevens in het deelvenster Applicatie van Chrome DevTools.

Functies in origin trial

Hieronder staan demo's voor API's in lopende origin trials.

Bronnen

Lees onze documentatie over Chrome-concepten:

Meer informatie over origin trials in Chrome:

Andere browsers

Zo vind je origin trials in andere browsers:

Vorige
Chrome-varianten
Volgende
Oorsprongstests van derden