Duktape is an embeddable Javascript engine, with a focus on portability and compact footprint.
Duktape is easy to integrate into a C/C++ project: add duktape.c
,
duktape.h
, and duk_config.h
to your build, and use the
Duktape API to call Ecmascript functions from C code and vice versa.
x86 default | x86 lowmem | x86 full lowmem | |
Code | 170kB | 150kB | 200kB |
Startup RAM | 68kB | 35kB | 4kB |
See GCC options for minimizing code footprint. Full lowmem uses "pointer compression" and ROM-based strings/objects. ROM-based strings/objects can also be used without other low memory options.
#duktape
on chat.freenode.net
(webchat)See: Projects using Duktape.
If you're using Duktape in your project, send an e-mail or open a GitHub issue to be added to the list.
There are multiple Javascript engines targeting similar use cases as Duktape, at least:
Also see List of ECMAScript engines.
(See Getting started for a more detailed introduction.)
Add Duktape C source and header to your build. Any build system can be used. The distributable contains an example Makefile for reference. In the simplest case:
$ gcc -std=c99 -o test test.c duktape.c -lm $ ./test Hello world!
Initialize and use Duktape somewhere in your program:
/* test.c */ #include "duktape.h" int main(int argc, char *argv[]) { duk_context *ctx = duk_create_heap_default(); duk_eval_string(ctx, "print('Hello world!');"); duk_destroy_heap(ctx); return 0; }
To call a C function from Ecmascript code, first declare your C function:
duk_ret_t adder(duk_context *ctx) { int i; int n = duk_get_top(ctx); /* #args */ double res = 0.0; for (i = 0; i < n; i++) { res += duk_to_number(ctx, i); } duk_push_number(ctx, res); return 1; /* one return value */ }
Register your function e.g. into the global object:
duk_push_c_function(ctx, adder, DUK_VARARGS); duk_put_global_string(ctx, "adder");
You can then call your function from Ecmascript code:
duk_eval_string_noresult(ctx, "print('2+3=' + adder(2, 3));");