---
title: Object.prototype.toString()
slug: Web/JavaScript/Referencje/Obiekty/Object/toString
tags:
  - JavaScript
  - Method
  - Object
  - Prototype
translation_of: Web/JavaScript/Reference/Global_Objects/Object/toString
---
<p>{{JSRef}}</p>

<h2 id="Podsumowanie" name="Podsumowanie">Podsumowanie</h2>

<p>Zwraca łańcuch znaków reprezentujący dany obiekt.</p>

<h2 id="Sk.C5.82adnia" name="Sk.C5.82adnia">Składnia</h2>

<pre class="syntaxbox"><code><var>obj</var>.toString()</code></pre>

<h2 id="Opis" name="Opis">Opis</h2>

<p>Każdy obiekt posiada metodę <code>toString</code>, która jest wywoływana automatycznie, kiedy obiekt ma zostać przedstawiony jako wartość tekstowa, albo kiedy obiekt jest dołączany do ciągu znakowego. Poniższe przykłady wymagają, by <code>jakisPies</code> był reprezentowany jako łańcuch znaków:</p>

<pre class="brush: js">console.log(jakisPies);
console.log("jakisPies to " + jakisPies);
</pre>

<p>Domyślnie metoda <code>toString</code> jest dziedziczona przez każdy obiekt wyprowadzony z obiektu <code>Object</code>. Można przesłonić tę metodę dla własnych obiektów. Jeśli <code>toString</code> nie zostanie przesłonięta we własnych obiektach użytkownika, zwróci ona <code>[object
 <i>typ</i>
 ]</code>, gdzie <code>
 <i>typ</i>
 </code> jest typem obiektu lub nazwą funkcji konstruktora, która utworzyła ten obiekt.</p>

<p>Na przykład:</p>

<pre class="brush: js">var o = new Object()
o.toString() // zwraca "[object Object]"
</pre>

<h2 id="Przyk.C5.82ady" name="Przyk.C5.82ady">Przykłady</h2>

<h3 id="Przes.C5.82anianie_domy.C5.9Blnej_metody_toString" name="Przes.C5.82anianie_domy.C5.9Blnej_metody_toString">Przesłanianie domyślnej metody <code>toString()</code></h3>

<p>Można utworzyć funkcję, która będzie wywoływana zamiast domyślnej metody <code>toString()</code>. Metoda <code>toString()</code> nie pobiera żadnych argumentów i powinna zwrócić łańcuch znaków. Utworzona przez użytkownika metoda <code>toString()</code> może zwracać dowolną wartość, ale najlepiej, by przekazywała użyteczne informacje na temat obiektu.</p>

<p>Poniższy kod definiuje typ obiektowy <code>Pies</code> i tworzy obiekt <code>jakisPies</code> typu <code>Pies</code>:</p>

<pre class="brush: js">function Pies(nazwa,rasa,wiek,plec) {
   this.nazwa=nazwa;
   this.rasa=rasa;
   this.wiek=wiek;
   this.plec=plec;
}

jakisPies = new Pies("Szarik","owczarek niemiecki","5","samiec");</pre>

<p>Jeśli wywołana zostanie metoda <code>toString</code> tego obiektu, zwrócona zostanie domyślna wartość odziedziczona po <code>Object</code>:</p>

<pre class="brush: js">jakisPies.toString(); // zwraca [object Object]
</pre>

<p>Poniższy kod tworzy funkcję <code>piesToString</code>, która to funkcja będzie przesłaniać domyślną metodę <code>toString</code>. Funkcja ta tworzy łańcuch znaków zawierający każdą własność; budowany łańcuch będzie postaci "<code>własność = wartość;</code>".</p>

<pre class="brush: js">function piesToString() {
   var ret = "Pies " + this.nazwa + " to: [\n";
   for (var prop in this)
      ret += " " + prop + " = " + this[prop] + ";\n";
   return ret + "]";
}
</pre>

<p>Poniższy kod przypisuje zdefiniowaną powyżej funkcję do metody <code>toString</code> obiektów typu obiektowego Pies:</p>

<pre class="brush: js">Pies.prototype.toString = piesToString;
</pre>

<p>Dzięki powyższemu kodowi za każdym razem, kiedy <code>jakisPies</code> używany jest w kontekście łańcucha znaków, interpreter JavaScriptu automatycznie wywołuje funkcję <code>piesToString</code>, która zwraca poniższy łańcuch:</p>

<pre>Pies Szarik to: [
  nazwa = Szarik;
  rasa = owczarek niemiecki;
  wiek = 5;
  plec = samiec;
]
</pre>

<p>Metoda <code>toString</code> danego obiektu jest zazwyczaj wywoływana przez interpreter JavaScriptu, ale można ją wywołać samodzielnie, jak poniżej:</p>

<pre class="brush: js">var piesString = jakisPies.toString();
</pre>

<h2 id="Zobacz_tak.C5.BCe" name="Zobacz_tak.C5.BCe">Zobacz także</h2>

<ul>
 <li>{{jsxref("Object.prototype.toSource()")}}</li>
 <li>{{jsxref("Object.prototype.valueOf()")}}</li>
</ul>