The images
read-only property of the Document
interface returns a collection of the images in the current HTML document.
The images
read-only property of the Document
interface returns a collection of the images in the current HTML document.
An HTMLCollection
providing a live list of all of the images contained in the current document. Each entry in the collection is an HTMLImageElement
representing a single image element.
You can use either JavaScript array notation or the 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];
This example looks through the list of images and finds one whose name is "banner.gif"
.
js
for (const image of document.images) { if (image.src === "banner.gif") { console.log("Found the banner"); } }
Specification |
---|
HTML Standard # dom-document-images-dev |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
images |
1 | 12 | 1 | 4 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/images