Duktape - embeddable Javascript engine with a focus on portability and compact footprint
JavaScript HTML C Python Makefile C++ Other
Switch branches/tags
Clone or download
svaarala Merge pull request #1946 from svaarala/document-duk-bytecode-unvalidated
Note bytecode memory unsafety in duk --help
Latest commit a830a44 Jul 19, 2018
Permalink
Failed to load latest commit information.
config Add <stdexcept> to includes with C++ exceptions May 31, 2018
debugger Use 'ECMAScript' spelling in misc places Apr 28, 2018
dist-files Use 'ECMAScript' spelling in misc places Apr 28, 2018
doc Clarify bytecode use motivations Jul 18, 2018
dukweb Update jQuery 1.11.0 -> 1.11.2 Sep 22, 2017
examples Note bytecode memory unsafety in duk --help Jul 18, 2018
extras Fix compile warning for duk_console.c May 19, 2018
licenses Add xoroshiro128+ and SplitMix64 licenses to dist Sep 19, 2016
misc Manual perf test for app literal usage Nov 19, 2017
polyfills Improve polyfill unhandled rejection handling Jul 7, 2018
references Add 'make refs' target to download ES specs Mar 8, 2016
runtests Use 'ECMAScript' spelling in misc places Apr 28, 2018
src-input Update duk_heap_stringtable.c Jun 18, 2018
testrunner Fix minor typos May 31, 2018
tests Promise polyfill test for rawReject/rawHandle Jul 7, 2018
tools Update genbuiltins.py Jun 18, 2018
util Fix minor typos May 31, 2018
website Improve duk_error/duk_throw API call examples May 28, 2018
.gitattributes Add .gitattributes with eol=lf for most extensions Aug 31, 2015
.gitignore Add duk-sanitize-clang target Nov 6, 2017
.travis.yml Fix Travis python-yaml import error Jul 28, 2017
AUTHORS.rst Releases: warning fixes Jul 8, 2018
CONTRIBUTING.md Fix minor typos May 31, 2018
LICENSE.txt Update license / SPDX year range Jan 2, 2017
Makefile Use 'ECMAScript' spelling in misc places Apr 28, 2018
README.md Fix minor typos May 31, 2018
RELEASES.rst Releases: warning fixes Jul 8, 2018
appveyor.yml Add AppVeyor Date.now() and performace.now() print Aug 5, 2017

README.md

Duktape

Build Status

Introduction

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.

Main features:

  • Embeddable, portable, compact
  • ECMAScript E5/E5.1 compliant, with some semantics updated from ES2015+
  • Partial support for ECMAScript 2015 (E6) and ECMAScript 2016 (E7), Post-ES5 feature status, kangax/compat-table
  • ES2015 TypedArray and Node.js Buffer bindings
  • WHATWG Encoding API living standard
  • Built-in debugger
  • Built-in regular expression engine
  • Built-in Unicode support
  • Minimal platform dependencies
  • Combined reference counting and mark-and-sweep garbage collection with finalization
  • Custom features like coroutines
  • Property virtualization using a subset of ECMAScript E2015 Proxy object
  • Bytecode dump/load for caching compiled functions
  • Distributable includes an optional logging framework, CommonJS-based module loading implementations, etc
  • Liberal license

See duktape.org for packaged end-user downloads and documentation. The end user downloads are also available from the duktape-releases repo as both binaries and in unpacked form as git tags. Snapshot builds from master are available in duktape.org/snapshots.

Have fun!

Support

About this repository

This repository is intended for Duktape developers only, and contains Duktape internals: test cases, internal documentation, sources for the duktape.org web site, etc.

Getting started: end user

When embedding Duktape in your application you should use the packaged source distributables available from duktape.org/download.html. See duktape.org/guide.html#gettingstarted for the basics.

Automatically generated bleeding edge snapshots from master are available at duktape.org/snapshots.

The distributable src/ directory contains a duk_config.h configuration header and amalgamated sources for Duktape default configuration. Use python tools/configure.py to create header and sources for customized configuration options, see http://wiki.duktape.org/Configuring.html. For example, to enable fastint support (example for Linux):

$ tar xvfJ duktape-2.0.0.tar.xz
$ cd duktape-2.0.0
$ rm -rf src-custom
$ python tools/configure.py \
      --source-directory src-input \
      --output-directory src-custom \
      --config-metadata config \
      -DDUK_USE_FASTINT

# src-custom/ will now contain: duktape.c, duktape.h, duk_config.h.

You can also clone this repository, make modifications, and build a source distributable on Linux, OSX, and Windows using python util/dist.py.

Getting started: modifying and rebuilding the distributable

If you intend to change Duktape internals and want to rebuild the source distributable in Linux, OSX, or Windows:

# Linux; can often install from packages or using 'pip'
$ sudo apt-get install python python-yaml
$ python util/dist.py

# OSX
# Install Python 2.7.x
$ pip install PyYAML
$ python util/dist.py

# Windows
; Install Python 2.7.x from python.org, and add it to PATH
> pip install PyYAML
> python util\dist.py

The source distributable directory will be in dist/.

For platform specific notes see http://wiki.duktape.org/DevelopmentSetup.html.

Getting started: other development (Linux only)

Other development stuff, such as building the website and running test cases, is based on a Makefile intended for Linux only. See detailed instructions in http://wiki.duktape.org/DevelopmentSetup.html.

Branch policy

  • The master branch is used for active development. While pull requests are tested before merging, master may be broken from time to time. When development on a new major release starts, master will also get API incompatible changes without warning. For these reasons you should generally not depend on the master branch for building your project; use a release tag or a release maintenance branch instead.

  • Pull requests and their related branches are frequently rebased so you should not fork off them. Pull requests may be open for a while for testing and discussion.

  • Release tags like v1.4.1 are used for releases and match the released distributables. These are stable once the release is complete.

  • Maintenance branches are used for backporting fixes and features for maintenance releases. Documentation changes go to master for maintenance releases too. For example, v1.5-maintenance was created for the 1.5.0 release and is used for 1.5.x maintenance releases.

  • A maintenance branch is also created for a major release when master moves on to active development of the next major release. For example, v1-maintenance was created when 1.5.0 was released (last planned 1.x release) and development of 2.0.0 (with API incompatible changes) started on master. The 1.6.0 and 1.7.0 releases were made from v1-maintenance for example.

Versioning

Duktape uses Semantic Versioning for official releases. Builds from Duktape repo are not official releases and don't follow strict semver, mainly because DUK_VERSION needs to have some compromise value that won't be strictly semver conforming. Because Duktape tracks the latest ECMAScript specification versions, compliance fixes are made in minor versions even when they are technically not backwards compatible. See Versioning for details.

Reporting bugs

See CONTRIBUTING.md.

Security critical GitHub issues (for example anything leading to a segfault) are tagged security.

Contributing

See CONTRIBUTING.md.

Copyright and license

See AUTHORS.rst and LICENSE.txt.

Duktape Wiki is part of Duktape documentation and under the same copyright and license.