Ga aan de slag met herkomstproeven

Test een nieuwe of experimentele webplatformfunctie.

Sam Dutton

Origin-proefversies geven u toegang tot een nieuwe of experimentele functie, zodat u deze functie gedurende een beperkte tijd kunt testen en aan uw gebruikers kunt aanbieden. Zodra de proefperiode is voltooid en de feedback is beoordeeld, beslist Chrome of de functie voor iedereen beschikbaar moet worden gemaakt.

U kunt zich registreren voor een origin-proefperiode om een ​​functie in te schakelen voor alle gebruikers op uw origin , zonder dat ze vlaggen hoeven aan te zetten of naar een alternatieve versie van Chrome moeten overschakelen (hoewel ze mogelijk wel moeten upgraden). Eenmaal geregistreerd kunnen ontwikkelaars demo's en prototypes bouwen met behulp van de nieuwe functies. Dankzij de proefversies krijgen Chrome-technici ook inzicht in hoe nieuwe functies worden gebruikt en hoe deze kunnen communiceren met andere webtechnologieën.

Beschikbaarheid

Origin-proefversies zijn openbaar en open voor alle ontwikkelaars. Ze zijn beperkt in duur en gebruik. Deelname is een zelfbeheerd proces met beperkte documentatie en ondersteuning. Deelnemers moeten bereid en in staat zijn relatief zelfstandig te werken met behulp van de beschikbare documentatie, die in dit stadium waarschijnlijk beperkt blijft tot API-specificaties en uitlegmiddelen. Wij proberen waar mogelijk begeleiding te bieden .

Als u zich registreert voor een proefperiode, zal het Chrome-team u periodiek om specifieke feedback vragen over uw gebruik van de proeffunctie. Sommige functies kunnen meerdere oorsprongstests ondergaan, omdat feedback wordt verwerkt en aanpassingen worden aangebracht.

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

Oorsprongsproeven van derden

Standaard is een origin-proeffunctie alleen beschikbaar op de origin die voor de proefperiode is geregistreerd. Sommige proefversies bieden bij registratie een matchingoptie van derden . Hierdoor kunnen aanbieders van ingebedde inhoud of diensten een nieuwe functie op meerdere sites uitproberen, zonder dat voor elke herkomst een token nodig is.

Meer informatie: Wat zijn herkomstproeven van derden?

Beëindigingsproeven

Bij sommige Origin-proefversies kunt u een verouderde functie tijdelijk opnieuw inschakelen. Deze staan ​​bekend als beëindigingsproeven . In sommige contexten worden ze ‘omgekeerde’ oorsprongsproeven genoemd.

Mutatiegebeurtenissen zijn bijvoorbeeld verwijderd vanaf Chrome 127. Sites die extra tijd nodig hadden voordat ze deze gebeurtenissen verwijderden, kunnen zich registreren voor de beëindigingsproef om de gebeurtenissen tijdelijk opnieuw in te schakelen op bepaalde sites.

Doe mee aan een herkomstproces

  1. Kies een originele proefversie uit de lijst met actieve proefversies .
  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 proeffunctie wilt inschakelen:
  4. Probeer de nieuwe functie.
  5. Geef feedback. Doe dit via de origin-proefsite. Deze feedback is niet openbaar en is alleen beschikbaar voor een beperkte groep mensen in het Chrome-team. Elke proef biedt ook een link voor spontane feedback van de gemeenschap. Dit verwijst doorgaans naar de functie op GitHub of een ander openbaar kanaal.
  6. Wanneer uw token verloopt, ontvangt u een e-mail met een verlengingslink. Hiervoor wordt u opnieuw gevraagd feedback te geven.

U kunt zich meerdere keren registreren voor dezelfde origin-proefperiode, voor verschillende origines, en meerdere tokens op dezelfde pagina opnemen. Dit kan handig zijn als u tokens moet opgeven die geldig zijn voor bronnen die vanuit verschillende bronnen worden aangeboden, zoals code die is opgenomen op meerdere sites waarvan u de eigenaar bent.

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

Geef programmatisch een token op

In plaats van een token op te geven als HTTP-header of als metatag in de HTML van uw pagina, 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 proefversie van derden .

Tokens en iframes

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

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

Tokens en extensies

Als u een proeffunctie wilt gebruiken in een achtergrondscript , pop-up , zijpaneel of offscreen-document , gebruikt u de trial_tokens sleutel in uw manifest.json-bestand .

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

Inhoudsscripts worden op een andere manier afgehandeld. Het blootstellen van een functie aan één wereld kan verwarrend en niet intuïtief zijn. In plaats van de trial_token van het manifest te gebruiken, voegt u het token op een van de volgende manieren aan de pagina toe:

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

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

Verleng de inschrijving voor de Origin-proefperiode

Als een origin-proefperiode wordt verlengd, ontvangt u een e-mailwaarschuwing dat u de registratie moet vernieuwen en een nieuw token moet opgeven voor elke origin die is ingeschreven voor de proefperiode.

  1. Ga naar Mijn inschrijvingen .
  2. Klik voor elke origine die is geregistreerd voor de uitgebreide proefperiode op VERNIEUWEN . Voorbeeld Mijn Registratiepagina, met RENEW-knoppen
  3. Kopieer het nieuwe token en maak het beschikbaar voor elke pagina die ingeschreven moet blijven in de proefperiode. Indien nodig kunt u meerdere tokens opgeven.

Chrome negeert ongeldige of verlopen tokens.

Bekijk de herkomstproefinformatie

Bekijk informatie over de originele proefversies die beschikbaar zijn voor een site via het paneel Applicaties in Chrome DevTools .

Chrome DevTools Applicatiepaneelframedetails bekijken.

U kunt ook onze origin proeftokendecoder gebruiken om de gegevens te bekijken die in een token zijn gecodeerd.

Origin-proefdecodeertool, die gedecodeerde oorsprong-proefwaarden toont.

Demo's

Op de volgende sites worden voorbeelden van tokenimplementatie weergegeven.

Een origin-proeftoken opgeven

Origin-proeftools

Functies in origin-proefversie

Hieronder volgen demo's voor API's in lopende oorsprongsproeven

Bronnen

Blijf onze Chrome-conceptdocumentatie lezen:

Ontdek meer over origin-proefversies in Chrome:

Andere browsers

Vind origin-proefversies in andere browsers: