Los veelvoorkomende problemen op met proeftokens in metatags, headers en scripts.
In deze handleiding wordt ervan uitgegaan dat u praktische kennis heeft van origin-trials in Chrome . Voor gedetailleerde veelgestelde vragen raadpleegt u de Origin-proefgids voor webontwikkelaars .
Als u een bug tegenkomt met origin-proefversies in Chrome, dien dan een nieuw probleem in via de GitHub-opslagplaats voor origin-proefversies van Chrome.
Controlelijst
Om problemen met een origin-proefversie op te lossen, doorloopt u elk van de problemen met behulp van de meegeleverde links.
Gebruik Chrome DevTools om tokens te controleren
DevTools biedt informatie over de oorsprong van de proefversie in het paneel Toepassingen voor het geselecteerde frame.
Vouw het bovenste frame uit om de herkomstproeftokens te inspecteren die beschikbaar zijn voor een subframe. Voor de demopagina op ot-iframe.glitch.me kunt u bijvoorbeeld zien dat de pagina in het iframe een token levert.
- Tokenstatus : of de pagina een geldig token heeft. Houd er rekening mee dat er voor sommige origin-trials andere factoren kunnen zijn, zoals geografische beperkingen, die betekenen dat de origin-trial-functie niet beschikbaar is, ondanks de aanwezigheid van een geldig token. Chrome DevTools-statuscodes leggen de betekenis uit van elk van de codes voor origin-proefversies.
- Oorsprong : de weboorsprong die voor het token is geregistreerd.
- Vervaltijd : de maximaal (laatst) mogelijke vervaldatum en -tijd voor het token, die (grotendeels) overeenkomt met het einde van de proefperiode. Dit is niet hetzelfde als de Geldig Tot-datum voor het token dat wordt weergegeven in Mijn Registraties , waarin wordt weergegeven hoe lang het token geldig is en kan worden verlengd .
- Gebruiksbeperking : Gebruikslimieten, die voor sommige proefversies kunnen worden ingesteld .
- Derde partij : of matching van derden is ingeschakeld voor het token. Dit is beschikbaar voor bepaalde originele proefversies, waarbij een proeffunctie op meerdere sites toegankelijk moet zijn via scripts van derden.
- Match subdomeinen : of subdomeinmatching is ingeschakeld voor het token. Hierdoor kan een origin-proeffunctie worden getest op meerdere subdomeinen van een origin, zonder dat voor elk subdomein een ander token nodig is.
Chrome DevTools geeft een waarschuwing weer naast de naam van de proefperiode als de proefperiode: niet beschikbaar is voor de huidige gebruiker, het token is verlopen of als er andere beperkingen zijn.
Statuscodes
U kunt de volgende statuscodes tegenkomen in Chrome DevTools.
Verlopen : Token heeft de vervaldatum overschreden. Om de origin-proefperiode opnieuw in te schakelen, moet het token worden vernieuwd. Genereer een nieuw token met een nieuwe vervaldatum. Broncode
FeatureDisabled : Proefversie is uitgeschakeld voor gebruik. Broncode
FeatureDisabledForUser : dit token is aangewezen als uitgeschakeld voor de huidige gebruiker met een alternatieve gebruiksbeperking. Zie de sectie 'Uitsluitingen van gebruikerssubsets' in het ontwerpdocument . Broncode 1 en Broncode 2
Onveilig : de oorsprong van het verzoek is onveilig en de proefversie is niet ingeschakeld voor onveilige oorsprong. Zoals uitgelegd in de origin trial token validator code : 'Voor tokens van derden moeten zowel de huidige oorsprong als de scriptoorsprong veilig zijn. Als gevolg van subdomeinovereenkomsten komt de tokenoorsprong mogelijk niet exact overeen met een van de opgegeven scriptoorsprongen en geeft het resultaat niet aan welke specifieke oorsprong overeenkomt. Dit betekent dat het geen directe zoekopdracht is om de juiste scriptoorsprong te vinden. Om te voorkomen dat alle oorsprongsvergelijkingen opnieuw moeten worden uitgevoerd, zijn er snelkoppelingen die afhankelijk zijn van het aantal opgegeven scriptoorsprongen. Er moet er minstens één zijn, anders wordt het token van de derde partij niet succesvol gevalideerd.' Broncode
InvalidSignature : het token heeft een ongeldige of onjuist opgemaakte handtekening. Broncode
Misvormd : het token is verkeerd ingedeeld en kan niet worden geparseerd. Broncode
NotSupported : De oorspronkelijke proefversie die door het token wordt gedefinieerd, wordt niet ondersteund in de Chromium-insluiting. Een embedder kan een browser zijn (zoals Chrome of Edge), een WebView of een andere user-agent. Broncode
Succes : het token is goed gevormd, is niet verlopen, komt overeen met een origin-proeffunctie en wordt aangevraagd vanaf een verwachte oorsprong. Broncode
TokenDisabled : Token is gemarkeerd als uitgeschakeld en kan niet worden gebruikt. Broncode
TrialNotAllowed : De originele proefversie is niet beschikbaar voor de huidige gebruiker . Broncode
UnknownTrial : het token specificeert een functienaam die niet overeenkomt met een bekende proefversie. Broncode
WrongOrigin : de oorsprong van de aanvraag komt niet overeen met de oorsprong die is opgegeven in het token. Dit kan het schema, de hostnaam of de poort omvatten. Deze status wordt ook weergegeven als een token van derden wordt verstrekt in een HTTP-header, metatag of inline-script, in plaats van vanuit een extern JavaScript-bestand. Broncode
WrongVersion : u gebruikt de verkeerde tokenversie. Alleen tokenversie 2 en 3 worden ondersteund. Broncode
Vereiste voorwaarden voor herkomstproeven
Als uw Origin-proefperiode niet werkt zoals verwacht, controleer dan of u aan de volgende voorwaarden voldoet.
Je test in Chrome, niet in Chromium of een andere browser
Testversies van Chrome Origin zijn bedoeld voor Chrome-gebruikers. Met proefversietokens van Chrome-oorsprong zijn geen functies in andere browsers mogelijk, waaronder Chromium en Chromium-gebaseerde browsers. Dit komt omdat proefversies van Chrome-oorsprong specifiek zijn voor functies die in Chrome beschikbaar zijn gesteld voor experimenten.
Origin-proefversies zijn ook beschikbaar voor Firefox en Microsoft Edge . Bij inschrijving voor een originele proefversie van Firefox of Edge wordt een functie in Chrome niet ingeschakeld.
De Origin-proefperiode is ingeschakeld voor de Chrome-versies die toegang krijgen tot uw site
Toegang tot origin-proefversies is beperkt tot specifieke versies van Chrome. Dit kan betekenen dat een proeffunctie alleen beschikbaar is voor pre-stabiele Chrome-kanalen: Canary, Dev en Beta.
U kunt de beschikbaarheid van versies controleren op de registratiepagina voor de proefversie:
U kunt de Chrome-versie die u gebruikt controleren via chrome://version .
De Origin-proefperiode wordt niet uitgeschakeld door de Chrome-instellingen
Als een individuele gebruiker meldt dat een functie niet werkt, controleer dan of de functie niet is uitgeschakeld in de Chrome-instellingen. Bepaalde Privacy Sandbox -functies kunnen bijvoorbeeld worden uitgeschakeld via de chrome://settings/adPrivacy -pagina.
Trefwoorden en syntaxis zijn correct
Zorg ervoor dat u de juiste trefwoorden en syntaxis gebruikt voor origin-proeftokens.
Voor gebruik door de eerste partij kan een token worden verstrekt in een origin-trial metatag:
<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">
Als alternatief kan een token worden verstrekt in een Origin-Trial -antwoordheader. Hier is een voorbeeld van het gebruik van Express in Node.js:
app.use(function(req, res, next) {
res.setHeader('Origin-Trial', 'Aj4DysCv3VjknU3...')
next();
});
Tokens kunnen ook worden voorzien van JavaScript :
function addTrialToken(tokenContents) {
const tokenElement = document.createElement('meta');
tokenElement.httpEquiv = 'origin-trial';
tokenElement.content = tokenContents;
document.head.appendChild(tokenElement);
}
De oorsprong van de token van de eerste partij komt overeen met de oorsprong van de pagina
Zorg ervoor dat de Web Origin- waarde die u selecteert wanneer u zich registreert voor een proefperiode, overeenkomt met de oorsprong van de pagina met de metatag of header die het token levert.
Als u bijvoorbeeld https://example.com als weboorsprong hebt geselecteerd:
Mogelijk krijgt u een tokenwaarde als deze:
Controleer of deze waarde overeenkomt met het token dat wordt gebruikt op de pagina waarvoor u problemen oplost.
Controleer de HTML voor een token in een metatag:
<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">
Voor een token in een header kunt u de tokenwaarde controleren in het Chrome DevTools Network-paneel onder Response Headers :
Het token van de eerste partij wordt aangeboden vanaf de oorsprong die het gebruikt
Als u toegang wilt krijgen tot een origin-proeffunctie voor code die is opgenomen in een pagina die vanuit uw oorsprong wordt weergegeven, geeft u een proeftoken op in een metatag, header of met JavaScript van dezelfde oorsprong.
De voor een token geregistreerde oorsprong moet overeenkomen met de oorsprong die deze token bedient.
De tokenoorsprong van derden komt overeen met de scriptoorsprong
U kunt zich registreren om deel te nemen aan een origin-proef voor scripts die op andere origins zijn geïnjecteerd.
Als u bijvoorbeeld wilt dat scripts die worden geleverd vanuit javascript-library.example deelnemen aan een origin-proefversie, moet u een token registreren met overeenkomsten van derden voor javascript-library.example .
De oorsprongswaarde voor een token van derden moet overeenkomen met de oorsprong van het script dat het token injecteert.
Script van derden maakt gebruik van een token van derden
U kunt een script van derden niet inschakelen om deel te nemen aan een origin-proef op uw site door alleen een token voor uw origin te registreren en het script te vergeten.
Scripts van derden moeten tokens gebruiken waarvoor matching van derden is ingeschakeld, geïnjecteerd met het script zelf. Deze tokens kunnen niet worden opgenomen in een metatag of header op uw site. Het JavaScript kan er als volgt uitzien:
// Add a third-party OT token
function addTrialToken(tokenContents) {
const tokenElement = document.createElement('meta');
tokenElement.httpEquiv = 'origin-trial';
tokenElement.content = tokenContents;
document.head.appendChild(tokenElement);
}
Token van derden wordt geleverd met een extern script, geen metatag, HTTP-header of inline script
Tokens van derden worden gevalideerd aan de hand van de oorsprong van het script dat ze heeft geïnjecteerd. Inline-scripts en <meta> -tags in statische opmaak hebben echter geen oorsprong.
Dit betekent dat een token van derden moet worden voorzien van een extern script, en niet in een <meta> -tag of inline script. Het maakt niet uit of het externe script dat het token injecteert afkomstig is van dezelfde oorsprong als de bevattende pagina of van een andere oorsprong, zolang de oorsprong van het script overeenkomt met een oorsprong die is geregistreerd voor de proefversie.
Bekijk een demo hiervan op ot-iframe-3p.glitch.me .
Toegang tot de Origin-proeffunctie wordt ondersteund voor de methode die wordt gebruikt om een proeftoken te leveren
Voor sommige soorten toegang tot de oorspronkelijke proefversiefuncties moet u op een specifieke manier een proeftoken opgeven. De enige manier om origin-proeftoegang voor servicemedewerkers en gedeelde medewerkers in te schakelen is bijvoorbeeld door een token op te geven in een Origin-Trial header.
Subdomeinmatching is ingeschakeld voor een token dat op een subdomein wordt gebruikt
Als een origin-proeffunctie voor sommige pagina's op uw site niet lijkt te werken, controleer dan of de tokens correct zijn ingesteld voor de subdomeinen die ze bedienen.
Wanneer u zich registreert voor een origin-proefperiode, kunt u er optioneel voor kiezen om alle subdomeinen van de origin te matchen:
U kunt ook subdomeinen matchen voor tokens van derden:
Subdomeintokens worden niet uitgegeven voor oorsprongen in de openbare achtervoegsellijst . U kunt bijvoorbeeld geen origin zoals https://appspot.com of https://github.io registreren, maar u kunt zich wel registreren voor domeinen binnen die origin, zoals https://example.appspot.com of https://example.github.io .
Het token is nog steeds geldig
Tokens zijn zes weken geldig nadat ze zijn gemaakt. Daarnaast moet u feedback indienen om de Geldig tot- datum te verlengen. Origin Trials Guide for Web Developers legt uit hoe u ervoor kunt zorgen dat uw token geldig is voor een volledige origin-proefperiode.
U kunt controleren of er actieve tokens zijn op de pagina Mijn registraties van Chrome Origin Trials:
Chrome DevTools geeft Status Success weer als het token nog steeds geldig is:
Als uw token is verlopen, geeft DevTools de status Expired en geeft uw pagina Mijn registraties een sectie Verlopen tokens weer.
Het oorsprongsproces is aan de gang
U kunt de einddatum voor een origin-proefperiode controleren op de registratiepagina :
Voor proefversies die zijn beëindigd, geeft DevTools iets als dit weer:
U ontvangt geautomatiseerde e-mails wanneer feedback vereist is of een token op het punt staat te verlopen, maar niet wanneer de proefperiode eindigt.
De origin-proefversie is beschikbaar voor de huidige gebruiker
Sommige origin-proefversies zijn niet beschikbaar voor bepaalde gebruikers, zelfs als er een geldig token wordt verstrekt.
Als er geen proefversie beschikbaar is voor de huidige gebruiker, geeft Chrome DevTools een TrialNotAllowed waarschuwing weer:
Voor elke origin-proefversie wordt informatie verstrekt over gebruiksbeperkingen en beschikbaarheid.
Zoals bij elke webplatformfunctie moet u functiedetectie gebruiken om te bevestigen dat een origin-proeffunctie wordt ondersteund voordat u deze gebruikt.
De gebruiksbeperkingen voor de Origin-proefperiode zijn niet overschreden
Standaard is een origin-proefversie ingeschakeld op elke pagina die een geldig token voor de proefversie heeft.
Behalve in zeldzame gevallen is het gebruik van de Origin-proefperiode beperkt tot maximaal 0,5% van alle geladen Chrome-pagina's . De origin-proeffunctie wordt uitgeschakeld als het totale gebruik door alle Chrome-gebruikers dat bedrag overschrijdt. DevTools geeft de tokenstatus weer als uitgeschakeld.
Er zijn geen gebruikslimieten voor beëindigingsproeven, omdat deze geen nieuwe functies introduceren en daarom geen risico inhouden dat een aanzienlijk deel van het internet afhankelijk wordt van een proeffunctie.
Sommige proefversies bieden een optie om het gebruik te beperken, wat betekent dat de functies van de originele proefversie voor sommige gebruikers zijn uitgeschakeld. Deze optie wordt beschikbaar gesteld op de registratiepagina voor een origin-proefversie die deze optie biedt:
Als u merkt dat de toegang van uw gebruikers tot een origin-proeffunctie lager is dan verwacht, zorg er dan voor dat Standaardlimiet is geselecteerd.
Iframes bieden hun eigen tokens
Om toegang tot een origin-proeffunctie mogelijk te maken, moet een iframe een token in een metatag, een HTTP-header of programmatisch bevatten. Iframes nemen geen toegang over tot functies die zijn ingeschakeld voor pagina's die deze bevatten.
ot-iframe.glitch.me demonstreert toegang tot een origin-proeffunctie vanuit een iframe. ot-iframe-3p.glitch.me biedt meerdere cross-origin iframe-voorbeelden.
Het machtigingsbeleid is correct geconfigureerd
Sommige functies van de oorspronkelijke proefversie kunnen worden beïnvloed door een Permissions-Policy . U kunt dit controleren in de Intent to Experiment voor de proeffunctie, of in de ontwikkelaarsdocumentatie voor de functie op developer.chrome.com/docs .
Zorg ervoor dat de functie die u probeert te openen niet wordt geblokkeerd door een Permissions-Policy richtlijn. U kunt controleren op antwoordheaders in het Chrome DevTools Network- paneel en de volledige lijst met toegestane functies bekijken in het Applicatie- paneel.
Hoe zit het met de arbeiders?
Functies voor Origin-proefversies kunnen beschikbaar worden gemaakt voor servicemedewerkers, gedeelde medewerkers en toegewijde medewerkers. Om toegang voor servicemedewerkers en gedeelde medewerkers mogelijk te maken, moet u een token opgeven in een Origin-Trial header.
Toegewijde werknemers nemen de toegang over tot functies die door hun bovenliggende document worden ingeschakeld.
Token wordt verstrekt voordat toegang wordt verkregen tot de functie
Zorg ervoor dat er een origin-proeftoken wordt verstrekt voordat u toegang krijgt tot een proeffunctie. Als een pagina bijvoorbeeld een token met JavaScript levert, zorg er dan voor dat de code die het token levert, wordt uitgevoerd vóór de code die probeert toegang te krijgen tot de proeffunctie.
Origin-proefdemo's
Op de volgende sites worden voorbeelden van tokenimplementatie weergegeven.
Een origin-proeftoken opgeven
- Token in een metatag
- Token in een header
- Token geïnjecteerd door een script van derden
- Functie toegankelijk in een iframe
- Cross-origin iframe-voorbeelden
Origin-proeftools
Functies in origin-proefversie
Hieronder volgen demo's voor API's in lopende oorsprongsproeven
Meer informatie
- Ga aan de slag met proefversies van Chrome Origin
- Oorsprongsproeven van derden
- Origin-proefgids voor webontwikkelaars
- Oorsprong proef uitleg
- Een origin-proef uitvoeren
- Proces voor het lanceren van nieuwe functies in Chromium
- Intentie om uit te leggen: het demystificeren van het Blink-verzendproces
- Gebruik Origin-proefversies in Microsoft Edge
- Origin-proefversies voor Firefox
Los veelvoorkomende problemen op met proeftokens in metatags, headers en scripts.
In deze handleiding wordt ervan uitgegaan dat u praktische kennis heeft van origin-trials in Chrome . Voor gedetailleerde veelgestelde vragen raadpleegt u de Origin-proefgids voor webontwikkelaars .
Als u een bug tegenkomt met origin-proefversies in Chrome, dien dan een nieuw probleem in via de GitHub-opslagplaats voor origin-proefversies van Chrome.
Controlelijst
Om problemen met een origin-proefversie op te lossen, doorloopt u elk van de problemen met behulp van de meegeleverde links.
Gebruik Chrome DevTools om tokens te controleren
DevTools biedt informatie over de oorsprong van de proefversie in het paneel Toepassingen voor het geselecteerde frame.
Vouw het bovenste frame uit om de herkomstproeftokens te inspecteren die beschikbaar zijn voor een subframe. Voor de demopagina op ot-iframe.glitch.me kunt u bijvoorbeeld zien dat de pagina in het iframe een token levert.
- Tokenstatus : of de pagina een geldig token heeft. Houd er rekening mee dat er voor sommige origin-trials andere factoren kunnen zijn, zoals geografische beperkingen, die betekenen dat de origin-trial-functie niet beschikbaar is, ondanks de aanwezigheid van een geldig token. Chrome DevTools-statuscodes leggen de betekenis uit van elk van de codes voor origin-proefversies.
- Oorsprong : de weboorsprong die voor het token is geregistreerd.
- Vervaltijd : de maximaal (laatst) mogelijke vervaldatum en -tijd voor het token, die (grotendeels) overeenkomt met het einde van de proefperiode. Dit is niet hetzelfde als de Geldig Tot-datum voor het token dat wordt weergegeven in Mijn Registraties , waarin wordt weergegeven hoe lang het token geldig is en kan worden verlengd .
- Gebruiksbeperking : Gebruikslimieten, die voor sommige proefversies kunnen worden ingesteld .
- Derde partij : of matching van derden is ingeschakeld voor het token. Dit is beschikbaar voor bepaalde originele proefversies, waarbij een proeffunctie op meerdere sites toegankelijk moet zijn via scripts van derden.
- Match subdomeinen : of subdomeinmatching is ingeschakeld voor het token. Hierdoor kan een origin-proeffunctie worden getest op meerdere subdomeinen van een origin, zonder dat voor elk subdomein een ander token nodig is.
Chrome DevTools geeft een waarschuwing weer naast de naam van de proefperiode als de proefperiode: niet beschikbaar is voor de huidige gebruiker, het token is verlopen of als er andere beperkingen zijn.
Statuscodes
U kunt de volgende statuscodes tegenkomen in Chrome DevTools.
Verlopen : Token heeft de vervaldatum overschreden. Om de origin-proefperiode opnieuw in te schakelen, moet het token worden vernieuwd. Genereer een nieuw token met een nieuwe vervaldatum. Broncode
FeatureDisabled : Proefversie is uitgeschakeld voor gebruik. Broncode
FeatureDisabledForUser : dit token is aangewezen als uitgeschakeld voor de huidige gebruiker met een alternatieve gebruiksbeperking. Zie de sectie 'Uitsluitingen van gebruikerssubsets' in het ontwerpdocument . Broncode 1 en Broncode 2
Onveilig : de oorsprong van het verzoek is onveilig en de proefversie is niet ingeschakeld voor onveilige oorsprong. Zoals uitgelegd in de origin trial token validator code : 'Voor tokens van derden moeten zowel de huidige oorsprong als de scriptoorsprong veilig zijn. Als gevolg van subdomeinovereenkomsten komt de tokenoorsprong mogelijk niet exact overeen met een van de opgegeven scriptoorsprongen en geeft het resultaat niet aan welke specifieke oorsprong overeenkomt. Dit betekent dat het geen directe zoekopdracht is om de juiste scriptoorsprong te vinden. Om te voorkomen dat alle oorsprongsvergelijkingen opnieuw moeten worden uitgevoerd, zijn er snelkoppelingen die afhankelijk zijn van het aantal opgegeven scriptoorsprongen. Er moet er minstens één zijn, anders wordt het token van de derde partij niet succesvol gevalideerd.' Broncode
InvalidSignature : het token heeft een ongeldige of onjuist opgemaakte handtekening. Broncode
Misvormd : het token is verkeerd ingedeeld en kan niet worden geparseerd. Broncode
NotSupported : De oorspronkelijke proefversie die door het token wordt gedefinieerd, wordt niet ondersteund in de Chromium-insluiting. Een embedder kan een browser zijn (zoals Chrome of Edge), een WebView of een andere user-agent. Broncode
Succes : het token is goed gevormd, is niet verlopen, komt overeen met een origin-proeffunctie en wordt aangevraagd vanaf een verwachte oorsprong. Broncode
TokenDisabled : Token is gemarkeerd als uitgeschakeld en kan niet worden gebruikt. Broncode
TrialNotAllowed : De originele proefversie is niet beschikbaar voor de huidige gebruiker . Broncode
UnknownTrial : het token specificeert een functienaam die niet overeenkomt met een bekende proefversie. Broncode
WrongOrigin : de oorsprong van de aanvraag komt niet overeen met de oorsprong die is opgegeven in het token. Dit kan het schema, de hostnaam of de poort omvatten. Deze status wordt ook weergegeven als een token van derden wordt verstrekt in een HTTP-header, metatag of inline-script, in plaats van vanuit een extern JavaScript-bestand. Broncode
WrongVersion : u gebruikt de verkeerde tokenversie. Alleen tokenversie 2 en 3 worden ondersteund. Broncode
Vereiste voorwaarden voor herkomstproeven
Als uw Origin-proefperiode niet werkt zoals verwacht, controleer dan of u aan de volgende voorwaarden voldoet.
Je test in Chrome, niet in Chromium of een andere browser
Testversies van Chrome Origin zijn bedoeld voor Chrome-gebruikers. Met proefversietokens van Chrome-oorsprong zijn geen functies in andere browsers mogelijk, waaronder Chromium en Chromium-gebaseerde browsers. Dit komt omdat proefversies van Chrome-oorsprong specifiek zijn voor functies die in Chrome beschikbaar zijn gesteld voor experimenten.
Origin-proefversies zijn ook beschikbaar voor Firefox en Microsoft Edge . Bij inschrijving voor een originele proefversie van Firefox of Edge wordt een functie in Chrome niet ingeschakeld.
De Origin-proefperiode is ingeschakeld voor de Chrome-versies die toegang krijgen tot uw site
Toegang tot origin-proefversies is beperkt tot specifieke versies van Chrome. Dit kan betekenen dat een proeffunctie alleen beschikbaar is voor pre-stabiele Chrome-kanalen: Canary, Dev en Beta.
U kunt de beschikbaarheid van versies controleren op de registratiepagina voor de proefversie:
U kunt de Chrome-versie die u gebruikt controleren via chrome://version .
De Origin-proefperiode wordt niet uitgeschakeld door de Chrome-instellingen
Als een individuele gebruiker meldt dat een functie niet werkt, controleer dan of de functie niet is uitgeschakeld in de Chrome-instellingen. Bepaalde Privacy Sandbox -functies kunnen bijvoorbeeld worden uitgeschakeld via de chrome://settings/adPrivacy -pagina.
Trefwoorden en syntaxis zijn correct
Zorg ervoor dat u de juiste trefwoorden en syntaxis gebruikt voor origin-proeftokens.
Voor gebruik door de eerste partij kan een token worden verstrekt in een origin-trial metatag:
<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">
Als alternatief kan een token worden verstrekt in een Origin-Trial -antwoordheader. Hier is een voorbeeld van het gebruik van Express in Node.js:
app.use(function(req, res, next) {
res.setHeader('Origin-Trial', 'Aj4DysCv3VjknU3...')
next();
});
Tokens kunnen ook worden voorzien van JavaScript :
function addTrialToken(tokenContents) {
const tokenElement = document.createElement('meta');
tokenElement.httpEquiv = 'origin-trial';
tokenElement.content = tokenContents;
document.head.appendChild(tokenElement);
}
De oorsprong van de token van de eerste partij komt overeen met de oorsprong van de pagina
Zorg ervoor dat de Web Origin- waarde die u selecteert wanneer u zich registreert voor een proefperiode, overeenkomt met de oorsprong van de pagina met de metatag of header die het token levert.
Als u bijvoorbeeld https://example.com als weboorsprong hebt geselecteerd:
Mogelijk krijgt u een tokenwaarde als deze:
Controleer of deze waarde overeenkomt met het token dat wordt gebruikt op de pagina waarvoor u problemen oplost.
Controleer de HTML voor een token in een metatag:
<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">
Voor een token in een header kunt u de tokenwaarde controleren in het Chrome DevTools Network-paneel onder Response Headers :
Het token van de eerste partij wordt aangeboden vanaf de oorsprong die het gebruikt
Om toegang te krijgen tot een origin-proeffunctie voor code die is opgenomen in een pagina die vanuit uw origin wordt weergegeven, geeft u een proeftoken op in een metatag, header of met JavaScript van dezelfde origin.
De voor een token geregistreerde oorsprong moet overeenkomen met de oorsprong die deze token bedient.
De tokenoorsprong van derden komt overeen met de scriptoorsprong
U kunt zich registreren om deel te nemen aan een origin-proef voor scripts die op andere origins zijn geïnjecteerd.
Als u bijvoorbeeld wilt dat scripts die worden geleverd vanuit javascript-library.example deelnemen aan een origin-proefversie, moet u een token registreren met overeenkomsten van derden voor javascript-library.example .
De oorsprongswaarde voor een token van derden moet overeenkomen met de oorsprong van het script dat het token injecteert.
Script van derden maakt gebruik van een token van derden
U kunt een script van derden niet inschakelen om deel te nemen aan een origin-proef op uw site door alleen een token voor uw origin te registreren en het script te vergeten.
Scripts van derden moeten tokens gebruiken waarvoor matching van derden is ingeschakeld, geïnjecteerd met het script zelf. Deze tokens kunnen niet worden opgenomen in een metatag of header op uw site. Het JavaScript kan er als volgt uitzien:
// Add a third-party OT token
function addTrialToken(tokenContents) {
const tokenElement = document.createElement('meta');
tokenElement.httpEquiv = 'origin-trial';
tokenElement.content = tokenContents;
document.head.appendChild(tokenElement);
}
Token van derden wordt geleverd met een extern script, geen metatag, HTTP-header of inline script
Tokens van derden worden gevalideerd aan de hand van de oorsprong van het script dat ze heeft geïnjecteerd. Inline-scripts en <meta> -tags in statische opmaak hebben echter geen oorsprong.
Dit betekent dat een token van derden moet worden voorzien van een extern script, en niet in een <meta> -tag of inline script. Het maakt niet uit of het externe script dat het token injecteert afkomstig is van dezelfde oorsprong als de bevattende pagina of van een andere oorsprong, zolang de oorsprong van het script overeenkomt met een oorsprong die is geregistreerd voor de proefversie.
Bekijk een demo hiervan op ot-iframe-3p.glitch.me .
Toegang van de oorsprongstudies wordt ondersteund voor de methode die wordt gebruikt om een proeftoken te bieden
Sommige soorten toegang tot originele proeffuncties vereisen dat u op een specifieke manier een proeftoken opgeeft. De enige manier om de toegang tot originele proefmedewerkers en gedeelde werknemers bijvoorbeeld in te schakelen, is door een token te bieden in een Origin-Trial .
Subdomein matching is ingeschakeld voor een token dat op een subdomein wordt gebruikt
Als een functie Origin Trial niet lijkt te werken voor sommige pagina's op uw site, controleer dan dat tokens correct zijn ingesteld voor de subdomeinen die ze bedienen.
Wanneer u zich registreert voor een oorsprongstroef, kunt u optioneel kiezen om alle subdomeinen van de oorsprong te matchen:
U kunt ook subdomeinen matchen voor tokens van derden:
Subdomein -tokens worden niet uitgegeven voor oorsprong in de lijst van openbare achtervoegsel . U kunt bijvoorbeeld geen oorsprong registreren zoals https://appspot.com of https://github.io , hoewel u zich kunt registreren voor domeinen binnen die oorsprong, zoals https://example.appspot.com of https://example.github.io .
Het token is nog steeds geldig
Tokens zijn zes weken geldig nadat ze zijn gemaakt. Verder moet u feedback indienen om de geldige tot datum te verlengen. Handleiding voor oorsprong Trials voor webontwikkelaars legt uit hoe u ervoor kunt zorgen dat uw token geldig is voor een volledige oorsprongstroef.
U kunt controleren op actieve tokens op uw Chrome Origin Trials Mijn registratiespagina :
Chrome Devtools geeft Success weer als het token nog steeds geldig is:
Als uw token is verlopen, geeft DevTools de status weer Expired en geeft uw pagina mijn registraties een verlopen tokens -sectie weer.
De oorsprongstroef is aan de gang
U kunt de einddatum controleren voor een oorsprongstroef van de registratiepagina :
Voor beproevingen die zijn beëindigd, toont DevTools zoiets als dit:
U wordt geautomatiseerde e -mails verzonden wanneer feedback vereist is of er een token op het punt staat te vervallen, maar niet wanneer de proefperiode eindigt.
De oorsprongstroef is beschikbaar voor de huidige gebruiker
Sommige oorsprongstroeven zijn niet beschikbaar voor bepaalde gebruikers, zelfs als er een geldig token wordt verstrekt.
Als een proef niet beschikbaar is voor de huidige gebruiker, toont Chrome Devtools een waarschuwing TrialNotAllowed :
Informatie over gebruiksbeperkingen en beschikbaarheid wordt voor elke oorsprongstroef verstrekt.
Zoals bij elke webplatformfunctie, moet u functie -detectie gebruiken om te bevestigen dat een functie Origin wordt ondersteund voordat u deze gebruikt.
Gebruik van de originatie van de oorsprong is niet overschreden
Standaard is een functie Origin Trial ingeschakeld op elke pagina met een geldig token voor de proef.
Behalve in zeldzame gevallen is het gebruik van de oorsprongstudie beperkt tot maximaal 0,5% van alle chrome paginabaden . De functie Origin Trial is uitgeschakeld als het totale gebruik door alle Chrome -gebruikers dat bedrag overschrijdt. DevTools geeft de tokenstatus weer als uitgeschakeld.
Er zijn geen gebruikslimieten voor afschrijvingen, omdat ze geen nieuwe functies introduceren en daarom geen risico vormen om een aanzienlijk deel van de web afhankelijk te maken van een proeffunctie.
Sommige proeven bieden een optie om het gebruik te beperken, wat betekent dat originele proeffuncties voor sommige gebruikers zijn uitgeschakeld. Deze optie wordt beschikbaar gesteld op de registratiepagina voor een oorsprongstroef die deze biedt:
Als u merkt dat de toegang door uw gebruikers tot een functie van oorsprong lager is dan verwacht, zorg er dan voor dat de standaardlimiet is geselecteerd.
Iframes bieden hun eigen tokens
Om toegang te geven tot een functie van de oorsprong, moet een IFRAME een token bieden in een metatag, een HTTP -header of programmatisch . Iframes erven geen toegang tot functies die zijn ingeschakeld voor pagina's die ze bevatten.
ot-iframe.glitch.me demonstreert toegang tot een originele proeffunctie vanuit een iframe. OT-Iframe-3P.Glitch.me biedt meerdere cross-origin iframe-voorbeelden.
Machtigingsbeleid is correct geconfigureerd
Sommige functies van de oorsprong kunnen worden beïnvloed door een Permissions-Policy . U kunt dit controleren in de bedoeling om te experimenteren met de proeffunctie of in ontwikkelaarsdocumentatie voor de functie op ontwikkelaar.chrome.com/docs .
Zorg ervoor dat de functie die u probeert te openen niet wordt geblokkeerd door een Permissions-Policy . U kunt controleren op responskoppen in het Netwerkpaneel van Chrome Devtools en de volledige lijst met toegestane functies in het applicatiepaneel bekijken.
Hoe zit het met de arbeiders?
Origing Trials -functies kunnen beschikbaar worden gesteld aan servicemedewerkers, gedeelde werknemers en toegewijde werknemers. Om toegang voor servicemedewerkers en gedeelde werknemers mogelijk te maken, moet u een token opgeven in een koptekst Origin-Trial .
Toegewijde werknemers erven toegang tot functies die zijn mogelijk gemaakt door hun ouderdocument.
Token wordt verstrekt voordat de functie toegankelijk is
Zorg ervoor dat er een originaatstudietoken wordt verstrekt voordat een proeffunctie wordt toegankelijk. Als een pagina bijvoorbeeld een token biedt met JavaScript, zorg er dan voor dat de code om het token te geven wordt uitgevoerd vóór code die probeert toegang te krijgen tot de proeffunctie.
Origin Trial Demos
De volgende sites tonen voorbeelden van tokenimplementatie.
Hoe u een origin -proeftoken kunt leveren
- Token in een metatag
- Token in een kopbal
- Token geïnjecteerd door script van derden
- Functie toegankelijk in een iframe
- Cross-origin iframe voorbeelden
Origin Trial Tools
Functies in herkomstproef
De volgende zijn demo's voor API's in lopende oorsprongstroeven
Meer informatie
- Ga aan de slag met Chrome Origin -proeven
- Originsproeven van derden
- Handgids voor oorsprong voor webontwikkelaars
- Origin Trial Explerer
- Een originatieproeven uitvoeren
- Proces voor het lanceren van nieuwe functies in chroom
- Intenties om uit te leggen: het knipoogverzendproces demystificeren
- Gebruik oorsprongstroeven in Microsoft Edge
- Origin Trials voor Firefox
Pak gemeenschappelijke problemen aan met proeftokens in metatags, headers en scripts.
Deze gids veronderstelt een werkende kennis van oorsprongstroeven in Chrome . Raadpleeg voor een gedetailleerde FAQ de Hands Proeven Guide voor webontwikkelaars .
Als u een bug tegenkomt met oorsprongstroeven in Chrome, dient u een nieuw probleem in over de GitHub -repository van Chrome Origin.
Checklist
Om problemen met de oorsprong op te lossen, kunt u elk van de problemen doorlopen met behulp van de geleverde links.
Gebruik Chrome Devtools om tokens te controleren
DevTools biedt originatie -proefinformatie in het applicatiepaneel , voor het geselecteerde frame.
Vouw het bovenste frame uit om originele proeftokens te inspecteren die beschikbaar zijn voor een subframe. Voor de demo-pagina op ot-iframe.glitch.me kunt u bijvoorbeeld zien dat de pagina in de IFRAME een token biedt.
- Token -status : of de pagina een geldig token heeft. Merk op dat er voor sommige origetproeven andere factoren kunnen zijn, zoals geografische beperkingen, die betekenen dat de originele proeffunctie niet beschikbaar is, ondanks de aanwezigheid van een geldig token. Chrome Devtools Status Codes verklaart de betekenis van elk van de codes voor oorsprongstroeven.
- Oorsprong : de weboorsprong geregistreerd voor het token.
- Vervaltijd : de maximale (laatste) mogelijke vervaldatum en tijd voor het token, dat (voor het grootste deel) overeenkomt met het einde van de proef. Dit is niet hetzelfde als de geldige tot datum voor het token dat wordt weergegeven in mijn registraties , die laat zien hoe lang het token geldig is en kan worden uitgebreid .
- Gebruiksbeperking : gebruikslimieten, die voor sommige proeven kunnen worden ingesteld .
- Derden : of matching van derden is ingeschakeld voor het token. Dit is beschikbaar voor sommige oorsprongstroeven, waarbij een proeffunctie toegankelijk is op meerdere sites van scripts van derden.
- Match Sub-domeinen : of subdomein-matching is ingeschakeld voor het token. Hierdoor kan een functie van een oorsprongstudie worden getest op meerdere subdomeinen van een oorsprong, zonder een ander token voor elk subdomein te vereisen.
Chrome Devtools toont een waarschuwing naast de proefnaam als de proef is: niet beschikbaar voor de huidige gebruiker, het token is verlopen of als er andere beperkingen zijn.
Statuscodes
U kunt de volgende statuscodes tegenkomen in Chrome Devtools.
Verlopen : Token heeft zijn vervaldatum aangenomen. Om de originele proef opnieuw in te schakelen, moet het token worden vernieuwd. Genereer een nieuw token met een nieuwe vervaldatum. Broncode
Featuredisabled : proef is uitgeschakeld voor gebruik. Broncode
FeaturedInabledForUser : Dit token is aangeduid als uitgeschakeld voor de huidige gebruiker met een alternatieve gebruiksbeperking. Zie het gedeelte "Us -subset -uitsluitingen" van het ontwerpdocum . Broncode 1 en broncode 2
Onzeker : de aanvraagoorsprong is onzeker en de proef is niet ingeschakeld voor onzekere oorsprong. Zoals uitgelegd in de herkomstproef Token Validator-code : 'Voor tokens van derden moeten zowel de huidige oorsprong als de scriptoorsprong veilig zijn. Vanwege subdomein matching is de token -oorsprong mogelijk geen exacte match voor een van de verstrekte script -oorsprong, en het resultaat geeft niet aan welke specifieke oorsprong is gekoppeld. Dit betekent dat het geen directe lookup is om de juiste scriptoorsprong te vinden. Om te voorkomen dat alle vergelijkingen van de oorsprong opnieuw doen, zijn er snelkoppelingen die afhankelijk zijn van hoeveel scriptoorsprong is verstrekt. Er moet er minstens één zijn, of het token van derden zou niet met succes worden gevalideerd. ' Broncode
Ongeldigsignatuur : het token heeft een ongeldige of misvormde handtekening. Broncode
Malformed : token is misvormd en kan niet worden ontleed. Broncode
NotSupported : de door het token gedefinieerde oorsprongstudie wordt niet ondersteund in de Chromium Embedder. Een embedder kan een browser zijn (zoals Chrome of Edge), een WebView of een andere gebruikersagent. Broncode
Succes : het token is goed gevormd, is niet verlopen, komt overeen met een functie van de oorsprong en wordt gevraagd vanuit een verwachte oorsprong. Broncode
TOKENDISADED : Token is gemarkeerd als gehandicapt en kan niet worden gebruikt. Broncode
Trialnotallowed : de oorsprongstroef is niet beschikbaar voor de huidige gebruiker . Broncode
UNKNOORDTRIAL : Het token specificeert een functienaam die niet overeenkomt met een bekende proef. Broncode
FINEOORIGIN : De oorsprong van de aanvraag komt niet overeen met de oorsprong die in het token is opgegeven. Dit kan het schema, hostnaam of poort omvatten. Deze status wordt ook weergegeven als een token van derden wordt verstrekt in een HTTP-header, meta-tag of inline script, in plaats van uit een extern JavaScript-bestand. Broncode
Wrongversion : u gebruikt de verkeerde tokenversie. Alleen token versie 2 en 3 worden ondersteund. Broncode
Vereiste voorwaarden voor oorsprongstroeven
Als uw oorsprongstroef niet werkt zoals verwacht, zorg er dan voor dat u aan de volgende voorwaarden bent voldaan.
Je test in chroom, geen chroom of een andere browser
Chrome Origin -proeven zijn ontworpen om te werken voor Chrome -gebruikers. Chrome Origin Trieken Tokens maakt geen functies mogelijk in andere browsers, waaronder chroom- en chroom-gebaseerde browsers. Dit komt omdat chrome oorsprongstroeven specifiek zijn voor functies die beschikbaar zijn in Chrome voor experimenten.
Oorspronkelijke proeven zijn ook beschikbaar voor Firefox en Microsoft Edge . De inschrijving in een proefperiode van Firefox of Edge Origin zal een functie in Chrome niet mogelijk maken.
De oorsprongstroef is ingeschakeld voor de Chrome -versies die toegang hebben tot uw site
Toegang tot oorsprongstroeven is beperkt tot specifieke versies van Chrome. Dit kan betekenen dat een proeffunctie alleen beschikbaar is voor pre-stabiele Chrome-kanalen: Canary, Dev en Beta.
U kunt de beschikbaarheid van de versies controleren op de registratiepagina voor de proef:
U kunt de Chrome -versie bekijken die u gebruikt via Chrome: // -versie .
De oorsprongstroef is niet uitgeschakeld door Chrome -instellingen
Als een individuele gebruiker meldt dat een functie niet voor hen werkt, controleer dan of de functie niet is uitgeschakeld in hun Chrome -instellingen. Bepaalde privacy -sandbox -functies kunnen bijvoorbeeld worden uitgeschakeld vanuit de pagina chrome://settings/adPrivacy .
Sleutelwoorden en syntaxis zijn correct
Zorg ervoor dat u de juiste trefwoorden en syntaxis gebruikt voor originele proeftokens.
Voor gebruik van het eerste deel van de eerste partij kan een token worden verstrekt in een meta-tag origin-trial :
<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">
Als alternatief kan een token worden verstrekt in een kopie van Origin-Trial respons. Hier is een voorbeeld met Express in Node.js:
app.use(function(req, res, next) {
res.setHeader('Origin-Trial', 'Aj4DysCv3VjknU3...')
next();
});
Tokens kunnen ook worden voorzien van JavaScript :
function addTrialToken(tokenContents) {
const tokenElement = document.createElement('meta');
tokenElement.httpEquiv = 'origin-trial';
tokenElement.content = tokenContents;
document.head.appendChild(tokenElement);
}
First-party token oorsprong overeenkomsten pagina oorsprong
Zorg ervoor dat de waarde van de weboorsprong die is geselecteerd wanneer u zich registreert voor een proefperiode overeenkomt met de oorsprong van de pagina die de metatag of koptekst heeft die het token biedt.
Als u bijvoorbeeld https://example.com hebt geselecteerd als weboorsprong :
Misschien krijg je een tokenwaarde zoals deze:
Controleer of deze waarde overeenkomt met het token dat wordt gebruikt op de pagina die u oplossen.
Controleer de HTML voor een token in een metatag:
<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">
Voor een token in een koptekst, kunt u de tokenwaarde controleren vanuit het Netwerkpaneel van Chrome Devtools onder antwoordkoppen :
First-party token wordt geserveerd van de oorsprong die het gebruikt
Om de toegang tot een originele proeffunctie mogelijk te maken voor code opgenomen in een pagina die wordt geserveerd van uw oorsprong, biedt u een proeftoken in een metatag, koptekst of met JavaScript van dezelfde oorsprong.
De oorsprong die is geregistreerd voor een token moet overeenkomen met de oorsprong die deze bedient.
Token van derden komt overeen met scriptoorsprong
U kunt zich registreren om deel te nemen aan een oorsprongstroef voor scripts die worden geïnjecteerd op andere oorsprong.
Als u bijvoorbeeld scripts wilt die worden geserveerd van javascript-library.example Voorbeeld om deel te nemen aan een oorsprongstroef, moet u een token registreren met matching van derden voor javascript-library.example .
De oorsprongswaarde voor een token van derden moet overeenkomen met de oorsprong van het script dat het injecteert.
Script van derden maakt gebruik van een token van derden
U kunt een script van derden niet inschakelen om deel te nemen aan een oorsprongstroef op uw site door alleen een token voor uw oorsprong te registreren en het script te vergeten.
Scripts van derden moeten tokens gebruiken met matching van derden ingeschakeld, geïnjecteerd met het script zelf. Deze tokens kunnen niet worden opgenomen in een metatag of koptekst op uw site. Het JavaScript ziet er misschien uit als het volgende:
// Add a third-party OT token
function addTrialToken(tokenContents) {
const tokenElement = document.createElement('meta');
tokenElement.httpEquiv = 'origin-trial';
tokenElement.content = tokenContents;
document.head.appendChild(tokenElement);
}
Token van derden is voorzien van een extern script, geen metatag, HTTP-header of inline script
Tokens van derden worden gevalideerd tegen de oorsprong van het script dat ze heeft geïnjecteerd. Inline scripts en <meta> tags in statische markup hebben echter geen oorsprong.
Dit betekent dat een token van derden een extern script moet krijgen, niet in een <meta> tag of inline script. Het maakt niet uit of het externe script dat het token injecteert, van dezelfde oorsprong komt als de bevattende pagina of een andere oorsprong, zolang de oorsprong van het script overeenkomt met een oorsprong die is geregistreerd voor de proef.
Zie een demo hiervan op OT-Iframe-3p.glitch.me .
Toegang van de oorsprongstudies wordt ondersteund voor de methode die wordt gebruikt om een proeftoken te bieden
Sommige soorten toegang tot originele proeffuncties vereisen dat u op een specifieke manier een proeftoken opgeeft. De enige manier om de toegang tot originele proefmedewerkers en gedeelde werknemers bijvoorbeeld in te schakelen, is door een token te bieden in een Origin-Trial .
Subdomein matching is ingeschakeld voor een token dat op een subdomein wordt gebruikt
Als een functie Origin Trial niet lijkt te werken voor sommige pagina's op uw site, controleer dan dat tokens correct zijn ingesteld voor de subdomeinen die ze bedienen.
Wanneer u zich registreert voor een oorsprongstroef, kunt u optioneel kiezen om alle subdomeinen van de oorsprong te matchen:
U kunt ook subdomeinen matchen voor tokens van derden:
Subdomein -tokens worden niet uitgegeven voor oorsprong in de lijst van openbare achtervoegsel . U kunt bijvoorbeeld geen oorsprong registreren zoals https://appspot.com of https://github.io , hoewel u zich kunt registreren voor domeinen binnen die oorsprong, zoals https://example.appspot.com of https://example.github.io .
Het token is nog steeds geldig
Tokens zijn zes weken geldig nadat ze zijn gemaakt. Verder moet u feedback indienen om de geldige tot datum te verlengen. Handleiding voor oorsprong Trials voor webontwikkelaars legt uit hoe u ervoor kunt zorgen dat uw token geldig is voor een volledige oorsprongstroef.
U kunt controleren op actieve tokens op uw Chrome Origin Trials Mijn registratiespagina :
Chrome Devtools geeft Success weer als het token nog steeds geldig is:
Als uw token is verlopen, geeft DevTools de status weer Expired en geeft uw pagina mijn registraties een verlopen tokens -sectie weer.
De oorsprongstroef is aan de gang
U kunt de einddatum controleren voor een oorsprongstroef van de registratiepagina :
Voor beproevingen die zijn beëindigd, toont DevTools zoiets als dit:
U wordt geautomatiseerde e -mails verzonden wanneer feedback vereist is of er een token op het punt staat te vervallen, maar niet wanneer de proefperiode eindigt.
De oorsprongstroef is beschikbaar voor de huidige gebruiker
Sommige oorsprongstroeven zijn niet beschikbaar voor bepaalde gebruikers, zelfs als er een geldig token wordt verstrekt.
Als een proef niet beschikbaar is voor de huidige gebruiker, toont Chrome Devtools een waarschuwing TrialNotAllowed :
Informatie over gebruiksbeperkingen en beschikbaarheid wordt voor elke oorsprongstroef verstrekt.
Zoals bij elke webplatformfunctie, moet u functie -detectie gebruiken om te bevestigen dat een functie Origin wordt ondersteund voordat u deze gebruikt.
Gebruik van de originatie van de oorsprong is niet overschreden
Standaard is een functie Origin Trial ingeschakeld op elke pagina met een geldig token voor de proef.
Behalve in zeldzame gevallen is het gebruik van de oorsprongstudie beperkt tot maximaal 0,5% van alle chrome paginabaden . De functie Origin Trial is uitgeschakeld als het totale gebruik door alle Chrome -gebruikers dat bedrag overschrijdt. DevTools geeft de tokenstatus weer als uitgeschakeld.
Er zijn geen gebruikslimieten voor afschrijvingen, omdat ze geen nieuwe functies introduceren en daarom geen risico vormen om een aanzienlijk deel van de web afhankelijk te maken van een proeffunctie.
Sommige proeven bieden een optie om het gebruik te beperken, wat betekent dat originele proeffuncties voor sommige gebruikers zijn uitgeschakeld. Deze optie wordt beschikbaar gesteld op de registratiepagina voor een oorsprongstroef die deze biedt:
Als u merkt dat de toegang door uw gebruikers tot een functie van oorsprong lager is dan verwacht, zorg er dan voor dat de standaardlimiet is geselecteerd.
Iframes bieden hun eigen tokens
Om toegang te geven tot een functie van de oorsprong, moet een IFRAME een token bieden in een metatag, een HTTP -header of programmatisch . Iframes erven geen toegang tot functies die zijn ingeschakeld voor pagina's die ze bevatten.
ot-iframe.glitch.me demonstreert toegang tot een originele proeffunctie vanuit een iframe. OT-Iframe-3P.Glitch.me biedt meerdere cross-origin iframe-voorbeelden.
Machtigingsbeleid is correct geconfigureerd
Sommige functies van de oorsprong kunnen worden beïnvloed door een Permissions-Policy . U kunt dit controleren in de bedoeling om te experimenteren met de proeffunctie of in ontwikkelaarsdocumentatie voor de functie op ontwikkelaar.chrome.com/docs .
Zorg ervoor dat de functie die u probeert te openen niet wordt geblokkeerd door een Permissions-Policy . U kunt controleren op responskoppen in het Netwerkpaneel van Chrome Devtools en de volledige lijst met toegestane functies in het applicatiepaneel bekijken.
Hoe zit het met de arbeiders?
Origing Trials -functies kunnen beschikbaar worden gesteld aan servicemedewerkers, gedeelde werknemers en toegewijde werknemers. Om toegang voor servicemedewerkers en gedeelde werknemers mogelijk te maken, moet u een token opgeven in een koptekst Origin-Trial .
Toegewijde werknemers erven toegang tot functies die zijn mogelijk gemaakt door hun ouderdocument.
Token wordt verstrekt voordat de functie toegankelijk is
Zorg ervoor dat er een originaatstudietoken wordt verstrekt voordat een proeffunctie wordt toegankelijk. Als een pagina bijvoorbeeld een token biedt met JavaScript, zorg er dan voor dat de code om het token te geven wordt uitgevoerd vóór code die probeert toegang te krijgen tot de proeffunctie.
Origin Trial Demos
De volgende sites tonen voorbeelden van tokenimplementatie.
Hoe u een origin -proeftoken kunt leveren
- Token in een metatag
- Token in een kopbal
- Token geïnjecteerd door script van derden
- Functie toegankelijk in een iframe
- Cross-origin iframe voorbeelden
Origin Trial Tools
Functies in herkomstproef
De volgende zijn demo's voor API's in lopende oorsprongstroeven
Meer informatie
- Ga aan de slag met Chrome Origin -proeven
- Originsproeven van derden
- Handgids voor oorsprong voor webontwikkelaars
- Origin Trial Explerer
- Een originatieproeven uitvoeren
- Proces voor het lanceren van nieuwe functies in chroom
- Intenties om uit te leggen: het knipoogverzendproces demystificeren
- Gebruik oorsprongstroeven in Microsoft Edge
- Origin Trials voor Firefox