XMLHttpRequest: setAttributionReporting()-Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die setAttributionReporting()-Methode der
XMLHttpRequest-Schnittstelle gibt an, dass Sie möchten, dass die Antwort der Anfrage in der Lage ist, eine JavaScript-basierte Attributionsquelle oder einen Attribution-Trigger zu registrieren.
Weitere Details finden Sie in der Attribution Reporting API.
Syntax
setAttributionReporting(options)
Parameter
options-
Ein Objekt, das Optionen für das Attributionsreporting bereitstellt und die folgenden Eigenschaften umfasst:
eventSourceEligible-
Ein boolean. Wenn auf
truegesetzt, ist die Antwort der Anfrage berechtigt, eine Attributionsquelle zu registrieren. Wenn auffalsegesetzt, ist sie es nicht. triggerEligible-
Ein boolean. Wenn auf
truegesetzt, ist die Antwort der Anfrage berechtigt, einen Attribution-Trigger zu registrieren. Wenn auffalsegesetzt, ist sie es nicht.
Rückgabewert
Keiner (undefined).
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn das zugeordnete
XMLHttpRequestnoch nicht geöffnet oder bereits gesendet wurde. TypeErrorDOMException-
Wird ausgelöst, wenn die Nutzung der Attribution Reporting API durch eine
attribution-reportingimPermissions-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);
Spezifikationen
| Specification |
|---|
| Attribution Reporting # dom-xmlhttprequest-setattributionreporting |
Browser-Kompatibilität
Loading…