Práctica-2: Espree Logging

Este programa recibe otro programa en forma de string, el cual modifica añadiendole sentencias console.log cada vez que se aparece una función.

Pasamos el código original a la función "addLoging" la cúal lo primero que hace es invocar al método "parse" con el mismo. Con el trozo de código en forma de string se creara un AST (Abstract syntax tree) como el que podemos encontrar en (https://astexplorer.net/), con la función "traverse" recorremos el árbol. Por lo que estoy viendo en la variable "node" se guarda el nodo que estamos evaluando en el momento y en la variable "parent" el nodo de la iteración anterior, tal y como dice la documentacion hay que tener en cuenta que a veces este nodo es null, Si el nodo que estamos evaluando tiene como tipo "FunctionDeclaration" o "FunctionExpresion" se invoca a la función "addBeforeCode" pasandole ese nodo en especifico.
En este código:

function  foo(a, b) {
  var x = 'blah';
  var y = (function () {
    return 3;
  })();
}

tiene el tipo "FunctionDeclaration" y a su vez internamente function () {return 3;} es "FunctionExpression".

Una vez dentro de la función "addBeforeCode" miramos con un condicional ternario si tiene algun identificador (id), guardamos el indentificardor en caso de que tenga alguno y si no guardamos el string literal <anonymous function>. El primer nodo tiene como identificador "foo", mientras que el segundo no tiene, específicamente tiene el valor null, despúes simplemente incrustamos ese valor en un string, guardamos este string y lo convertimos en arbol AST, aunque solo nos quedamos con la parte "body" más exterior obviando campos como "type", "start" y "end", seguidamente concatenamos la estructura que acabamos de obtener al cuerpo del cuerpo, esto se hace así ya que con el primer body nos quitamos el nombre y los párametros de la función, lo que podríamos considerar la cabecera, y con el segundo nos deshacemos de las llevamos dejandonos con el código interior de la función. Atualizamos el nodo.
Nota: concat es invocado por "beforeNodes" es por esto que aparece antes del valor "node.body.body".

Una vez terminado con todos los nodos convertimos el AST en código javascript en forma de string.

Tarea:

Para mostrar los párametros pasadas a la función, utilizo el siguiente código:

let param_name = [];
  node.params.forEach(function(i) {param_name.push("${ " + i.name + " }")});
  param_name = param_name.join(', ');

Aprovecho que estoy en "addBeforeCode()" para suponer que ya estamos tratando un nodo de algun tipo función y cada params del nodo cojo el el valor del campo name, despúes simplemente le añado una ',' entre cada dos pares.

La función fleca (Arrow Function) esta identificada en el árbol como ArrowFunctionExpression por lo que simplemente añadimos lo propio en la condición:

if (node.type === 'FunctionDeclaration' ||
            node.type === 'FunctionExpression' ||
            node.type === 'ArrowFunctionExpression') {
            addBeforeCode(node);
          }

Para mostrar la líne de la función podemos usar node.loc, si lo mostramos por pantalla veremos algo como:

SourceLocation {
  start: Position { line: 3, column: 11 },
  end: Position { line: 5, column: 3 }
}

Aquí podemos ver donde empieza y acaba la función. Al final nos queda:

let beforeCode = `console.log(\`Entering ${name}(${param_name}) at line ${node.loc.start.line}\`);`;