== .getChildren==

.getChildren()

Get a list of the Element’s immediate child elements, optionally filtered by a callback function.

Usage:: [[mdn>Web/JavaScript/Reference/Global_Objects/Array|Array]] = Element''.getChildren''(callback = ''undefined'')
Member of:: [[mdn>Web/API/HTMLElement|HTMLElement]]
Parameters:: callback – a [[mdn>Web/JavaScript/Reference/Global_Objects/Function|Function]] that returns true, if an item should be added (optional ).
Returns:: An [[mdn>Web/JavaScript/Reference/Global_Objects/Array|Array]] of [[mdn>Web/API/HTMLElement|HTMLElement]]s.

Notes:: * This function only returns Element nodes and ignores all other node types (like text, comments, etc.)

===== Examples ===== A simple example could look like this:


document.getElementById('foo')
  .getChildren()
  .forEach( (item) => {
    …
});

By using a filtering function, e.g. to only collect descendants which are ''[[mdn>Web/HTML/Element/a|]]'' elements:


let list = document.getElementById('foo')
  .getChildren( e => e.nodeName == 'A' );

Notes:: * The elements’ ''.nodeName'' property always contains the element name in uppercase letters! * The above example uses an [[mdn>Web/JavaScript/Reference/Functions/Arrow_functions|arrow function expression]] to keep the code lean.