XMLHttpRequest: Methode setAttributionReporting()
Deprecated
To be removed
This feature is pending removal from browsers. Using it now may lead to broken functionality in future updates. Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the attribution reporting API.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die Methode setAttributionReporting() des Interfaces XMLHttpRequest gibt an, dass die Antwort auf die Anfrage eine JavaScript-basierte Attributionsquelle oder einen Attributionstrigger registrieren können soll.
Weitere Informationen finden Sie unter Attribution Reporting API.
Syntax
setAttributionReporting(options)
Parameter
options-
Ein Objekt mit Optionen für das Attribution Reporting, das die folgenden Eigenschaften enthält:
eventSourceEligible-
Ein boolescher Wert. Wenn er auf
truegesetzt ist, kann die Antwort auf die Anfrage eine Attributionsquelle registrieren. Beifalseist dies nicht möglich. triggerEligible-
Ein boolescher Wert. Wenn er auf
truegesetzt ist, kann die Antwort auf die Anfrage einen Attributionstrigger registrieren. Beifalseist dies nicht möglich.
Rückgabewert
Keiner (undefined).
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn die zugehörige
XMLHttpRequestnoch nicht geöffnet oder bereits gesendet wurde. TypeError-
Wird ausgelöst, wenn die Verwendung der Attribution Reporting API durch eine
attribution-reporting-Permissions-Policyblockiert wird.
Beispiele
const attributionReporting = {
eventSourceEligible: true,
triggerEligible: false,
};
function triggerSourceInteraction() {
const req = new XMLHttpRequest();
req.open("GET", "https://shop.example/endpoint");
// Check availability of setAttributionReporting() before calling
if (typeof req.setAttributionReporting === "function") {
req.setAttributionReporting(attributionReporting);
req.send();
} else {
throw new Error("Attribution reporting not available");
// Include recovery code here as appropriate
}
}
// Associate the interaction trigger with whatever
// element and event makes sense for your code
elem.addEventListener("click", triggerSourceInteraction);