The images
read-only property of the Document
interface returns a collection of the images in the current HTML document.
Syntax
var imageCollection = document.images;
Value
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.
Usage notes
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:
firstImage = imageCollection.item(0); firstImage = imageCollection[0];
Example
This example looks through the list of images and finds one whose name is "banner.gif"
.
var ilist = document.images; for(var i = 0; i < ilist.length; i++) { if(ilist[i].src == 'banner.gif') { // found the banner } }
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'Document.images' in that specification. |
Living Standard | |
Document Object Model (DOM) Level 2 HTML Specification The definition of 'Document.images' in that specification. |
Obsolete | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
images | Chrome Full support 1 | Edge Full support 12 | Firefox Full support Yes | IE ? | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support Yes | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown