HTMLCollection : Object

A list of Elements similar to an NodeList. The Element.children property returns an HTMLCollection.

Instance Indexers

this[index : Number] : Element readonly

Returns the item at index in the collection.

Example:

<div id='parent'>
  Some text
  <span>A span</span>
  <button>A button</button>
</div>
<script>
  var parent = document.getElementById('parent');

  console.log('children:');
  for (var i = 0; i < parent.children.length; i++) {
    console.log('  ' + parent.children[i].nodeName);
  }
</script>

Run

Results:

Instance Properties

length : Number readonly

The number of Elements in the list.

Example:

<div id='parent'>
  Some text
  <span>A span</span>
  <button>A button</button>
</div>
<script>
  var parent = document.getElementById('parent');

  console.log('children:');
  for (var i = 0; i < parent.children.length; i++) {
    console.log('  ' + parent.children[i].nodeName);
  }
</script>

Run

Results:

Spec

Instance Methods

item(index : Number) : Element

Same as this[index].

Spec

namedItem(idOrName : String) : Element

Returns the Element in the this that has id or name equal to idOrName.

Example:

<div id='parent'>
  Some text
  <span id='foo'>A span</span>
  <input name='bar'>
</div>
<script>
  var parent = document.getElementById('parent');

  console.log(parent.children.namedItem('foo').tagName);
  console.log(parent.children.namedItem('bar').tagName);
</script>

Run

Results:

Spec

home license contribute feedback toggle light/dark mode