jintr

Jinter

A tiny JavaScript interpreter written in TypeScript

Note: This project was originally developed for use in YouTube.js.

Table of Contents

• Installation
• Usage
• API
  • evaluate(input: string)
  • visitor
  • scope
• License

Installation

npm install jintr

Usage

Execute some JavaScript code:

// const Jinter = require('jintr').default;
import { Jinter } from 'jintr';

const code = `
  function sayHiTo(person) {
    console.log('Hi ' + person + '!');
  }
  
  sayHiTo('mom');
`

const jinter = new Jinter();
jinter.evaluate(code);

---

Inject your own functions, objects, etc:

import { Jinter } from 'jintr';

const jinter = new Jinter();

const code = `
  console.log(new SomeClass().a);
  console.log('hello'.toArray());

  function myFn() {
    console.log('[myFn]: Who called me?');
  }

  myFn();
`;

class SomeClass {
  constructor() {
    this.a = 'this is a test';
  }
}

jinter.defineObject('SomeClass', SomeClass);

// Ex: str.toArray();
jinter.visitor.on('toArray', (node, visitor) => {
  if (node.type === 'CallExpression' && node.callee.type === 'MemberExpression') {
    const obj = visitor.visitNode(node.callee.object);
    return obj.split('');
  }
});

// Intercept function calls
jinter.visitor.on('myFn', (node) => {
  if (node.type == 'CallExpression')
    console.info('myFn was called!');
  return '__continue_exec';
});

jinter.evaluate(code);

For more examples see /test and /examples.

API

• Jinter()
  • evaluate(input: string)
  • visitor
  • scope

evaluate(input: string)

Evaluates the given JavaScript code.

visitor

The node visitor. This is responsible for walking the AST and executing the nodes.

scope

Represents the global scope of the program.

License

Distributed under the MIT License.

(back to top)

Changelog

3.0.2 (2024-10-28)

⚠ BREAKING CHANGES

• Drop CJS support
• convert to ESModule (#4)
• overhaul interpreter (#3)

Features

• add != op (97e17f9)
• add !== op (475fc89)
• add >>> op (7cfdfdf)
• add ^ op (faa1904)
• add ForOfStatement node (203d3ae)
• add in op (3f2d00d)
• add instanceof op (c11f440)
• Add parseScript (654d06d)
• add typeof op (5836fec)
• add support for IfStatement & WhileStatement (5179eee)
• Add support for template literals (#15) (6daec99)
• BinaryExp: add support for bitwise AND (af01ce4)
• package: Publish to JSR (c0aa00c)

Bug Fixes

• for-stmts: do not return if body type is ExpressionStatement (7e43562)
• package: add extra file configuration to release-please-config.json (f2d08b7)
• short-circuiting not working correctly (8b610d1)
• Stop using global augmentation and add LICENSE file (94b6bb0)

Miscellaneous Chores

• release 1.0.0 (7c292f7)
• release 2.1.0 (3f81b80)
• release 2.1.1 (ef984b5)
• release 3.0.2 (5cffafe)

Code Refactoring

• convert to ESModule (#4) (50e40db)
• Drop CJS support (e3d5346)
• overhaul interpreter (#3) (3b5e56e)