Array push method

  • Enlace amigable (slug) de la revisión: JavaScript/Reference/Global_Objects/Array/push
  • Título de la revisión: Array push method
  • Id de la revisión: 322391
  • Creada:
  • Creador: mhauptma73
  • ¿Es la revisión actual?
  • Comentario

Contenido de la revisión

Resumen

Transforma un array añadiendole los elementos proporcionados y devolviendo la nueva longitud del array.

Métodos de Array
Implementado en JavaScript 1.2
Edición ECMAScript ECMAScript 3rd Edition

Síntaxis

array.push(element1, ..., elementN)

Parámetros

element1, ..., elementN
Los elementos a añadir al final del array.

Devuelve

La nueva propiedad length del objeto sobre el cual se efectuó la llamada.

Descripción

El método push es muy práctico para añadir valores a un array.

push es genérico intencionadamente. Este método puede ser llamado o aplicado a objetos que representen arrays. El método push depende de la propiedad length para decidir donde empezar a insertar los valores dados. Si el valor de la propiedad length no puede ser convertido en numérico, el índice 0 es usado. Esto permite la posibilidad de que la propiedad length sea inexistente, y en este caso length será creado.

Los únicos objetos nativos que se asemejen al array son cadenas de textos, aunque estos no se puedan usar en la aplicación de este método ya que son inmutables.

Ejemplos

Ejemplo: Añadiendo elementos a un array

El siguiente código crea el array deportes que contiene dos elementos, luego añade 2 elementos más. Tras ejecutar el código, deportes contiene 4 elementos: "soccer", "baseball", "football" and "swimming".

var deportes = ["soccer", "baseball"];
deportes.push("football", "swimming");

Ver también

Fuente de la revisión

<h2 id="Summary" name="Summary">Resumen</h2>
<p>Transforma un array añadiendole los elementos proporcionados y devolviendo la nueva longitud del array.</p>
<table class="standard-table">
  <thead>
    <tr>
      <th class="header" colspan="2">Métodos de <a href="/en/JavaScript/Reference/Global_Objects/Array" title="en/JavaScript/Reference/Global_Objects/Array"><code>Array</code></a></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Implementado en</td>
      <td>JavaScript 1.2</td>
    </tr>
    <tr>
      <td>Edición ECMAScript</td>
      <td>ECMAScript 3rd Edition</td>
    </tr>
  </tbody>
</table>
<h2 id="Syntax" name="Syntax">Síntaxis</h2>
<pre class="syntaxbox">
<code><em>array</em>.push(<em>element1</em>, ..., <em>elementN</em>)</code></pre>
<h3 id="Parameters" name="Parameters">Parámetros</h3>
<dl>
  <dt>
    <code>element1, ..., element<em>N</em></code></dt>
  <dd>
    Los elementos a añadir al final del array.</dd>
</dl>
<h2 id="Returns">Devuelve</h2>
<p>La nueva propiedad <code><a href="/en/JavaScript/Reference/Global_Objects/Array/length" title="en/JavaScript/Reference/Global_Objects/Array/length">length</a></code> del objeto sobre el cual se efectuó la llamada.</p>
<h2 id="Description" name="Description">Descripción</h2>
<p>El método <code>push</code> es muy práctico para añadir valores a un array.</p>
<p><code>push</code> es genérico intencionadamente. Este método puede ser <a href="/en/JavaScript/Reference/Global_Objects/Function/call" title="en/JavaScript/Reference/Global_Objects/Function/call">llamado</a> o <a href="/en/JavaScript/Reference/Global_Objects/Function/apply" title="en/JavaScript/Reference/Global_Objects/Function/apply">aplicado</a> a objetos que representen arrays. El método <code>push </code>depende de la propiedad <code>length</code> para decidir donde empezar a insertar los valores dados. Si el valor de la propiedad <code>length</code> no puede ser convertido en numérico, el índice 0 es usado. Esto permite la posibilidad de que la propiedad <code>length</code> sea inexistente, y en este caso <code>length</code> será creado.</p>
<p>Los únicos objetos nativos que se asemejen al array son <a href="/En/Core_JavaScript_1.5_Reference/Global_Objects/String" title="En/Core_JavaScript_1.5_Reference/Global_Objects/String">cadenas de textos</a>, aunque estos no se puedan usar en la aplicación de este método ya que son inmutables.</p>
<h2 id="Examples" name="Examples">Ejemplos</h2>
<h3 id="Example:_Adding_elements_to_an_array" name="Example:_Adding_elements_to_an_array">Ejemplo: Añadiendo elementos a un array</h3>
<p>El siguiente código crea el array <code>deportes</code> que contiene dos elementos, luego añade 2 elementos más. Tras ejecutar el código, <code>deportes</code> contiene 4 elementos: "soccer", "baseball", "football" and "swimming".</p>
<pre class="brush: js">
var deportes = ["soccer", "baseball"];
deportes.push("football", "swimming");
</pre>
<h2 id="See_also" name="See_also">Ver también</h2>
<ul>
  <li><a href="/en/JavaScript/Reference/Global_Objects/Array/pop" title="en/JavaScript/Reference/Global_Objects/Array/pop">pop</a></li>
  <li><a href="/en/JavaScript/Reference/Global_Objects/Array/shift" title="en/JavaScript/Reference/Global_Objects/Array/shift">shift</a></li>
  <li><a href="/en/JavaScript/Reference/Global_Objects/Array/unshift" title="en/JavaScript/Reference/Global_Objects/Array/unshift">unshift</a></li>
  <li><a href="/en/JavaScript/Reference/Global_Objects/Array/concat" title="en/JavaScript/Reference/Global_Objects/Array/concat">concat</a></li>
</ul>
<!--languages({
"fr": "fr/R\u00e9f\u00e9rence_de_JavaScript_1.5_Core/Objets_globaux/Array/push",
})-->
Revertir a esta revisión