• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1![](./LOGO.png)
2# JerryScript: JavaScript engine for the Internet of Things
3[![License](https://img.shields.io/badge/licence-Apache%202.0-brightgreen.svg?style=flat)](LICENSE)
4[![Travis CI Build Status](https://travis-ci.org/jerryscript-project/jerryscript.svg?branch=master)](https://travis-ci.org/jerryscript-project/jerryscript)
5[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/ct8reap35u2vooa5/branch/master?svg=true)](https://ci.appveyor.com/project/jerryscript-project/jerryscript/branch/master)
6[![Coverity Scan Build Status](https://scan.coverity.com/projects/12127/badge.svg)](https://scan.coverity.com/projects/jerryscript-project)
7[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fjerryscript-project%2Fjerryscript.svg?type=shield)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fjerryscript-project%2Fjerryscript?ref=badge_shield)
8[![SonarQube](https://sonarcloud.io/api/project_badges/measure?project=jerryscript-project_jerryscript&metric=ncloc)](https://sonarcloud.io/dashboard?id=jerryscript-project_jerryscript)
9[![IRC Channel](https://img.shields.io/badge/chat-on%20freenode-brightgreen.svg)](https://kiwiirc.com/client/irc.freenode.net/#jerryscript)
10
11JerryScript is a lightweight JavaScript engine for resource-constrained devices such as microcontrollers. It can run on devices with less than 64 KB of RAM and less than 200 KB of flash memory.
12
13Key characteristics of JerryScript:
14* Full ECMAScript 5.1 standard compliance
15* 160K binary size when compiled for ARM Thumb-2
16* Heavily optimized for low memory consumption
17* Written in C99 for maximum portability
18* Snapshot support for precompiling JavaScript source code to byte code
19* Mature C API, easy to embed in applications
20
21Additional information can be found on our [project page](http://jerryscript.net) and [Wiki](https://github.com/jerryscript-project/jerryscript/wiki).
22
23Memory usage and Binary footprint are measured at [here](https://jerryscript-project.github.io/jerryscript-test-results) with real target daily.
24
25The latest results on  **Raspberry Pi 2**:
26
27
28[![Remote Testrunner](https://firebasestorage.googleapis.com/v0/b/jsremote-testrunner.appspot.com/o/status%2Fjerryscript%2Frpi2.svg?alt=media&token=1)](https://jerryscript-project.github.io/jerryscript-test-results/?view=rpi2)
29
30IRC channel: #jerryscript on [freenode](https://freenode.net)
31Mailing list: jerryscript-dev@groups.io, you can subscribe [here](https://groups.io/g/jerryscript-dev) and access the mailing list archive [here](https://groups.io/g/jerryscript-dev/topics).
32
33## Quick Start
34### Getting the sources
35```bash
36git clone https://github.com/jerryscript-project/jerryscript.git
37cd jerryscript
38```
39
40### Building JerryScript
41```bash
42python tools/build.py
43```
44
45For additional information see [Getting Started](docs/00.GETTING-STARTED.md).
46
47## Documentation
48- [Getting Started](docs/00.GETTING-STARTED.md)
49- [Configuration](docs/01.CONFIGURATION.md)
50- [API Reference](docs/02.API-REFERENCE.md)
51- [API Example](docs/03.API-EXAMPLE.md)
52- [Internals](docs/04.INTERNALS.md)
53- [Migration Guide](docs/16.MIGRATION-GUIDE.md)
54
55## Contributing
56The project can only accept contributions which are licensed under the [Apache License 2.0](LICENSE) and are signed according to the JerryScript [Developer's Certificate of Origin](DCO.md). For further information please see our [Contribution Guidelines](CONTRIBUTING.md).
57
58## License
59JerryScript is open source software under the [Apache License 2.0](LICENSE). Complete license and copyright information can be found in the source code.
60
61[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fjerryscript-project%2Fjerryscript.svg?type=large)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fjerryscript-project%2Fjerryscript?ref=badge_large)
62
63> Copyright JS Foundation and other contributors, http://js.foundation
64
65> Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
66