WASM port of tiny-js
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Jason Staten b5388531ea
emscripten
1 year ago
tests 42TinyJS: Milestone-3 9 years ago
.gitignore fix 5 years ago
CMakeLists.txt add tests content copy 5 years ago
LICENSE Create LICENSE 5 years ago
Makefile emscripten 1 year ago
README.md Update README.md 9 years ago
Script.cpp Change to distribute TinyJS under MIT License 12 years ago
TinyJS.cpp Version 0.32 : Fixed Math.randInt on 32 bit PCs, where it was broken 12 years ago
TinyJS.h Change to distribute TinyJS under MIT License 12 years ago
TinyJS_Eval.cpp emscripten 1 year ago
TinyJS_Functions.cpp Version 0.32 : Fixed Math.randInt on 32 bit PCs, where it was broken 12 years ago
TinyJS_Functions.h Change to distribute TinyJS under MIT License 12 years ago
TinyJS_MathFunctions.cpp fix build 5 years ago
TinyJS_MathFunctions.h Version 0.32 : Fixed Math.randInt on 32 bit PCs, where it was broken 12 years ago
run_tests.cpp Change to distribute TinyJS under MIT License 12 years ago

README.md

tiny-js

(originally on Google Code)

This project aims to be an extremely simple (~2000 line) JavaScript interpreter, meant for inclusion in applications that require a simple, familiar script language that can be included with no dependencies other than normal C++ libraries. It currently consists of two source files: one containing the interpreter, another containing built-in functions such as String.substring.

TinyJS is not designed to be fast or full-featured. However it is great for scripting simple behaviour, or loading & saving settings.

I make absolutely no guarantees that this is compliant to JavaScript/EcmaScript standard. In fact I am sure it isn't. However I welcome suggestions for changes that will bring it closer to compliance without overly complicating the code, or useful test cases to add to the test suite.

Currently TinyJS supports:

  • Variables, Arrays, Structures
  • JSON parsing and output
  • Functions
  • Calling C/C++ code from JavaScript
  • Objects with Inheritance (not fully implemented)

Please see CodeExamples for examples of code that works...

For a list of known issues, please see the comments at the top of the TinyJS.cpp file, as well as the GitHub issues

There is also the 42tiny-js branch - this is maintained by Armin and provides a more full-featured JavaScript implementation than GitHub master.

TinyJS is released under an MIT licence.

Internal Structure

TinyJS uses a Recursive Descent Parser, so there is no 'Parser Generator' required. It does not compile to an intermediate code, and instead executes directly from source code. This makes it quite fast for code that is executed infrequently, and slow for loops.

Variables, Arrays and Objects are stored in a simple linked list tree structure (42tiny-js uses a C++ Map). This is simple, but relatively slow for large structures or arrays.

JavaScript for Microcontrollers

If you're after JavaScript for Microcontrollers, take a look at the Espruino JavaScript Interpreter - it is a complete re-write of TinyJS targeted at processors with extremely low RAM (8kb or more). It is currently available for a range of STM32 ARM Microcontrollers, including two boards that have it pre-installed.