Erste Schritte mit Ursprungstests

Eine neue oder experimentelle Funktion der Webplattform testen.

Sam Dutton

Mit Ursprungstests erhältst du Zugriff auf eine neue oder experimentelle Funktion, damit du diese Funktion testen und für einen begrenzten Zeitraum deinen Nutzern anbieten kannst. Sobald der Test abgeschlossen und das Feedback ausgewertet ist, wird in Chrome entschieden, ob die Funktion für alle Nutzer verfügbar gemacht werden soll.

Sie können sich für einen Origin-Test registrieren, um eine Funktion für alle Nutzer auf Ihrer Quelle zu aktivieren, ohne dass sie Flags aktivieren oder zu einer alternativen Chrome-Version wechseln müssen. Möglicherweise müssen sie jedoch ein Upgrade durchführen. Nach der Registrierung können Entwickler mit den neuen Funktionen Demos und Prototypen erstellen. Die Tests helfen den Chrome-Entwicklern auch zu verstehen, wie neue Funktionen verwendet werden und wie sie mit anderen Webtechnologien interagieren können.

Verfügbarkeit

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 Hilfestellung zu geben.

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.

Tests für Drittanbieter-Kampagnen

Standardmäßig ist eine Ursprungstestfunktion nur für den Ursprung verfügbar, der für den Test registriert wurde. Bei einigen Testzeiträumen gibt es bei der Registrierung die Option zum Abgleich mit Drittanbietern. So können Anbieter von eingebetteten Inhalten oder Diensten eine neue Funktion auf mehreren Websites testen, ohne für jeden Ursprung ein Token zu benötigen.

Weitere Informationen: Was sind Tests mit Drittanbieter-Kampagnen?

Tests zur Einstellung

Bei einigen Ursprungstests kannst du eine eingestellte Funktion vorübergehend wieder aktivieren. Diese werden als Tests zur Einstellung bezeichnet. In einigen Kontexten werden sie auch als „umgekehrte“ Ursprungstests bezeichnet.

Beispielsweise wurden Mutationsereignisse ab Chrome 127 entfernt. Für Websites, bei denen noch etwas Zeit benötigt wird, um diese Ereignisse zu entfernen, können Sie sich für den Test zur Einstellung registrieren, um die Ereignisse vorübergehend auf bestimmten Websites wieder zu aktivieren.

An einem Test für den Ursprung teilnehmen

  1. Wählen Sie in der Liste der aktiven Tests einen Ursprungstest aus.
  2. Klicken Sie auf die Schaltfläche Registrieren und füllen Sie das Formular aus, um ein Token anzufordern.
  3. 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
  4. Probieren Sie die neue Funktion aus.
  5. Feedback geben. Dies geschieht über die Website des Testanbieters. Dieses Feedback ist nicht öffentlich und nur für eine begrenzte Gruppe von Personen im Chrome-Team verfügbar. Bei jedem Test gibt es auch einen Link für spontanes Community-Feedback. Dieser Link verweist in der Regel auf die Funktion auf GitHub oder einem anderen öffentlichen Kanal.
  6. 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 als 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, sidepanel oder Offscreen-Dokument verwenden möchten, verwenden Sie den Schlüssel trial_tokens in der Datei „manifest.json“.

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

Inhaltsskripte 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, können Sie das Token auf eine der folgenden Arten zur Seite hinzufügen:

Denken Sie daran, dass Tokens an bestimmte Domains gebunden sind. Sie müssen sich also für die Domain registrieren, auf der das Inhaltsskript ausgeführt wird, und nicht für Ihre Erweiterungs-ID.

Um Ihre Erweiterung für einen Testzeitraum zu registrieren, verwenden Sie die URL chrome-extension://YOUR_EXTENSION_ID, z. B. chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

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 erneuern und für jeden für den Test registrierten Ursprung ein neues Token angeben müssen.

  1. Rufen Sie Meine Registrierungen auf.
  2. Klicken Sie für jede Quelle, die für die verlängerte Testversion registriert ist, auf VERLÄNGEN. Beispiel für die Seite „Meine Registrierungen“ mit Schaltflächen zum VERLÄNGEN
  3. Kopieren Sie das neue Token und machen Sie es für alle Seiten verfügbar, die am Test teilnehmen sollen. Sie können bei Bedarf mehrere Tokens angeben.

Ungültige oder abgelaufene Tokens werden von Chrome ignoriert.

Informationen zur Testversion des Ursprungs ansehen

Informationen zu den Ursprungstests, die für eine Website verfügbar sind, finden Sie in den Chrome DevTools im Bereich Anwendung.

Detailansicht des Frames im Bereich „Anwendung“ der Chrome-Entwicklertools

Mit unserem Decoder für Ursprungs-Test-Token können Sie sich die in einem Token codierten Daten ansehen.

Tool zum Decodieren von Ursprungstests, mit decodierten Ursprungstestwerten

Demos

Auf den folgenden Websites finden Sie Beispiele für die Tokenbereitstellung.

Ursprungs-Testzeitraum-Token bereitstellen

Tools für Ursprungstests

Funktionen im Ursprungstest

Die folgenden Demos sind für APIs in laufenden Ursprungstests

Ressourcen

Weitere Informationen finden Sie in der Chrome-Konzeptdokumentation:

Weitere Informationen zu Ursprungstests in Chrome:

Andere Browser

Ursprungstests in anderen Browsern finden: