XMLHttpRequest: метод setAttributionReporting()

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.

Экспериментально: Это экспериментальная технология. Подробнее
Тщательно проверьте таблицу совместимости браузеров таблицу совместимости браузеров перед использованием в производстве.

Метод setAttributionReporting() интерфейса XMLHttpRequest указывает, что вы хотите, чтобы ответ запроса мог зарегистрировать JavaScript-базированный источник атрибуции или триггер атрибуции.

См. API отслеживания атрибуции для получения дополнительной информации.

Синтаксис

setAttributionReporting(options)

Параметры

options

Объект, предоставляющий параметры отслеживания атрибуции, включающий следующие свойства:

eventSourceEligible: Логическое значение. Если установлено в true, ответ запроса может зарегистрировать источник атрибуции. Если установлено в false, этого не происходит.
triggerEligible: Логическое значение. Если установлено в true, ответ запроса может зарегистрировать триггер атрибуции. Если установлено в false, этого не происходит.

Возвращаемое значение

Ничего (undefined).

Исключения

InvalidStateError DOMException: Выбрасывается, если связанный XMLHttpRequest еще не был открыт или уже был отправлен.
TypeError DOMException: Выбрасывается, если использование API отслеживания атрибуции заблокировано attribution-reporting Permissions-Policy.

Примеры

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);

Спецификации

Спецификация
Отслеживание атрибуции # dom-xmlhttprequest-setattributionreporting

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`setAttributionReporting`	125	125	Нет	111	Нет	125	Нет	83	Нет	27.0	125

См. также

API отслеживания атрибуции

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/setAttributionReporting