Erste Schritte mit Ursprungstests

Neue oder experimentelle Webplattformfunktionen 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 ausprobieren können, bevor die Funktion allgemein verfügbar ist.

Wenn Chrome einen Ursprungstest für eine Funktion anbietet, können Sie sich dafür registrieren, um die Funktion für alle Nutzer Ihrer Herkunft zu aktivieren, ohne dass diese Flags umschalten oder zu einem anderen Chrome-Build wechseln müssen (aber sie müssen möglicherweise ein Upgrade ausführen). Mit Ursprungstests können Entwickler Demos und Prototypen mit neuen Funktionen erstellen. Die Tests helfen Chrome-Entwicklern auch zu verstehen, wie neue Funktionen verwendet werden und wie sie mit anderen Webtechnologien interagieren können.

Ursprungstests sind öffentlich und für alle Entwickler zugänglich. Sie sind in Bezug auf Dauer und 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 zur Verfügung stehenden Dokumentation relativ unabhängig zu arbeiten, die sich derzeit wahrscheinlich auf API-Spezifikationen und Erklärer beschränkt wird. Wir versuchen jedoch, wenn möglich Unterstützung anzubieten.

Wenn Sie sich für eine Testversion registrieren, werden Sie vom Chrome-Team regelmäßig um konkretes Feedback zu Ihrer Verwendung der Testfunktion gebeten. Einige Funktionen durchlaufen möglicherweise mehrere Ursprungstests, bei denen Feedback berücksichtigt 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 Erstanbieter verfügbar: Sie funktionieren nur für einen einzelnen registrierten Ursprung. Mit Drittanbieter-Ursprungstests können Anbieter eingebetteter Inhalte eine neue Funktion auf mehreren Websites ausprobieren, ohne dass für jeden Ursprung ein Token erforderlich ist.

Weitere Informationen finden Sie unter Was sind Ursprungstests von Drittanbietern?

Testzeiträume für die Einstellung

Nicht alle Ursprungstests sind zum Testen neuer APIs gedacht. Bei einigen Testversionen kann eine eingestellte Funktion vorübergehend wieder aktiviert werden. Diese werden als Einstellungstests bezeichnet und in einigen Kontexten als "umgekehrte" Ursprungstests bezeichnet.

Beispielsweise ist AppCache aus Chrome 85 nicht mehr standardmäßig in Chrome verfügbar. Websites, die zusätzliche Zeit für die Migration aus AppCache benötigen, können sich für den Einstellungstest registrieren, um AppCache bis Chrome 93 weiter zu verwenden.

An einem Ursprungstest teilnehmen

  1. Wählen Sie in der Liste der aktiven Tests einen Ursprungstest aus.
  2. Fordern Sie ein Token an, indem Sie auf die Schaltfläche Registrieren klicken und das Formular ausfüllen.
  3. Geben Sie das Token auf jeder Webseite an, für die Sie die Testfunktion aktivieren möchten:
  4. Jetzt die neue Funktion ausprobieren
  5. Feedback geben Verwenden Sie dazu die Ursprungstestwebsite. Dieses Feedback ist nicht öffentlich und steht nur einer begrenzten Gruppe von Personen im Chrome-Team zur Verfügung. Jede Testversion enthält auch einen Link für spontanes Feedback aus der Community. Dies verweist normalerweise 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 mehrmals für denselben Ursprungstest für verschiedene Ursprünge registrieren und mehrere Tokens auf derselben Seite angeben. Dies kann nützlich sein, wenn Sie Tokens angeben müssen, die für Ressourcen gültig sind, die aus unterschiedlichen Quellen bereitgestellt werden, z. B. Code, der auf mehreren Ihrer Websites enthalten ist.

Das Framework für Ursprungstests sucht nach dem ersten gültigen Token und ignoriert dann alle anderen Tokens. Dies können Sie mit den Chrome-Entwicklertools prüfen.

Token programmatisch bereitstellen

Anstatt wie oben beschrieben ein Token als HTTP-Header oder als Meta-Tag im HTML-Code deiner Seite bereitzustellen, kannst du ein Token mit JavaScript injizieren:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

Verwenden Sie diese Methode, wenn Sie einen Drittanbieter-Testzeitraum nutzen.

Tokens und iFrames

Wenn Sie über einen iFrame auf eine Testfunktion zugreifen möchten, können Sie ein Testtoken in einem Meta-Tag, in einem HTTP-Header oder programmatisch bereitstellen.

Wie bei jeder Tokennutzung muss der für das Token registrierte Ursprung mit dem Kontext des JavaScript übereinstimmen, das auf die Testfunktion zugreift: entweder der Ursprung der Seite, die ein Inline-Skript enthält, oder der src eines <script>-Elements für JavaScript, das aus einer externen Datei eingebunden ist.

Tokens und Erweiterungen

Wenn Sie eine Testfunktion innerhalb eines Hintergrundskripts, eines Pop-ups oder eines Offscreen-Dokuments verwenden möchten, fügen Sie der manifest.json-Datei ein trial_token hinzu.

Content-Scripts werden anders gehandhabt. Ein Feature einer Welt zugänglich zu machen, kann verwirrend und wenig intuitiv sein. Statt den trial_token des Manifests zu verwenden, fügen Sie das Token der Seite hinzu. Fügen Sie dazu entweder mit declaritiveNetRequest einen Header ein oder programmieren direkt in Ihr Inhaltsskript. Denken Sie daran, dass Tokens an bestimmte Domains gebunden sind. Daher sollten Sie statt Ihrer Erweiterungs-ID ein Token für die Domain registrieren, auf der das Inhaltsskript ausgeführt wird.

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 Ursprungstest verlängert wird, erhalten Sie eine E-Mail-Warnung, dass Sie die Registrierung verlängern und für jeden im Test registrierten Ursprung ein neues Token angeben müssen.

  1. Rufe die Seite Meine Registrierungen auf.

  2. Klicken Sie für jeden Ursprung, der für den erweiterten Test registriert ist, auf die Schaltfläche VERLÄNGERN. 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 jede Seite bereit, die für die Testversion registriert bleiben soll. Sie können bei Bedarf mehrere Tokens angeben. Chrome ignoriert ungültige oder abgelaufene Tokens.

Informationen zum Ursprungstest ansehen

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

Informationen zum Ursprungstest einer Website, die in der Frame-Detailansicht im Bereich **Anwendung** der Chrome-Entwicklertools angezeigt wird.

Sie können auch unseren Token-Decodierer für Ursprungstest verwenden, um die in einem Token codierten Daten anzusehen.

Decodertool für Ursprungstests mit decodierten Ursprungstests.

Ursprungstests – Demos

Weitere Informationen