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.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Die setAttributionReporting()-Methode des XMLHttpRequest-Interfaces zeigt an, dass Sie möchten, dass die Antwort der Anfrage in der Lage ist, eine JavaScript-basierte Attributionsquelle oder einen Attributionstrigger zu registrieren.
Weitere Details finden Sie in der Attribution Reporting API.
Syntax
setAttributionReporting(options)
Parameter
options-
Ein Objekt, das Optionen zur Attributionsberichterstattung bereitstellt und die folgenden Eigenschaften enthält:
eventSourceEligible-
Ein boolescher Wert. Wenn auf
truegesetzt, ist die Antwort der Anfrage berechtigt, eine Attributionsquelle zu registrieren. Wenn auffalsegesetzt, ist sie es nicht. triggerEligible-
Ein boolescher Wert. Wenn auf
truegesetzt, ist die Antwort der Anfrage berechtigt, einen Attributionstrigger zu registrieren. Wenn auffalsegesetzt, ist sie es nicht.
Rückgabewert
Keiner (undefined).
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn das zugehörige
XMLHttpRequestnoch nicht geöffnet wurde oder bereits gesendet wurde. TypeErrorDOMException-
Wird ausgelöst, wenn die Verwendung der Attribution Reporting API durch eine
attribution-reportingPermissions-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 |