Document: images property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}
The **images** read-only property of the {{domxref("Document")}} interface returns a collection of the images in the current HTML document.
Value
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.
Usage notes
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];Examples
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
{{Specifications}}
Browser compatibility
{{Compat}}