Jsb

Project Description

The idea of the project is to create the ability to control C++ objects from JavaScript code, similar to what Emscripten provides to developers but with a limited feature set due to memory access limitations. The project is inspired by Emscripten's embind and later by Boost.Python.

NOTE

It is impossible to make multiple synchronous calls from JavaScript to C++ due to limitations imposed by the browser.

Samples

• [x] macOS - look in macOS directory
• [ ] iOS
• [ ] Android
• [ ] Windows

macOS

Look into ViewController.mm to see on how to register Bridge communicator.

Example on how to bind C++ code:

class TestJSBinding  {
public:
    TestJSBinding() { }
    
    int getNumber() {
        return i;
    }
    void setNumber(int newi) {
        i = newi;
    }
    int i;
}


jsb::class_<TestJSBinding>("TestJSBinding")
.constructor<>()
.function("setNumber", &TestJSBinding::setNumber)
.function("getNumber", &TestJSBinding::getNumber);

In javascript:

var object = new TestJSBinding();
object.setNumber(10);
var value2 = object.getNumber();
object.delete();

Features list

Essential:

• [x] bind a class
• [x] bind regular functions of a class
• [x] bind const functions of a class
• [x] bind static functions of a class
• [x] bind simple constructor of a class
• [x] bind global functions
• [x] generate funcitons JavaScript code based on bindings
• [x] delete function for a C++ class
• [x] execute generated JavaScript code at registerCommunicator
• [ ] val as wrapper around JS object - in progress - not possible
• [ ] EM_JS - read JS function's arguments and pass to a C++ function
• [ ] bind perfect forwarding functions of a class ??
• [ ] bind constructor with arguments of a class
• [ ] bind property members of a class
• [ ] implement typescript interafaces generator.
• [ ] bind enums
• [x] bind vectors

Non-essential

• [ ] value types

• [ ] smart pointers

• [ ] advanced class concepts

• [ ] Type conversion

• [ ] Do performance testing and compare

• [ ] EM_ASYNC_JS

• [ ] simple EM_ASM

Non-essential - out of scope:

• [ ] Deriving from C++ classes in JavaScript

  • [ ] Abstract methods
  • [ ] Non-abstract virtual methods
  • [ ] Base classes
  • [ ] Automatic downcasting
  • [ ] Overloaded functions

• [ ] advanced EM_ASM from em_asm.h

More for reference: https://emscripten.org/docs/porting/connecting_cpp_and_javascript/embind.html

Configuration