Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.toString() — odczyt wartości tekstowej

Metoda String.prototype.toString() zwraca prymitywną wartość tekstową dla tekstu lub obiektu String. Nie jest ogólnym konwerterem: dla niezgodnego this zgłasza TypeError.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

stringValue.toString()
String.prototype.toString.call(value)

Symbol katalogowy String.toString oznacza tutaj metodę String.prototype.toString(), wywoływaną na wartości tekstowej. Nie należy mylić jej z wyrażeniem String.toString(), które wywołuje metodę na samej funkcji String.

Metoda nie przyjmuje parametrów. Dla prymitywnego tekstu zwraca tę samą wartość, a dla obiektu utworzonego przez new String(...) odczytuje tekst z wewnętrznego slotu [[StringData]]. Wynik jest prymitywem typu string, nie obiektem. Wbudowana metoda String.prototype.valueOf() zwraca tę samą wartość.

Metoda nie jest generyczna: String.prototype.toString.call(42) zgłasza TypeError, podobnie jak wywołanie z null, undefined lub zwykłym obiektem bez [[StringData]]. Samo posiadanie własnej metody toString nie wystarcza. Przykład pokazuje poprawne odbiorniki i celowo przechwytuje błąd dla liczby.

Przykłady

const text = "hello";
const wrapped = new String(text);
const result = wrapped.toString();

console.log(text.toString() === text);
console.log(result, typeof result);
console.log(result === wrapped.valueOf());

try {
  String.prototype.toString.call(42);
} catch (error) {
  console.log(error instanceof TypeError);
}

Wynik

true
hello string
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła