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:

js
firstImage = imageCollection.item(0);

firstImage = imageCollection[0];

Examples

This example looks through the list of images and finds those named "banner.gif".

js
for (const image of document.images) {
  if (image.src === "banner.gif") {
    console.log("Found the banner");
  }
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}