Experimentell: Dies ist eine experimentelle Technologie
Ãberprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die selectURL()
-Methode der WindowSharedStorage
-Schnittstelle führt eine URL-Auswahloperation aus, die in einem Modul registriert ist, das zum aktuellen Ursprung des SharedStorageWorklet
hinzugefügt wurde.
Hinweis: Das URL-Ausgabeauswahl-Gate wird verwendet, um eine URL aus einer bereitgestellten Liste auszuwählen, die dem Benutzer basierend auf gemeinsam genutzten Speicherdaten angezeigt werden soll.
SyntaxselectURL(name, urls)
selectURL(name, urls, options)
Parameter
name
Ein String, der den Namen der registrierten Operation innerhalb des Shared Storage Worklet-Moduls darstellt. Er muss mit dem Namen übereinstimmen, der der Operation gegeben wurde, als sie mit SharedStorageWorkletGlobalScope.register()
registriert wurde.
urls
Ein Array von Objekten, das die URLs darstellt, zwischen denen die URL-Auswahloperation wählen soll. Jedes Objekt enthält zwei Eigenschaften:
url
Ein String, der die URL darstellt.
reportingMetadata
Optional
Ein Objekt, das Eigenschaften enthält, bei denen die Namen Ereignistypen und die Werte URLs sind, die auf Berichtsziele verweisen, zum Beispiel "click" : "my-reports/report1.html"
. Die URLs fungieren als Ziele für Berichte, die mit einem Ziel vom Typ "shared-storage-select-url"
eingereicht werden, typischerweise eingereicht über einen Aufruf der Methode Fence.reportEvent()
oder Fence.setReportEventDataForAutomaticBeacons()
.
options
Optional
Ein Optionsobjekt, das die folgenden Eigenschaften enthalten kann:
data
Optional
Ein Objekt, das alle Daten darstellt, die zum Ausführen der Operation benötigt werden.
keepAlive
Optional
Ein boolescher Wert. Wenn auf true
gesetzt, wird der SharedStorageWorkletGlobalScope
des zugehörigen Worklets aufrechterhalten, und die Operation kann erneut ausgeführt werden. Daher müssen Sie keepAlive
für jede Operation auf true
setzen, die nicht die letzte sein soll. Der Standardwert false
bedeutet, dass der SharedStorageWorkletGlobalScope
nach der Ausführung der Operation beendet wird und nicht erneut ausgeführt werden kann.
resolveToConfig
Optional
Ein boolescher Wert. Wenn auf true
gesetzt, wird der Erfüllungswert des von run()
zurückgegebenen Promise
ein FencedFrameConfig
-Objekt sein, das verwendet werden kann, um Inhalte in einen <fencedframe>
über sein config
-Attribut zu laden. Der Standardwert false
bedeutet, dass der Erfüllungswert eine URL sein wird, mit der Inhalte in ein <iframe>
geladen werden können.
Ein Promise
, das entweder mit einem FencedFrameConfig
-Objekt oder einem String, der eine URL darstellt, erfüllt wird, abhängig vom Wert der resolveToConfig
-Option.
TypeError
Wird ausgelöst, wenn:
addModule()
hinzugefügt wurde.urls
leer ist oder die maximal zulässige Länge überschreitet (wird von Browser zu Browser unterschiedlich gehandhabt).url
-Eigenschaft eines Objekts eine ungültige URL enthält.// Randomly assigns a user to a group 0 or 1
function getExperimentGroup() {
return Math.round(Math.random());
}
async function injectContent() {
// Add the module to the shared storage worklet
await window.sharedStorage.worklet.addModule("ab-testing-worklet.js");
// Assign user to a random group (0 or 1) and store it in shared storage
window.sharedStorage.set("ab-testing-group", getExperimentGroup(), {
ignoreIfPresent: true,
});
// Run the URL selection operation
const fencedFrameConfig = await window.sharedStorage.selectURL(
"ab-testing",
[
{ url: `https://your-server.example/content/default-content.html` },
{ url: `https://your-server.example/content/experiment-content-a.html` },
],
{
resolveToConfig: true,
},
);
// Render the chosen URL into a fenced frame
document.getElementById("content-slot").config = fencedFrameConfig;
}
injectContent();
Siehe die Shared Storage API-Hauptseite für eine Schritt-für-Schritt-Anleitung zu diesem Beispiel und Links zu weiteren Beispielen.
Spezifikationen Browser-Kompatibilität Siehe auchRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4