HTMLFormControlsCollection.namedItem()

In This Article

The HTMLFormControlsCollection.namedItem() method returns the RadioNodeList or the Element in the collection whose name or id match the specified name, or null if no node matches.

Note that this version of namedItem() hides the one inherited from HTMLCollection. Like that one, in JavaScript, using the array bracket syntax with a String, like collection["value"] is equivalent to collection.namedItem("value").

Syntax

var item = collection.namedItem(str);
var item = collection[str];

Parameters

str is a DOMString

Return value

item is a RadioNodeList or an Element.

Examples

<form>
  <input id="myFormControl" type="textarea"/>
</form>

elem1 = document.forms[0]["myFormControl"]; // Returns the HTMLInputElement representing #myFormControl

Specifications

Specification	Status	Comment
WHATWG HTML Living Standard The definition of 'HTMLFormControlsCollection' in that specification.	Living Standard	No change since the last snapshot, HTML5.
HTML5 The definition of 'HTMLFormControlsCollection' in that specification.	Recommendation	In this snapshot of WHATWG HTML Living Standard, the `HTMLFormControlsCollections` is defined for the first time.

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	(Yes)	27 (27) [1]	No support	(Yes)	?

Feature	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Basic support	(Yes)	27.0 (27) [1]	No support	(Yes)	?

[1] Until Firefox 32 included, the eventual RadioNodeList returned by namedItem was a NodeList.

Document Tags and Contributors

Tags:

Last updated by: rvighne, Oct 7, 2016, 9:56:11 PM