Freigeben über

Verwenden von Ursprungstests in Microsoft Edge

  • Artikel

Verwenden Sie Ursprungstests, um experimentelle APIs für einen begrenzten Zeitraum auf Ihrer eigenen Livewebsite auszuprobieren. Wenn Sie Ursprungstests verwenden, können Benutzer von Microsoft Edge, die Ihre Website besuchen, Code ausführen, der experimentelle APIs verwendet.

Eine Liste der verfügbaren Ursprungstests und die Registrierung Ihres Ursprungs zum Testen einer der Ursprungstests finden Sie unter Microsoft Edge Origin Trials. Um die Eignung der Verwendung der experimentellen APIs auf Ihrer Website zu bewerten, überprüfen Sie die Mindestversionsanforderungen für Microsoft Edge, und überprüfen Sie das Ablaufdatum der Testversion.

Mithilfe der Registerkarte Probleme im Repository des Browserfeatures können Sie Den Entwicklern von Browserfeatures und der Community für Webstandards Feedback zum Design der API des Features, Ihren Anwendungsfällen oder Ihrer Erfahrung mit der Api des Features geben.

Funktionsweise des Ursprungstesttokens

Der Mechanismus für ursprungsbasierte Testversionen ermöglicht es einem Benutzer Ihrer Webseite, die API für experimentelle Features der Ursprungstestphase in seinem Microsoft Edge-Browser zu verwenden, obwohl das Feature standardmäßig deaktiviert ist. Der Microsoft Edge-Browser des Benutzers erkennt das Token der Ursprungstest und aktiviert dann automatisch das Featureflag des Browsers, das der Ursprungstestversion entspricht, für die das Token gültig ist. Der Benutzer muss keine in Microsoft Edge festlegen edge://flags .

So unterstützen Sie die Verwendung der experimentellen APIs einer Ursprungsstudie auf Ihrer Website:

  1. Registrieren Sie die Ursprungsdomäne, https://example.comfür die Sie das experimentelle Feature verwenden möchten (z. B. ), und dann wird ein Ursprungstesttoken für Sie generiert.

  2. Kopieren Sie das Token in ein Element oder in einen <head>/<meta>Origin-Trial HTTP-Serverantwortheader auf Ihre Webseite.

  3. Wenn ein Microsoft Edge-Benutzer Ihre Webseite besucht und der Browser ein Ursprungstesttoken findet, aktiviert der Browser das zugehörige Ursprungstestfeature.

Registrierung für eine Ursprungstestversion

