---
title: Document.getElementsByName()
slug: Web/API/Document/getElementsByName
translation_of: Web/API/Document/getElementsByName
---
<div>{{APIRef("DOM")}}</div>

<p>Returns a nodelist collection with a given {{domxref("element.name","name")}} in the (X)HTML document.</p>

<h2 id="Syntax" name="Syntax">Sintaxis</h2>

<pre class="syntaxbox"><em>elements</em> = document.getElementsByName(<em>name</em>)
</pre>

<ul>
 <li><code>elements</code> es una colección existente de {{domxref("NodeList")}}</li>
 <li><code>name</code> es el valor del atributo <code>name</code> del elemento.</li>
</ul>

<h2 id="Example" name="Example">Ejemplo</h2>

<pre class="brush:html">&lt;!DOCTYPE html&gt;
&lt;html lang="en"&gt;
&lt;head&gt;
 ...
&lt;/head&gt;

&lt;body&gt;
&lt;form name="up"&gt;&lt;input type="text"&gt;&lt;/form&gt;
&lt;div name="down"&gt;&lt;input type="text"&gt;&lt;/div&gt;

&lt;script&gt;
var up_forms = document.getElementsByName("up");
console.log(up_forms[0].tagName); // returns "FORM"
&lt;/script&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>

<h2 id="Notes" name="Notes">Notas</h2>

<p>El atributo <a href="/en-US/docs/DOM/element.name"><code>name</code></a> es solamente aplicable al documento (X)HTML. El método retorna una colección existente de {{domxref("NodeList")}} que contiene todos los elementos con el valor dado para el atributo <code>name</code>, tanto {{htmlelement("meta")}} o {{htmlelement("object")}} o en caso que <code>name</code> sea colocado en elementos que no soportan un atributo de atributo del todo.</p>

<p>El método <strong>getElementsByName</strong> trabaja de diferente manera en diferentes navegadires. En IE &lt; 10, el método getElementsByName() tambipen retornará elementos que tienen un atributo <code>id</code> con el valor especificado. Entonces, debería tener cuidado de no usar el mismo string como <code>name</code> y <code>ID</code>.</p>

<h2 id="Specifications" name="Specifications">Especificaciones</h2>

<ul>
 <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/">DOM Level 2 HTML: getElementsByName</a></li>
 <li><a href="http://www.whatwg.org/html/#dom-document-getelementsbyname">HTML5: getElementsByName</a></li>
</ul>

<h2 id="Especificaciones">Especificaciones</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Especificaciones</th>
   <th scope="col">estado</th>
   <th scope="col">Comentario</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', '#dom-document-getelementsbyname', "Document.getElementsByName()")}}</td>
   <td>{{ Spec2('HTML WHATWG') }}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName("DOM2 HTML", "html.html#ID-71555259", "Document.getElementsByName()")}}</td>
   <td>{{Spec2("DOM2 HTML")}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="See_also" name="See_also">Mira también</h2>

<ul>
 <li>{{domxref("document.getElementById()")}} para retornar una referencia de un elemento por su <code>id</code></li>
 <li>{{domxref("document.getElementsByTagName()")}} para retornar referencias de elementos por el nombre de sus etiquetas</li>
 <li>{{domxref("document.querySelector()")}} for powerful selectors via queries like <code>'div.myclass'</code></li>
</ul>