toString

  • Enlace amigable (slug) de la revisión: Referencia_de_JavaScript_1.5/Objetos_globales/Object/toString
  • Título de la revisión: toString
  • Id de la revisión: 181286
  • Creada:
  • Creador: Talisker
  • ¿Es la revisión actual? No
  • Comentario /* Descripción */

Contenido de la revisión

Resumen

Devuelve una cadena que representa al objeto.

Método de Object
Implementado en: JavaScript 1.0
Versión ECMA: ECMA-262

Sintaxis

toString()

Descripción

Todos los objetos tienen un método toString que se llama automáticamente cuando el objeto se representa como un valor de texto o cuando un objeto se referencia de tal manera que se espera una cadena. Por defecto, el método toString es heredado por todos los objetos que descienden de Object. Si este método no se sobreescribe en el objeto personalizado, toString devuelve {{mediawiki.external('object <i>type</i>')}}, donde type es el tipo de objeto. El siguiente código ilustra esto:

var objeto = new Object();
objeto.toString(); // Devuelve [object Object]

Métodos Built-in de toString

Cada objeto del núcleo de JavaScript tiene su propio y único método toString que devuelve el valor apropiado cuando JavaScript necesita convertir ese objeto en una cadena. Estos incluyen: {{wiki.template(':es/ToString')}}

Examples

Sobreescribir el método por defecto toString

Puede crear una función que sea llamada en lugar del método predeterminado toString. El método toString no toma argumentos y debería devolver una cadena. El método toString que cree puede ser cualquier valor que quiera, pero será más útil si aporta información sobre el objeto.

El siguiente código define el tipo de objeto Perro y crea elPerro, un objeto de tipo Perro:

function Perro(nombre,criadero,color,sexo) {
   this.nombre=nombre
   this.criadero=criader
   this.color=color
   this.sexo=sexo
}

elPerro = new Perro("Gabby","Laboratorio","chocolate","femenino")

Si llama al método toString en el objeto personalizado, devuelve el valor predeterminado heredado de Object:

elPerro.toString() //devuelve [object Object]

El siguiente código crea y asigna perroToString para sobreescribir el método predeterminado toString. Esta función genera una cadena que contiene nombre, criader, color, and sexo del objeto, en la forma "propiedad = valor;".

Perro.prototype.toString = function perroToString() {
  var retorno = "Perro " + this.name + " es " + this.sex + " " + this.color + " " + this.breed;
  return retorno;
}

Con el código precedente en su lugar, cualquier vez que se use elDog en un contexto de una cadena, JavaScript automáticamente llamará a la función perroToString, la cuál devuelve la siguiente cadena:

Perro Gabby es femenino chocolate Laboratorio

Vea También

toSource, valueOf

{{ wiki.languages( { "fr": "fr/R\u00e9f\u00e9rence_de_JavaScript_1.5_Core/Objets_globaux/Object/toString", "ja": "ja/Core_JavaScript_1.5_Reference/Global_Objects/Object/toString", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/Object/toString" } ) }}

Fuente de la revisión

<p>
</p>
<h3 name="Resumen"> Resumen </h3>
<p>Devuelve una cadena que representa al objeto.
</p>
<table class="fullwidth-table">
<tbody><tr>
<td class="header" colspan="2">Método de <a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/Object">Object</a></td>
</tr>
<tr>
<td>Implementado en:</td>
<td>JavaScript 1.0</td>
</tr>
<tr>
<td>Versión ECMA:</td>
<td>ECMA-262</td>
</tr>
</tbody></table>
<h3 name="Sintaxis"> Sintaxis </h3>
<p><code>
toString()
</code>
</p>
<h3 name="Descripci.C3.B3n"> Descripción </h3>
<p>Todos los objetos tienen un método <code>toString</code> que se llama automáticamente cuando el objeto se representa como un valor de texto o cuando un objeto se referencia de tal manera que se espera una cadena. Por defecto, el método <code>toString</code> es heredado por todos los objetos que descienden de <code>Object</code>. Si este método no se sobreescribe en el objeto personalizado, <code>toString</code> devuelve <code>{{mediawiki.external('object &lt;i&gt;type&lt;/i&gt;')}}</code>, donde <code><i>type</i></code> es el tipo de objeto. El siguiente código ilustra esto:
</p>
<pre>var objeto = new Object();
objeto.toString(); // Devuelve [object Object]
</pre>
<h4 name="M.C3.A9todos_Built-in_de_toString"> Métodos Built-in de <code>toString</code> </h4>
<p>Cada objeto del núcleo de JavaScript tiene su propio y único método <code>toString</code> que devuelve el valor apropiado cuando JavaScript necesita convertir ese objeto en una cadena. Estos incluyen: {{wiki.template(':es/ToString')}}
</p>
<h3 name="Examples"> Examples </h3>
<h4 name="Sobreescribir_el_m.C3.A9todo_por_defecto_toString"> Sobreescribir el método por defecto <code>toString</code> </h4>
<p>Puede crear una función que sea llamada en lugar del método predeterminado <code>toString</code>. El método <code>toString</code> no toma argumentos y debería devolver una cadena. El método <code>toString</code> que cree puede ser cualquier valor que quiera, pero será más útil si aporta información sobre el objeto.
</p><p>El siguiente código define el tipo de objeto <code>Perro</code> y crea <code>elPerro</code>, un objeto de tipo <code>Perro</code>:
</p>
<pre>function Perro(nombre,criadero,color,sexo) {
   this.nombre=nombre
   this.criadero=criader
   this.color=color
   this.sexo=sexo
}

elPerro = new Perro("Gabby","Laboratorio","chocolate","femenino")
</pre>
<p>Si llama al método <code>toString</code> en el objeto personalizado, devuelve el valor predeterminado heredado de <code>Object</code>:
</p>
<pre>elPerro.toString() //devuelve [object Object]
</pre>
<p>El siguiente código crea y asigna <code>perroToString</code> para sobreescribir el método predeterminado <code>toString</code>. Esta función genera una cadena que contiene nombre, criader, color, and sexo del objeto, en la forma "<code>propiedad = valor;</code>".
</p>
<pre>Perro.prototype.toString = function perroToString() {
  var retorno = "Perro " + this.name + " es " + this.sex + " " + this.color + " " + this.breed;
  return retorno;
}
</pre>
<p>Con el código precedente en su lugar, cualquier vez que se use <code>elDog</code> en un contexto de una cadena, JavaScript automáticamente llamará a la función <code>perroToString</code>, la cuál devuelve la siguiente cadena:
</p>
<pre>Perro Gabby es femenino chocolate Laboratorio
</pre>
<h3 name="Vea_Tambi.C3.A9n"> Vea También </h3>
<p><a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/Object/toSource">toSource</a>,
<a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/Object/valueOf">valueOf</a>
</p>
<div class="noinclude">
</div>
{{ wiki.languages( { "fr": "fr/R\u00e9f\u00e9rence_de_JavaScript_1.5_Core/Objets_globaux/Object/toString", "ja": "ja/Core_JavaScript_1.5_Reference/Global_Objects/Object/toString", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/Object/toString" } ) }}
Revertir a esta revisión