https://github.com/ftk/quickjspp
QuickJS C++ wrapper
https://github.com/ftk/quickjspp
cpp17 javascript-engine quickjs wrapper
Last synced: 1 day ago
JSON representation
QuickJS C++ wrapper
- Host: GitHub
- URL: https://github.com/ftk/quickjspp
- Owner: ftk
- Created: 2019-07-14T12:19:55.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-07-04T19:29:01.000Z (8 months ago)
- Last Synced: 2025-07-04T20:32:11.158Z (8 months ago)
- Topics: cpp17, javascript-engine, quickjs, wrapper
- Language: C
- Homepage:
- Size: 2.65 MB
- Stars: 435
- Watchers: 22
- Forks: 92
- Open Issues: 27
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
QuickJSPP is QuickJS wrapper for C++. It allows you to easily embed Javascript engine into your program.
QuickJS is a small and embeddable Javascript engine. It supports the ES2020 specification including modules, asynchronous generators and proxies. More info:
# Example
```cpp
#include "quickjspp.hpp"
#include
class MyClass
{
public:
MyClass() {}
MyClass(std::vector) {}
double member_variable = 5.5;
std::string member_function(const std::string& s) { return "Hello, " + s; }
};
void println(qjs::rest args) {
for (auto const & arg : args) std::cout << arg << " ";
std::cout << "\n";
}
int main()
{
qjs::Runtime runtime;
qjs::Context context(runtime);
try
{
// export classes as a module
auto& module = context.addModule("MyModule");
module.function<&println>("println");
module.class_("MyClass")
.constructor<>()
.constructor>("MyClassA")
.fun<&MyClass::member_variable>("member_variable")
.fun<&MyClass::member_function>("member_function");
// import module
context.eval(R"xxx(
import * as my from 'MyModule';
globalThis.my = my;
)xxx", "", JS_EVAL_TYPE_MODULE);
// evaluate js code
context.eval(R"xxx(
let v1 = new my.MyClass();
v1.member_variable = 1;
let v2 = new my.MyClassA([1,2,3]);
function my_callback(str) {
my.println("at callback:", v2.member_function(str));
}
)xxx");
// callback
auto cb = (std::function) context.eval("my_callback");
cb("world");
}
catch(qjs::exception)
{
auto exc = context.getException();
std::cerr << (std::string) exc << std::endl;
if((bool) exc["stack"])
std::cerr << (std::string) exc["stack"] << std::endl;
return 1;
}
}
```
# Installation
QuickJSPP is header-only - put quickjspp.hpp into your include search path.
Compiler that supports C++17 or later is required.
The program needs to be linked against QuickJS.
Sample CMake project files are provided.
# License
QuickJSPP is licensed under [CC0](https://creativecommons.org/publicdomain/zero/1.0/). QuickJS is licensed under [MIT](https://opensource.org/licenses/MIT).