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, waarmee u functionaliteit kunt opbouwen die uw gebruikers een beperkte tijd kunnen uitproberen voordat de functie voor iedereen beschikbaar wordt gemaakt.

Wanneer Chrome een origin-proefversie voor een functie aanbiedt, kunt u zich voor de proefperiode registreren om de functie voor alle gebruikers op uw origin in te schakelen, zonder dat ze vlaggen hoeven aan te zetten of over te schakelen naar een alternatieve versie van Chrome (hoewel ze mogelijk moeten upgraden) . Origin-proefversies stellen ontwikkelaars in staat demo's en prototypes te bouwen met behulp van 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.

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 zal blijven tot API-specificaties en uitlegmiddelen, hoewel we waar mogelijk proberen 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

Oorsprongsproeven zijn meestal alleen beschikbaar op first-party basis: ze werken alleen voor één geregistreerde herkomst . Origin-tests van derden maken het voor aanbieders van embedded content mogelijk om een ​​nieuwe functie op meerdere sites uit te proberen zonder dat voor elke origin een token nodig is.

Meer informatie: Wat zijn herkomstproeven van derden?

Beëindigingsproeven

Niet alle origin-trials zijn bedoeld voor het testen van nieuwe API's. Bij sommige proefversies kan een verouderde functie tijdelijk opnieuw worden ingeschakeld. Deze staan ​​bekend als beëindigingsproeven en worden in sommige contexten ook wel "omgekeerde" oorsprongsproeven genoemd.

Vanaf Chrome 85 is AppCache bijvoorbeeld niet meer standaard beschikbaar in Chrome. Sites die extra tijd nodig hebben om AppCache te migreren, kunnen zich registreren voor de beëindigingsproef om AppCache te blijven gebruiken tot Chrome 93.

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 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 aan de pagina toe door een header in te voegen met declarativeNetRequest of programmatisch rechtstreeks in uw inhoudsscript. Houd er rekening mee dat tokens aan specifieke domeinen zijn gekoppeld. U moet er dus één registreren voor het domein waarop het inhoudsscript draait, in plaats van 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. Navigeer naar de pagina Mijn registraties .

  2. Voor elke origine die is geregistreerd voor de uitgebreide proefperiode, klikt u op de knop VERLENGEN . Schermafbeelding van de pagina Mijn registraties van de Chrome Origin-proefversie, met de VERNIEUW-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 op een pagina vanuit het paneel Applicaties in Chrome DevTools .

Informatie over de Origin-proefversie voor een site die wordt weergegeven in de framedetailsweergave van Chrome DevTools **Applicatie**-paneel.

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.

Origin-proefdemo's

Meer informatie