Back to Content

HTMLImageElement: attributionSrc property

files/en-us/web/api/htmlimageelement/attributionsrc/index.md

latest1.5 KB
Original Source

{{APIRef("Attribution Reporting API")}}{{securecontext_header}}{{deprecated_header}}

The attributionSrc property of the {{domxref("HTMLImageElement")}} interface that you want the browser to send an {{httpheader("Attribution-Reporting-Eligible")}} header along with the image request. It reflects the `` 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 `` reference.

Examples

Setting an empty attributionSrc

html
js
const imgElem = document.querySelector("img");
imgElem.attributionSrc = "";

Setting an attributionSrc containing URLs

html
js
// 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

{{Specifications}}

Browser compatibility

{{Compat}}

See also