Ga aan de slag met herkomstproeven

Test een nieuwe of experimentele functie op een webplatform.

Sam Dutton

Met Origin-proefversies krijgt u toegang tot een nieuwe of experimentele functie, zodat u deze kunt testen en tijdelijk aan uw gebruikers kunt aanbieden. Zodra de proefversie is afgerond en de feedback is beoordeeld, beslist Chrome of de functie voor iedereen beschikbaar moet worden gesteld.

U kunt zich registreren voor een proefperiode om een ​​functie voor alle gebruikers op uw Origin-website in te schakelen, zonder dat ze vlaggen hoeven aan te passen of hoeven over te schakelen naar een alternatieve build van Chrome (hoewel ze mogelijk wel moeten upgraden). Na registratie kunnen ontwikkelaars demo's en prototypes bouwen met de nieuwe functies. De proefperiodes helpen Chrome-technici ook te begrijpen hoe nieuwe functies worden gebruikt en hoe ze kunnen samenwerken met andere webtechnologieën.

Beschikbaarheid

Origin-trials zijn openbaar en open voor alle ontwikkelaars. Ze zijn beperkt in duur en gebruik. Deelname is een zelfgestuurd proces met beperkte documentatie en ondersteuning. Deelnemers dienen bereid en in staat te zijn om relatief zelfstandig te werken met behulp van de beschikbare documentatie, die zich in dit stadium waarschijnlijk beperkt tot API-specificaties en -uitleg. We proberen waar mogelijk begeleiding te bieden .

Als u zich registreert voor een proefperiode, zal het Chrome-team u regelmatig om specifieke feedback vragen over uw gebruik van de proeffunctie. Sommige functies kunnen meerdere keren worden getest, waarbij feedback wordt verwerkt en aanpassingen worden doorgevoerd.

Origin-proefversies zijn ook beschikbaar voor Firefox en Microsoft Edge .

Oorsprongsproeven door derden

Standaard is een proefversie van een origin alleen beschikbaar op de origin die voor de proefversie is geregistreerd. Sommige proefversies bieden bij registratie de mogelijkheid om een ​​match met derden te maken . Hierdoor kunnen aanbieders van embedded content of services een nieuwe functie op meerdere sites uitproberen, zonder dat voor elke origin een token nodig is.

Meer informatie: Wat zijn onderzoeken door derden?

Afkeuringsproeven

Met sommige origin trials kunt u een verouderde functie tijdelijk opnieuw inschakelen. Dit worden 'deprecation trials' genoemd. In sommige contexten worden ze 'reverse' origin trials genoemd.

Mutatiegebeurtenissen zijn bijvoorbeeld verwijderd , te beginnen in Chrome 127. Sites die extra tijd nodig hadden voordat deze gebeurtenissen konden worden verwijderd, kunnen zich registreren voor de verouderingsproefperiode om de gebeurtenissen tijdelijk opnieuw in te schakelen op bepaalde sites.

Doe mee aan een oorsprongsproef

  1. Selecteer een oorsprongsproef uit de lijst met actieve proeven .
  2. Vraag een token aan door op de knop Registreren te klikken en het formulier in te vullen.
  3. Geef het token op elke webpagina waarvoor u de proefversie wilt inschakelen:
  4. Probeer de nieuwe functie uit.
  5. Geef feedback. Doe dit via de oorspronkelijke proefsite. Deze feedback is niet openbaar en alleen beschikbaar voor een beperkte groep mensen in het Chrome-team. Elke proefversie bevat ook een link voor spontane feedback van de community. Deze link verwijst meestal naar de functie op GitHub of een ander openbaar kanaal.
  6. Wanneer je token verloopt, ontvang je een e-mail met een verlengingslink. Hiervoor wordt je opnieuw gevraagd om feedback te geven.

Je kunt je meerdere keren registreren voor dezelfde proefperiode, voor verschillende oorsprongen, en meerdere tokens op dezelfde pagina opnemen. Dit kan handig zijn als je tokens moet aanbieden die geldig zijn voor resources die vanuit verschillende oorsprongen worden aangeboden, zoals code die is opgenomen op meerdere sites die jij beheert.

Het Origin Trials-framework zoekt naar het eerste geldige token en negeert vervolgens alle andere tokens. U kunt dit valideren met Chrome DevTools .

Een token programmatisch aanbieden

In plaats van een token als HTTP-header of als metatag in de HTML van uw pagina te verstrekken, zoals eerder beschreven, kunt u 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 onderzoek door een derde partij .

Tokens en iframes

Om toegang te krijgen tot een proeffunctie via een iframe, kunt u een proeftoken opgeven in een metatag, een HTTP-header of programmatisch .

Voor alle tokengebruik geldt dat de oorsprong die voor het token is geregistreerd, moet overeenkomen met de context van JavaScript die toegang heeft tot de proefversie. Dit kan de oorsprong zijn 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 u een proeffunctie in een achtergrondscript , pop-up , zijpaneel of offscreen-document wilt gebruiken, gebruikt u de sleutel trial_tokens in uw manifest.json-bestand .

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

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

Houd er rekening mee dat tokens aan specifieke domeinen zijn gekoppeld. U moet zich dus registreren voor het domein waarop het contentscript wordt uitgevoerd, in plaats van voor uw extensie-ID.

Om uw extensie te registreren voor een proefperiode, gebruikt u de URL chrome-extension://YOUR_EXTENSION_ID , bijvoorbeeld chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk .

Hernieuw de inschrijving voor het oorspronkelijke onderzoek

Als een proefperiode van oorsprong wordt verlengd, ontvangt u een e-mailwaarschuwing dat u uw registratie moet vernieuwen en voor elke oorsprong die aan de proefperiode deelneemt, een nieuw token moet opgeven.

  1. Ga naar Mijn registraties .
  2. Klik voor elke oorsprong die is geregistreerd voor de verlengde proef op VERNIEUWEN . Voorbeeld van de pagina Mijn registraties, met VERNIEUW-knoppen
  3. Kopieer de nieuwe token en maak deze beschikbaar voor elke pagina die in de proefperiode ingeschreven moet blijven. U kunt indien nodig meerdere tokens opgeven.

Chrome negeert ongeldige of verlopen tokens.

Bekijk informatie over het oorsprongsonderzoek

Bekijk informatie over de oorsprongsproeven die voor een site beschikbaar zijn via het paneel Toepassingen in Chrome DevTools .

Weergave van details in het paneelframe van Chrome DevTools-toepassing.

U kunt ook onze origin trial token decoder gebruiken om de in een token gecodeerde gegevens te bekijken.

Oorsprongproefdecodertool, toont gedecodeerde oorsprongproefwaarden.

Demo's

De volgende sites tonen voorbeelden van tokenimplementatie.

Hoe je een origin trial token aanbiedt

Origin-proefhulpmiddelen

Kenmerken in oorsprongsproef

Hieronder vindt u demo's voor API's die in lopende oorsprongsproeven zijn

Bronnen

Blijf onze Chrome-conceptdocumentatie lezen:

Ontdek meer over oorsprongsproeven in Chrome:

Andere browsers

Vind oorsprongsproeven in andere browsers: