Back to Content

SVGFEImageElement: result property

files/en-us/web/api/svgfeimageelement/result/index.md

latest1.6 KB
Original Source

{{APIRef("SVG")}}

The result read-only property of the {{domxref("SVGFEImageElement")}} interface describes the assigned name of an SVG filter primitive as a {{domxref("SVGAnimatedString")}}.

It reflects the {{SVGAttr("result")}} attribute of the {{SVGElement("feImage")}} element, which fetches image data from an external source and provides the pixel data as output. The attribute value is a {{cssxref("custom-ident")}}. If supplied, then graphics that result from processing this filter primitive can be referenced by an {{SVGAttr("in")}} attribute on a subsequent filter primitive within the same {{SVGElement("filter")}} element.

If no result attribute is defined, the filter's result.baseVal and result.animVal are empty strings, and the output of the <feImage> filter will only be available for re-use as the implicit input into the next filter primitive if that filter primitive provides no value for its in attribute.

Value

An {{domxref("SVGAnimatedString")}}.

Example

js
const feImageElement = document.querySelector("feImage");
const filterName = feImageElement.result;
console.log(filterName.baseVa); // the filter's assigned name

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also