CARVIEW |
Select Language
HTTP/2 200
content-type: text/html
x-guploader-uploadid: AAwnv3KALAo5WcyI3uMf-0VvnxDLUglQZ0yYqQSTPbq36f9O0ALnht6awbq4lgDhl0i641JZ
cache-control: public, max-age=3600
expires: Mon, 13 Oct 2025 00:51:28 GMT
last-modified: Fri, 10 Oct 2025 01:05:19 GMT
etag: W/"6c7286ef300129c5f6f5f44acb7737c1"
x-goog-generation: 1760058319036549
x-goog-metageneration: 1
x-goog-stored-content-encoding: identity
x-goog-stored-content-length: 145481
x-goog-meta-goog-reserved-file-mtime: 1760056839
x-goog-hash: crc32c=jpVyAg==, md5=bHKG7zABKcX29fRKy3c3wQ==
x-goog-storage-class: STANDARD
accept-ranges: none
alt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
alt-svc: clear
referrer-policy: strict-origin-when-cross-origin
x-content-type-options: nosniff
strict-transport-security: max-age=63072000
content-security-policy: default-src 'self'; script-src 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; script-src-elem 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; style-src 'report-sample' 'self' 'unsafe-inline'; object-src 'none'; base-uri 'self'; connect-src 'self' developer.allizom.org bcd.developer.allizom.org bcd.developer.mozilla.org updates.developer.allizom.org updates.developer.mozilla.org https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com https://incoming.telemetry.mozilla.org https://observatory-api.mdn.allizom.net https://observatory-api.mdn.mozilla.net https://api.github.com/search/issues stats.g.doubleclick.net https://api.stripe.com; font-src 'self'; frame-src 'self' interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net mdn.github.io live-samples.mdn.mozilla.net live-samples.mdn.allizom.net *.mdnplay.dev *.mdnyalp.dev *.play.test.mdn.allizom.net https://v2.scrimba.com https://scrimba.com jsfiddle.net www.youtube-nocookie.com codepen.io survey.alchemer.com https://js.stripe.com; img-src 'self' data: *.githubusercontent.com *.googleusercontent.com *.gravatar.com mozillausercontent.com firefoxusercontent.com profile.stage.mozaws.net profile.accounts.firefox.com developer.mozilla.org mdn.dev interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net wikipedia.org upload.wikimedia.org https://mdn.github.io/shared-assets/ https://mdn.dev/ https://*.google-analytics.com https://*.googletagmanager.com www.gstatic.com; manifest-src 'self'; media-src 'self' archive.org videos.cdn.mozilla.net https://mdn.github.io/shared-assets/; child-src 'self'; worker-src 'self';
x-frame-options: DENY
origin-trial: AxVILwizhbMjxFeHOn1P3R8niO1RJY/smaK4B4d1rLzc1gTaxtXMSaTi+FoigYgCw40uFRDwFcEAeqDR+vVLOW4AAABfeyJvcmlnaW4iOiJodHRwczovL2RldmVsb3Blci5tb3ppbGxhLm9yZyIsImZlYXR1cmUiOiJQcml2YXRlQXR0cmlidXRpb25WMiIsImV4cGlyeSI6MTc0MjA3OTYwMH0=
x-cloud-trace-context: 22d15e5f10889bbd93f594bde3914b71
date: Sun, 12 Oct 2025 23:51:28 GMT
server: Google Frontend
via: 1.1 google
vary: Accept-Encoding
content-encoding: gzip
x-cache: miss
HTMLFormControlsCollection: namedItem() method - Web APIs | MDN
Toggle sidebar
>
HTMLFormControlsCollection: namedItem() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
js
namedItem(name)
[name]
Parameters
name
-
A string which will be used to match against the
name
orid
attributes of the controls in thisHTMLFormControlsCollection
object.
Return value
- A
RadioNodeList
,Element
, ornull
.
Examples
>Using namedItem()
HTML
html
<form>
<label for="notes">Notes:</label>
<input id="notes" name="my-form-control" type="text" />
<label for="start">Start date:</label>
<input id="start" name="my-form-control" type="date" />
</form>
<div id="output"></div>
div {
margin: 1rem 0;
}
JavaScript
js
const form = document.querySelector("form");
const items = form.elements.namedItem("my-form-control");
const output = document.querySelector("#output");
const itemIDs = Array.from(items)
.map((item) => `"${item.id}"`)
.join(", ");
output.textContent = `My items: ${itemIDs}`;
Result
Specifications
Specification |
---|
HTML> # dom-htmlformcontrolscollection-nameditem-dev> |
Browser compatibility
Loading…
See also
HTMLCollection.namedItem
that it replaces