Use-As-Dictionary

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Der HTTP Use-As-Dictionary Antwort-Header listet die Übereinstimmungskriterien auf, nach denen das Kompressionswörterbuch-Transport Wörterbuch für zukünftige Anfragen verwendet werden kann.

Weitere Informationen finden Sie im Leitfaden zum Kompressionswörterbuch-Transport.

Syntax

http

Use-As-Dictionary: match="<urlpattern>"
Use-As-Dictionary: match-dest=("<destination1>" "<destination2>", …)
Use-As-Dictionary: id="<string-identifier>"
Use-As-Dictionary: type="raw"

// Multiple, in any order
Content-Encoding: match="<urlpattern>", match-dest=("<destination1>")

Direktiven

match: Ein Zeichenfolgenwert, der ein URL-Muster enthält: Nur Ressourcen, deren URLs diesem Muster entsprechen, dürfen diese Ressource als Wörterbuch verwenden.
match-dest: Eine durch Leerzeichen getrennte Liste von Zeichenfolgen, wobei jede Zeichenfolge in Anführungszeichen steht und der gesamte Wert in Klammern eingeschlossen ist. Diese Liste gibt die Fetch-Anfrageziele an, die Anfragen erfüllen müssen, um dieses Wörterbuch zu verwenden.
id: Ein Zeichenfolgenwert, der eine Serverkennung für das Wörterbuch spezifiziert. Dieser ID-Wert wird dann im Dictionary-ID Anfrage-Header hinzugefügt, wenn der Browser eine Ressource anfordert, die dieses Wörterbuch verwenden kann.
type: Ein Zeichenfolgenwert, der das Dateiformat des bereitgestellten Wörterbuchs beschreibt. Derzeit wird nur raw unterstützt (was der Standard ist), dies dient daher mehr zur zukünftigen Kompatibilität.

Beispiele

Pfad-Präfix

http

Use-As-Dictionary: match="/product/*"

Dies besagt, dass das Wörterbuch nur für URLs verwendet werden soll, die mit /product/ beginnen.

Versionierte Verzeichnisse

http

Use-As-Dictionary: match="/app/*/main.js"

Dies verwendet ein Platzhalterzeichen, um mehrere Versionen einer Datei zu erfassen.

Ziele

http

Use-As-Dictionary: match="/product/*", match-dest=("document")

Dies verwendet match-dest, um sicherzustellen, dass das Wörterbuch nur für document-Anfragen verwendet wird, sodass <script src="/product/js/app.js"> Ressourcenanforderungen zum Beispiel nicht übereinstimmen würden.

http

Use-As-Dictionary: match="/product/*", match-dest=("document" "frame")

Dies würde es ermöglichen, dass das Wörterbuch sowohl mit obersten Dokumenten als auch mit iframes übereinstimmt.

Id

http

Use-As-Dictionary: match="/product/*", id="dictionary-12345"

Wenn Use-As-Dictionary eine id Direktive enthält, wie in diesem Beispiel, wird der id Wert im Dictionary-ID Anfrage-Header für Ressourcen enthalten, die dieses Wörterbuch verwenden können. Die Ressourcenanfrage wird auch den SHA-256-Hash des Wörterbuchs, umgeben von Doppelpunkten, im Available-Dictionary Header enthalten:

http

Accept-Encoding: gzip, br, zstd, dcb, dcz
Available-Dictionary: :pZGm1Av0IEBKARczz7exkNYsZb8LzaMrV7J32a2fFG4=:
Dictionary-ID: "dictionary-12345"

Der Server muss immer noch den Hash aus dem Available-Dictionary Header überprüfen — die Dictionary-ID ist zusätzliche Information für den Server, um das Wörterbuch zu identifizieren, ersetzt aber nicht die Notwendigkeit für den Available-Dictionary Header.

Typ

http

Use-As-Dictionary: match="/product/*", type="raw"

Derzeit wird nur raw unterstützt (was der Standard ist), daher dient dies mehr zur zukünftigen Kompatibilität.

Spezifikationen

Specification
Compression Dictionary Transport # name-use-as-dictionary