So registrieren Sie sich für eine Ursprungsstudie:

  1. Wechseln Sie zu Microsoft Edge Origin Testversionen.

    Informationen zum Registrieren für die Testversion der Ad Selection-API finden Sie stattdessen unter Registrieren für die Anzeigenauswahl-API.

  2. Wählen Sie eine aktive Testversion aus.

  3. Klicken Sie auf die Schaltfläche Ich stimme den Nutzungsbedingungen zu .

  4. Wenn Sie dazu aufgefordert werden, melden Sie sich an. Melden Sie sich beispielsweise bei GitHub an, und autorisieren Sie dann die Seite Microsoft Edge Origin Trials für die Verwendung der Kontoanmeldung.

    Das Registrierungsformular für neue Ursprungstest wird geöffnet:

    Registrierungsformular für neue Ursprungstest

  5. Geben Sie im Textfeld Domäne eine Domänen-URL (z https://example.com. B. ) oder eine Unterdomänen-URL (z https://beta.example.com. B. ) ein.

    Sie können das Ursprungstesttoken so konfigurieren, dass folgendes unterstützt wird:

    • Eine einzelne Domäne, z https://example.com. B. , ohne die zugehörigen Unterdomänen zu unterstützen.
    • Eine einzelne Unterdomäne, z https://beta.example.com. B. .
    • Eine Domäne, z https://example.com. B. , und ihre Unterdomänen, z https://beta.example.com. B. .

    Nachfolgende Pfade und Abfrageparameter werden nicht unterstützt. Wenn ein URI eingegeben wird, der einen nachgestellten Pfad oder abfrageparameter wie https://example.com/path/new-featureaufweist, wird die Stammdomäne (z https://example.com. B. ) oder die Unterdomäne registriert, wobei nachfolgende Pfad- oder Abfrageparameter ignoriert werden.

  6. Legen Sie die Umschaltfläche Token für Unterdomänen aktivieren? fest.

    • Um die Verwendung der Ursprungstestversion in einer Domäne (z https://example.com. B. ) zu aktivieren, ohne deren Unterdomänen (z https://beta.example.com. B. ) zu unterstützen, stellen Sie sicher, dass die Umschaltfläche Token für Unterdomänen aktivieren? deaktiviert ist.

    • Um die Verwendung der Ursprungstestversion nur für eine bestimmte Unterdomäne (z https://beta.example.com. B. ) zu aktivieren, stellen Sie sicher, dass die Umschaltfläche Token für Unterdomänen aktivieren? deaktiviert ist.

    • Um die Verwendung der Ursprungstestversion in einer Domäne (z https://example.com. B. ) und der zugehörigen Unterdomänen (z https://beta.example.com. B. ) zu aktivieren, aktivieren Sie die Umschaltfläche Token für Unterdomänen aktivieren? .

  7. Klicken Sie auf die Schaltfläche Senden .

    Ein Ursprungstesttoken wird generiert und im Abschnitt Registrierungen in der Nähe des Formulars New Origin Trial Registration angezeigt:

    Das generierte Token, das im Abschnitt

  8. Klicken Sie auf die Schaltfläche Kopieren , und fügen Sie dann das Ursprungstesttoken an einem sicheren Ort ein, und notieren Sie, für welche Domäne es sich handelt. Sie können diese Informationen auch später auf dieser Webseite anzeigen.

Verwenden des Ursprungstesttokens auf Ihrer Website

Verwenden Sie das Token auf Ihrer Website auf eine der folgenden Arten:

Option 1: Ein <Metatag> im <Head-Element> einer Webseite

Fügen Sie im <head> Element einer Webseite das folgende <meta> Tag ein:

<meta http-equiv="origin-trial" content="EXAMPLE_TOKEN">

Ersetzen Sie durch EXAMPLE_TOKEN Ihr Token.

Option 2: Ein HTTP-Header in Ihrer HTTP-Serverantwort

Fügen Sie in ihrer HTTP-Serverantwort den folgenden HTTP-Header hinzu:

Origin-Trial: EXAMPLE_TOKEN

Ersetzen Sie durch EXAMPLE_TOKEN Ihr Token.

Deaktivieren eines Ursprungstestexperiments

Um ein Experiment (Ursprungstest) zu deaktivieren, bei dem Sie registriert sind, entfernen Sie das Ursprungstesttoken aus dem <meta> Tag oder aus den Serverantwortheadern.

Durchführen der Featureerkennung und Bereitstellen eines ordnungsgemäßen Fallbacks

Ursprungsversuche als experimentell behandeln. Als bewährte Methode führen Sie in Ihrem Websitecode die Featureerkennung durch, und stellen Sie für diese Fälle einen ordnungsgemäßen Fallback bereit:

  • Wenn die API für experimentelle Features im Browser des Benutzers nicht verfügbar ist.
  • Wenn das Ursprungstesttoken abläuft.
  • Wenn das Microsoft Edge-Featureteam die Ursprungstestphase beendet.

Weitere Informationen finden Sie unter Implementieren der Featureerkennung bei MDN.

Testen einer Ursprungsstudie bei localhost

Um ein Ursprungstestfeature unter localhostzu testen, wechseln Sie zu edge://flags , und aktivieren Sie das entsprechende Featureflag.

Der Mechanismus, der Microsoft Edge-Ursprungstesttoken erkennt und verwendet, wird nur für SSL-fähige Domänen unterstützt, nicht für localhost.

Erneuern eines Ursprungstesttokens

Ursprungstesttoken laufen standardmäßig in 6 Wochen ab. Wenn das Ursprungstesttoken abläuft, müssen Sie das Token erneuern. Dies bedeutet, dass ein neues Token für diese Ursprungstestversion generiert wird. Sie können das Token verlängern, bevor es abläuft.

So erneuern Sie ein Ursprungstesttoken:

  1. Wechseln Sie zu Microsoft Edge Origin Testversionen.

    Informationen zur Testversion der Ad Selection-API finden Sie stattdessen unter Registrieren für die Anzeigenauswahl-API.

  2. Wählen Sie im Abschnitt Meine registrierten Testversionen eine Ursprungstestversion aus.

  3. Klicken Sie im Abschnitt Registrierungen in einer Tokenzeile, die einen Abgelaufenen Badge enthält, auf die Schaltfläche Verlängern :

    Benutzeroberfläche zum Erneuern eines Tokens

    Ein neues Token wird generiert und angezeigt.

  4. Klicken Sie in der Zeile, die das neue Token enthält, auf die Schaltfläche Kopieren , und fügen Sie dann das neue Token in Ihren Code ein.

Dauer einer Ursprungsstudie

Eine Ursprungstestphase kann bis zum geplanten Ablaufdatum dauern oder vorzeitig enden.

Geplantes Ablaufdatum

Nachdem Sie sich für eine Testversion registriert haben, bleibt Ihr Token bis zum Ablaufdatum der Testversion gültig, das im Karte der Ursprünglichen Testversion angezeigt wird. Nach dem Ablaufdatum der Ursprungstestphase funktioniert das Token nicht mehr, und das Feature, das der Ursprungstestversion zugeordnet ist, wird als versandbereit angesehen, oder das Feature wird für die weitere Entwicklung einbehalten.

Frühes Ende

Ein Microsoft Edge-Featureteam entscheidet sich möglicherweise, ein Experiment vorzeitig vor dem Ablaufdatum der Testversion zu beenden. Zum Beispiel:

  • Wenn ein Sicherheitsvorfall durch das Feature verursacht wird.
  • Wenn das Featureteam genügend Feedback gesammelt hat und zu dem Schluss gelangt ist, dass die derzeit vorgeschlagene API nicht den Anforderungen von Webentwicklern entspricht, und eine wichtige Neugestaltung erforderlich ist.

Wenn ein Experiment frühzeitig beendet wird, sendet das Featureteam, das besitzer der Ursprungstest ist, E-Mails an alle Entwickler, die für das Experiment registriert sind.

Bereitstellen von Feedback zu einer Ursprungstestversion

Bitte geben Sie Feedback zum experimentellen Feature. Die Registerkarte Probleme des GitHub-Repositorys des Features ermöglicht die öffentliche Diskussion über die Benutzerfreundlichkeit und Stabilität des Features.

So geben Sie Feedback zu einer Ursprungstestversion:

  1. Wechseln Sie zu Microsoft Edge Origin Testversionen.

  2. Wählen Sie eine aktive Testversion aus.

  3. Klicken Sie auf die Schaltfläche Feedback . Die Registerkarte Probleme des GitHub-Repositorys des Produkts wird geöffnet.

  4. Zeigen Sie die Probleme an.

  5. Wenn ein neues Problem erforderlich ist, klicken Sie auf die Schaltfläche Neues Problem .

Informationen zur Testversion der Ad Selection-API finden Sie stattdessen unter Bereitstellen von Feedback zur Ursprungstestversion unter Registrieren für die Anzeigenauswahl-API.

Weitere Informationen

Anzeigenauswahl-API:

Äußerlich: