Eine neue oder experimentelle Funktion der Webplattform testen.
Mit Ursprungstests erhältst du Zugriff auf eine neue oder experimentelle Funktion, um Funktionen zu entwickeln, die deine Nutzer für begrenzte Zeit testen können, bevor die Funktion für alle verfügbar gemacht wird.
Wenn Chrome einen Ursprungstest für eine Funktion anbietet, können Sie sich für den Test registrieren, um die Funktion für alle Nutzer in Ihrem Ursprung zu aktivieren, ohne dass sie Flags aktivieren oder zu einer alternativen Chrome-Version wechseln müssen (es kann jedoch sein, dass sie ein Upgrade ausführen müssen). Mit Ursprungstests können Entwickler Demos und Prototypen mit neuen Funktionen erstellen. Außerdem können die Chrome-Entwickler so besser nachvollziehen, wie neue Funktionen verwendet werden und wie sie mit anderen Webtechnologien interagieren.
Origin-Tests sind öffentlich und für alle Entwickler zugänglich. Sie sind zeitlich und in der Nutzung begrenzt. Die Teilnahme ist ein selbstverwalteter Prozess mit begrenzter Dokumentation und Unterstützung. Die Teilnehmer sollten bereit und in der Lage sein, relativ unabhängig mit der verfügbaren Dokumentation zu arbeiten, die sich in dieser Phase wahrscheinlich auf API-Spezifikationen und Erläuterungen beschränkt. Wir versuchen jedoch, nach Möglichkeit Anleitungen bereitzustellen.
Wenn Sie sich für einen Test registrieren, wird das Chrome-Team Sie regelmäßig um Feedback zu Ihrer Nutzung der Testfunktion bitten. Einige Funktionen können mehrere Herkunftstests durchlaufen, da Feedback einbezogen und Anpassungen vorgenommen werden.
Ursprungstests sind auch für Firefox und Microsoft Edge verfügbar.
Ursprungstests von Drittanbietern
Ursprungstests sind in der Regel nur für selbst erhobene Daten verfügbar. Sie funktionieren nur für einen einzelnen registrierten Ursprung. Mit Tests für Drittanbieter-Quellen können Anbieter von eingebetteten Inhalten eine neue Funktion auf mehreren Websites ausprobieren, ohne für jede Quelle ein Token zu benötigen.
Weitere Informationen: Was sind Ursprungstests von Drittanbietern?
Tests zur Einstellung
Nicht alle Ursprungstests dienen dem Testen neuer APIs. Bei einigen Tests kann eine eingestellte Funktion vorübergehend wieder aktiviert werden. Diese werden als Tests zur Einstellung bezeichnet und in einigen Kontexten auch als „umgekehrte“ Ursprungstests.
Beispielsweise ist AppCache ab Chrome 85 nicht mehr standardmäßig in Chrome verfügbar. Websites, die mehr Zeit für die Migration von AppCache benötigen, können sich für den Test zur Einstellung registrieren, um AppCache bis Chrome 93 weiter zu verwenden.
An einem Test für den Ursprung teilnehmen
- Wählen Sie einen Ursprungstest aus der Liste der aktiven Tests aus.
- Klicken Sie auf die Schaltfläche Registrieren und füllen Sie das Formular aus, um ein Token anzufordern.
- Geben Sie das Token auf jeder Webseite an, für die die Testfunktion aktiviert werden soll:
- Als Meta-Tag im <head>-Tag:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
- Als HTTP-Header:
Origin-Trial: TOKEN_GOES_HERE
- Programmatisch ein Token angeben
- Als Meta-Tag im <head>-Tag:
- Probieren Sie die neue Funktion aus.
- Feedback geben. Dies können Sie über die Website des Ursprungstests tun. Dieses Feedback ist nicht öffentlich und nur für eine begrenzte Gruppe von Personen im Chrome-Team verfügbar. Jeder Test stellt auch einen Link für spontanes Community-Feedback zur Verfügung. Dieser Link verweist in der Regel auf die Funktion auf GitHub oder einem anderen öffentlichen Kanal.
- Wenn Ihr Token abläuft, erhalten Sie eine E-Mail mit einem Link zur Verlängerung. Dazu müssen Sie noch einmal Feedback geben.
Sie können sich für denselben Test mehrere Male registrieren, für verschiedene Ursprünge und mehrere Tokens auf derselben Seite einschließen. Das kann nützlich sein, wenn Sie Tokens bereitstellen müssen, die für Ressourcen gültig sind, die von verschiedenen Ursprüngen ausgeliefert werden, z. B. Code, der auf mehreren von Ihnen betriebenen Websites enthalten ist.
Das Framework für Ursprungstests sucht nach dem ersten gültigen Token und ignoriert dann alle anderen Tokens. Sie können dies mit den Chrome-Entwicklertools prüfen.
Token programmatisch bereitstellen
Anstatt ein Token wie oben beschrieben als HTTP-Header oder Meta-Tag in den HTML-Code Ihrer Seite einzufügen, können Sie es auch mit JavaScript einschleusen:
const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);
Verwenden Sie diese Methode, wenn Sie an einem Test von Drittanbietern teilnehmen.
Tokens und iFrames
Wenn du über einen Iframe auf eine Testfunktion zugreifen möchtest, kannst du ein Testtoken in einem Meta-Tag, einem HTTP-Header oder programmgesteuert angeben.
Wie bei jeder Tokennutzung muss der für das Token registrierte Ursprung mit dem Kontext des JavaScripts übereinstimmen, das auf die Testfunktion zugreift: entweder der Ursprung der Seite, die ein Inline-Script enthält, oder die src
eines <script>
-Elements für JavaScript, das aus einer externen Datei eingebunden ist.
Tokens und Erweiterungen
Wenn Sie eine Testfunktion in einem Hintergrundskript, Pop-up, Seitenleiste oder Offscreen-Dokument verwenden möchten, verwenden Sie den Schlüssel trial_tokens
in Ihrer manifest.json-Datei.
"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]
Inhaltsscripts werden anders behandelt. Wenn eine Funktion nur für eine Welt sichtbar ist, kann das verwirrend und nicht intuitiv sein. Anstatt das trial_token
des Manifests zu verwenden, fügen Sie das Token der Seite hinzu. Dazu können Sie entweder einen Header mit declarativeNetRequest einfügen oder das Token programmatisch direkt in Ihr Inhaltsscript einfügen. Denken Sie daran, dass Tokens an bestimmte Domains gebunden sind. Sie sollten also einen Token für die Domain registrieren, auf der das Inhaltsskript ausgeführt wird, und nicht für Ihre Erweiterungs-ID.
Verwenden Sie die URL chrome-extension://YOUR_EXTENSION_ID
, z. B. chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk
, um Ihre Erweiterung für einen Testzeitraum zu registrieren.
Registrierung für Testversion verlängern
Wenn ein Testzeitraum für einen Ursprung verlängert wird, erhalten Sie eine E-Mail-Warnung, dass Sie die Registrierung für jeden Ursprung, der für den Test registriert ist, erneuern und ein neues Token angeben müssen.
Rufen Sie die Seite My Registrations (Meine Registrierungen) auf.
Klicken Sie für jede Quelle, die für die verlängerte Testversion registriert ist, auf die Schaltfläche VERLÄNGEN.
Kopieren Sie das neue Token und stellen Sie es für jede Seite zur Verfügung, die für den Test registriert bleiben soll. Sie können bei Bedarf mehrere Tokens angeben. Ungültige oder abgelaufene Tokens werden von Chrome ignoriert.
Informationen zur Testversion des Ursprungs ansehen
In den Chrome-Entwicklertools im Bereich Anwendung finden Sie Informationen zu den für eine Seite verfügbaren Ursprungstests.
Mit unserem Decoder für Ursprungs-Test-Token können Sie sich die in einem Token codierten Daten ansehen.
Demos des Ursprungstests
- Token in einem Meta-Tag
- Token in einem Header
- Durch Drittanbieter-Script eingeschleustes Token
- Funktion, auf die über einen Iframe zugegriffen wird
- Beispiele für cross-origin-iFrames
- Ursprungstesttoken-Decodierer
Weitere Informationen
- Fehlerbehebung bei Ursprungstests in Chrome
- Was sind Tests mit Drittanbieter-Quellen?
- Leitfaden zu Ursprungstests für Webentwickler
- Erläuterung des Ursprungstests
- Ursprungstest ausführen
- Prozess zum Einführen neuer Funktionen in Chromium
- Intent to explain: Demystifying the Blink shipping process
- Informationen zu Ursprungstests in den Entwicklertools ansehen
- Ursprungstests in Microsoft Edge verwenden
- Ursprungstests für Firefox