import * as escodegen from 'escodegen'; import * as esprima from 'esprima'; import * as estraverse from 'estraverse'; import * as ESTree from 'estree'; import { TNodeWithBlockStatement } from '../types/node/TNodeWithBlockStatement'; import { TStatement } from '../types/node/TStatement'; import { NodeType } from '../enums/NodeType'; import { Node } from './Node'; export class NodeUtils { /** * @type {string[]} */ private static readonly nodesWithBlockScope: string[] = [ NodeType.ArrowFunctionExpression, NodeType.FunctionDeclaration, NodeType.FunctionExpression, NodeType.MethodDefinition, NodeType.Program ]; /** * @param node */ public static addXVerbatimPropertyToLiterals (node: ESTree.Node): void { NodeUtils.typedReplace(node, NodeType.Literal, { leave: (node: ESTree.Literal) => { node['x-verbatim-property'] = { content : node.raw, precedence: escodegen.Precedence.Primary }; } }); } /** * @param code * @returns {TStatement[]} */ public static convertCodeToStructure (code: string): TStatement[] { const structure: ESTree.Program = esprima.parse(code); NodeUtils.addXVerbatimPropertyToLiterals(structure); NodeUtils.parentize(structure); return structure.body; } /** * @param structure * @returns {string} */ public static convertStructureToCode (structure: ESTree.Node[]): string { let code: string = ''; for (let node of structure) { code += escodegen.generate(node, { sourceMapWithCode: true }).code; } return code; } /** * @param node * @param index * @returns {ESTree.Node} */ public static getBlockStatementNodeByIndex (node: ESTree.Node, index: number = 0): ESTree.Node { if (Node.isNodeHasBlockStatement(node)) { if (node.body[index] === undefined) { throw new ReferenceError(`Wrong index \`${index}\`. Block-statement body length is \`${node.body.length}\``); } return node.body[index]; } throw new TypeError('The specified node have no a block-statement'); } /** * @param node * @param depth * @returns {ESTree.Node} */ public static getBlockScopeOfNode (node: ESTree.Node, depth: number = 0): TNodeWithBlockStatement { const parentNode: ESTree.Node | undefined = node.parentNode; if (!parentNode) { throw new ReferenceError('`parentNode` property of given node is `undefined`'); } if (Node.isBlockStatementNode(parentNode)) { if (!parentNode.parentNode) { throw new ReferenceError('`parentNode` property of `parentNode` of given node is `undefined`'); } if (!NodeUtils.nodesWithBlockScope.includes(parentNode.parentNode.type)) { return NodeUtils.getBlockScopeOfNode(parentNode, depth); } else if (depth > 0) { return NodeUtils.getBlockScopeOfNode(parentNode, --depth); } return parentNode; } if (Node.isProgramNode(parentNode)) { return parentNode; } return NodeUtils.getBlockScopeOfNode(parentNode, depth); } /** * @param node * @param depth * @returns {number} */ public static getNodeBlockScopeDepth (node: ESTree.Node, depth: number = 0): number { const parentNode: ESTree.Node | undefined = node.parentNode; if (!parentNode) { throw new ReferenceError('`parentNode` property of given node is `undefined`'); } if (Node.isProgramNode(parentNode)) { return depth; } if (Node.isBlockStatementNode(node) && NodeUtils.nodesWithBlockScope.includes(parentNode.type)) { return NodeUtils.getNodeBlockScopeDepth(parentNode, ++depth); } return NodeUtils.getNodeBlockScopeDepth(parentNode, depth); } /** * @param node */ public static parentize (node: ESTree.Node): void { let isRootNode: boolean = true; estraverse.replace(node, { enter: (node: ESTree.Node, parentNode: ESTree.Node): any => { let value: ESTree.Node; if (isRootNode) { if (node.type === NodeType.Program) { value = node; } else { value = Node.getProgramNode([node]); value.parentNode = value; } isRootNode = false; } else { value = parentNode || node; } node.parentNode = value; node.obfuscated = false; } }); } /** * @param node * @param nodeType * @param visitor */ public static typedReplace ( node: ESTree.Node, nodeType: string, visitor: {enter?: (node: ESTree.Node) => void, leave?: (node: ESTree.Node) => void}, ): void { NodeUtils.typedTraverse(node, nodeType, visitor, 'replace'); } /** * @param node * @param nodeType * @param visitor * @param traverseType */ public static typedTraverse ( node: ESTree.Node, nodeType: string, visitor: estraverse.Visitor, traverseType: string = 'traverse' ): void { (estraverse)[traverseType](node, { enter: (node: ESTree.Node, parentNode: ESTree.Node): any => { if (node.type === nodeType && visitor.enter) { return visitor.enter(node, parentNode); } }, leave: (node: ESTree.Node, parentNode: ESTree.Node): any => { if (node.type === nodeType && visitor.leave) { return visitor.leave(node, parentNode); } } }); } }