files/en-us/web/api/document/images/index.md
{{APIRef("DOM")}}
The images read-only property of the {{domxref("Document")}} interface returns a collection of the images in the current HTML document.
An {{domxref("HTMLCollection")}} providing a live list of all of the images contained in the current document. Each entry in the collection is an {{domxref("HTMLImageElement")}} representing a single image element.
You can use either JavaScript array notation or the {{domxref("HTMLCollection.item", "item()")}} method on the returned collection to access the items in the collection. The following are equivalent:
firstImage = imageCollection.item(0);
firstImage = imageCollection[0];
This example looks through the list of images and finds those named "banner.gif".
for (const image of document.images) {
if (image.src === "banner.gif") {
console.log("Found the banner");
}
}
{{Specifications}}
{{Compat}}