Erste Schritte mit Ursprungstests

Eine neue oder experimentelle Funktion der Webplattform testen.

Sam Dutton

Mit Ursprungstests erhalten Sie Zugriff auf eine neue oder experimentelle Funktion, mit der Sie Funktionen erstellen können, die Ihre Nutzer für eine begrenzte Zeit testen können, bevor die Funktion für alle Nutzer verfügbar 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.

Ursprungstests 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 begrenztem Support. Die Teilnehmer sollten bereit und in der Lage sein, mithilfe der verfügbaren Dokumentation relativ selbstständig zu arbeiten. In dieser Phase beschränken wir uns in dieser Phase wahrscheinlich nur auf API-Spezifikationen und -Erklärungen. Wir versuchen aber, nach Möglichkeit Orientierungshilfen 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 mehreren Ursprungstests unterzogen werden, da Feedback berücksichtigt und Anpassungen vorgenommen werden.

Ursprungstests sind auch für Firefox und Microsoft Edge verfügbar.

Tests für Drittanbieter-Kampagnen

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 zu Tests mit Drittanbieter-Kampagnen

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 aus AppCache benötigen, können sich für den Test zur Einstellung von AppCache bis Chrome 93 registrieren.

An einem Test für den Ursprung teilnehmen

  1. Wählen Sie in der Liste der aktiven Tests einen Ursprungstest aus.
  2. Fordern Sie ein Token an. Klicken Sie dazu auf die Schaltfläche Registrieren und füllen Sie das Formular aus.
  3. Geben Sie das Token auf jeder Webseite an, für die die Testfunktion aktiviert werden soll:
  4. Probieren Sie die neue Funktion aus.
  5. Feedback geben. Dies geschieht über die Testwebsite des Ursprungs. Dieses Feedback ist nicht öffentlich und nur für eine begrenzte Gruppe von Personen des Chrome-Teams 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 werden Sie noch einmal um Feedback gebeten.

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.

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 Ursprungstest 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.

  1. Rufen Sie die Seite Meine Registrierungen auf.

  2. Klicken Sie für jede Quelle, die für die verlängerte Testversion registriert ist, auf die Schaltfläche VERLÄNGEN. Screenshot der Seite „Meine Registrierungen“ des Chrome-Ursprungstests mit den Schaltflächen „VERLÄNGERN“

  3. Kopieren Sie das neue Token und stellen Sie es für alle Seiten zur Verfügung, die am Test teilnehmen sollen. Sie können bei Bedarf mehrere Tokens angeben. Ungültige oder abgelaufene Tokens werden von Chrome ignoriert.

Informationen zum Ursprungstest ansehen

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

Informationen zum Ursprungstest für eine Website, die in der Detailansicht des Steuerfelds **Anwendung** der Chrome-Entwicklertools angezeigt werden.

Sie können auch unseren Ursprungstesttoken-Decodierer verwenden, um die in einem Token codierten Daten anzuzeigen.

Tool zum Decodieren von Ursprungstests, mit decodierten Ursprungstestwerten

Demos für Ursprungstests

Weitere Informationen