HTMLImageElement: attributionSrc property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The attributionSrc
property of the HTMLImageElement
interface that you want the browser to send an Attribution-Reporting-Eligible
header along with the image request. It reflects the <img>
element's attributionsrc
content attribute.
See the Attribution Reporting API for more details.
Value
A string that is either empty or a space-separated list of URLs. For the interpretation of this attribute, see the HTML <img>
reference.
Examples
>Setting an empty attributionSrc
<img src="advertising-image.png" />
const imgElem = document.querySelector("img");
imgElem.attributionSrc = "";
Setting an attributionSrc containing URLs
<img src="advertising-image.png" />
// encode the URLs in case they contain special characters
// such as '=' that would be improperly parsed.
const encodedUrlA = encodeURIComponent("https://a.example/register-source");
const encodedUrlB = encodeURIComponent("https://b.example/register-source");
const imgElem = document.querySelector("img");
imgElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;
Specifications
Specification |
---|
Attribution Reporting> # dom-htmlattributionsrcelementutils-attributionsrc> |
Browser compatibility
Loading…