re:re:actable
Урок 102 минуты чтения

toString() у функции

На этой странице
Кратко

fn.toString() возвращает строковое представление функции. Для обычных функций это обычно исходный текст, а для встроенных функций - строка с [native code].

Вопрос

Что делает toString() у функции? Как устроен этот метод?

Базовый пример

function sum(a, b) {
  return a + b;
}
 
sum.toString();

Результат будет похож на:

"function sum(a, b) {\n  return a + b;\n}"

Стрелочные функции

const double = (value) => value * 2;
 
double.toString(); // "(value) => value * 2"

Встроенные функции

Array.prototype.map.toString();

Результат обычно содержит:

"function map() { [native code] }"

Это значит, что функция реализована движком, а не обычным JS-кодом.

Зачем может быть нужно

Иногда toString() используют:

  • для отладки;
  • для логирования;
  • в инструментах разработки;
  • в метапрограммировании;
  • в тестах или учебных целях.

В обычной бизнес-логике полагаться на текст функции не стоит.

Почему осторожно

Строковое представление может зависеть от:

  • движка JavaScript;
  • минификации;
  • транспиляции;
  • сборщика;
  • формата исходного кода.
function isNative(fn) {
  return fn.toString().includes("[native code]");
}

Такой код может быть хрупким.

Function.prototype.toString

Метод находится в прототипе функций:

Function.prototype.toString.call(sum);

Это почти то же, что:

sum.toString();

Что важно помнить

  • fn.toString() возвращает исходный текст функции, но после минификации он нечитаем.
  • Для встроенных функций возвращается function name() { [native code] }.
  • Полагаться на текст функции в логике нельзя: сборщики и транспиляторы его меняют.
  • Исторически так проверяли «нативность» API, сейчас это ненадежно.

Мини-шпаргалка

ФункцияЧто вернет
обычная функцияисходный текст функции
стрелочная функциятекст стрелочной функции
метод классатекст метода
встроенная функция[native code]
bound functionзависит от движка, часто [native code]

Документация

MDN: Function.prototype.toString().

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам