Você está lendo a versão em inglês deste conteúdo porque ainda não há uma tradução para este idioma. Ajude-nos a traduzir este artigo!
O método toString()
retorna uma string representando o código fonte da função.
A fonte deste exemplo interativo está armazenado no repositório do GitHub. Se você gostaria de contrubuir para este exemplos de projeto interativo, por favor clone https://github.com/mdn/interactive-examples e envie um pull request.
Sintaxe
function.toString()
Valor de retorno
Uma string representando o código fonte da função.
Descrição
O objeto da Function
substitui o método toString
herdado de Object
; ele não herda Object.prototype.toString
. Para objetos Function
definidos pelo usuário, o método toString
retorna uma string contendo o seguimento de texto de origem que foi usado para definir a função
O JavaScript chama o método toString
automaticamente quando uma Function
pode ser representada como um valor de texto. e.x. quando uma função é concatenada com uma string.
O método toString()
lançará uma exceção do tipo TypeError
("Function.prototype.toString called on incompatible object") se o valor this
do objeto não é um objeto do tipo Function.
Function.prototype.toString.call('foo'); // TypeError
Se o método toString()
é chamado por objetos de funções embutidas ou por uma função criada por Function.prototype.bind
, toString()
retorna uma string de uma função nativa que parece
"function () {\n [native code]\n}"
Se o método toString()
é chamado por uma função criada pelo contrutor de Function
, toString()
retorna o código fonte de uma declaração de função sintetizada chamada "anonymous" usando os parâmetros passados e o corpo da função.
Exemplos
Função | Function.prototype.toString resultado |
---|---|
function f(){} |
"function f(){}" |
class A { a(){} } |
"class A { a(){} }" |
function* g(){} |
"function* g(){}" |
a => a |
"a => a" |
({ a(){} }.a) |
"a(){}" |
({ *a(){} }.a) |
"*a(){}" |
({ [0](){} }[0]) |
"[0](){}" |
Object.getOwnPropertyDescriptor({ get a(){} }, "a").get |
"get a(){}" |
Object.getOwnPropertyDescriptor({ set a(x){} }, "a").set |
"set a(x){}" |
Function.prototype.toString |
"function toString() { [native code] }" |
(function f(){}.bind(0)) |
"function () { [native code] }" |
Function("a", "b") |
"function anonymous(a\n) {\nb\n}" |
Especificações
Especificação | Status | Comentário |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Padrão |
Definição inicial. Implementado no JavaScript 1.1. |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Function.prototype.toString' in that specification. |
Padrão |
Mais requisitos específicos foram incluídos para representação de string. |
Function.prototype.toString revisions proposal |
Rascunho |
Padroniza a função de string navida e fins de linha. |
ECMAScript Latest Draft (ECMA-262) The definition of 'Function.prototype.toString' in that specification. |
Rascunho |
Compatibilidade de navegador
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toString | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 5 | Opera Full support Yes | Safari Full support Yes | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support 1.0 | nodejs Full support Yes |
Support of toString revision | Chrome No support No | Edge No support No | Firefox Full support 54 | IE No support No | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android Full support 54 | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No | nodejs No support No |
Legend
- Full support
- Full support
- No support
- No support
Firefox-specific notes
- Desde o Firefox 17 a função
Function.prototype.toString()
tem sido implementada salvando o fonte da função. O descompilador foi removido o que torna o parâmetroindentation
desnecessário. Veja bug 761723 para mais detalhes. - Do Firefox 38 para o 63 a função
Function.prototype.toString()
lançava exceções para objetosProxy
(bug 1100936 e bug 1440468).