Function.prototype.toString()

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

La méthodetoString() renvoie une chaîne de caractères représentant le code source de la fonction.

Exemple interactif

function sum(a, b) {  return a + b;}console.log(sum.toString());// Expected output: "function sum(a, b) {//                     return a + b;//                   }"console.log(Math.abs.toString());// Expected output: "function abs() { [native code] }"

Syntaxe

function.toString(indentation)

Valeur de retour

Une chaîne de caractères qui représente le code source de la fonction.

L'objetFunction redéfinit la méthodetoString de l'objetObject ; il n'hérite donc pas deObject.prototype.toString. Pour les objetsFunction, la méthodetoString renvoie une chaîne de caractères représentant l'objet sous la forme d'une déclaration de fonction. Pour ce faire,toString décompile la fonction pour renvoyer une chaîne qui contient le mot-cléfunction, la liste des arguments, les accolades et la source correspondant au corps de la fonction.

Le moteur JavaScript appelle la méthodetoString automatiquement lorsqu'un objetFunction doit être représenté textuellement (par exemple lorsqu'une fonction doit être concaténée avec une chaîne de caractères).

La méthodetoString() lèvera une exceptionTypeError (« Function.prototype.toString called on incompatible object ») si la valeur this n'est pas un objetFunction.

Function.prototype.toString.call("toto"); // TypeError

Si la méthodetoString() est appelée sur des fonctions natives qui ne sont pas définies dans le script,toString() renvoie une chaîne de caractères indiquant le caractère natif :

Math.abs.toString();"function abs() {    [native code]}"

Si la méthodetoString() est appelée sur une fonction créée avec le constructeurFunction,toString() renverra le code source d'une fonction intituléeanonymous et utilisera les paramètres et le corps de la fonction fournis.