https://github.com/thelartians/emglue
🕸️ Glue C++ to your browser! Universal bindings for JavaScript/Wasm using Glue and Embind.
https://github.com/thelartians/emglue
bindings cpp embind emscripten glue glue-bindings javascript wasm webassembly
Last synced: about 1 year ago
JSON representation
🕸️ Glue C++ to your browser! Universal bindings for JavaScript/Wasm using Glue and Embind.
- Host: GitHub
- URL: https://github.com/thelartians/emglue
- Owner: TheLartians
- License: mit
- Created: 2020-05-03T13:45:16.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-01-07T16:48:30.000Z (over 2 years ago)
- Last Synced: 2025-03-30T23:03:41.961Z (over 1 year ago)
- Topics: bindings, cpp, embind, emscripten, glue, glue-bindings, javascript, wasm, webassembly
- Language: C++
- Homepage: https://github.com/TheLartians/Glue
- Size: 50.8 KB
- Stars: 21
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/TheLartians/EmGlue/actions)
[](https://github.com/TheLartians/EmGlue/actions)
# Glue bindings for JavaScript using Embind
JavaScript (Wasm) bindings for [Glue](https://github.com/TheLartians/Glue) using Emscripten.
## Usage
### Example
Using EmGlue you can interact with JavaScript using a simple binding interface.
The following example illustrates the basic usage.
```cpp
#include
#include
#include
void exampleBasics() {
glue::emscripten::State state;
// run JS code
state.run("console.log('Hello JavaScript!')");
// extract values from JS
std::cout << state.run("'Hello' + ' ' + 'C++!'")->get() << std::endl;
// extract maps
auto map = state.run("({a: 1, b: '2'})").asMap();
map["a"]->get(); // -> 1
// extract functions
auto f = state.run("(a,b) => { return a+b }").asFunction();
f(3, 4).get(); // -> 7
// inject values
auto global = state.root();
global["x"] = 42;
global["square"] = [](double x){ return x*x; };
// interact with JS directly
state.run("console.log('square(x) =',square(x))");
// or using Glue
global["console"]["log"]("square(x) =", global["square"](global["x"]));
}
```
Classes and inheritance are also supported.
```cpp
struct A {
std::string member;
A(std::string m): member(m) {}
auto method() const { return "member: " + member; }
};
void exampleModules() {
glue::emscripten::State state;
// inject C++ classes and APIs into JavaScript
auto module = glue::createAnyMap();
module["A"] = glue::createClass()
.addConstructor()
.addMember("member", &A::member)
.addMethod("method", &A::method)
;
state.addModule(module, state.root());
state.run("a = new A('test');");
state.run("console.log('a.member() =',a.member());");
state.run("console.log('a.method() =', a.method());");
// there are no destructors in JavaScript
// -> be sure to delete your instances after use!
state.run("a.delete(); a=undefined;");
}
```
Check the [API](include/glue/emscripten/state.h) and [tests](test/source/state.cpp) for functionality and examples.
See [here](https://github.com/TheLartians/TypeScriptXX) for a full example project using automatic TypeScript declarations.
### Adding to your project
EmGlue can be easily integrated through [CPM.cmake](https://github.com/TheLartians/CPM.cmake).
If not available before, this will automatically add the Glue target as well.
```cmake
CPMAddPackage(
NAME EmGlue
VERSION 0.2
GITHUB_REPOSITORY TheLartians/EmGlue
)
target_link_libraries(myLibrary EmGlue)
```
### Build and run tests
First, [install and activate](https://emscripten.org/docs/getting_started/downloads.html) the emsdk.
Then run the following commands from the project's root.
```bash
emcmake cmake -Htest -Bbuild
cmake --build build -j8
node build/EmGlueTests.js
```