C++ TypeScript JavaScript CMake Other
Clone or download
Permalink
Failed to load latest commit information.
benchmark Release candidate for 0.1.0 (#23) Aug 3, 2017
docs Update function group `zone.broadcast` (#201) Apr 3, 2018
examples Add an example that uses napa.sync.Lock (#179) Jan 5, 2018
inc fix build/test break introduced by v8 breaking change from node v10.x ( Apr 25, 2018
lib Fix load() implementation of transportable object (#216) Apr 19, 2018
node Timers related function, set/clear Immediate/Timeout/Interval (#207) Apr 4, 2018
scripts napa embeded support for Linux (#110) Nov 8, 2017
src fix and re-enable builtin type transportation (#235) May 9, 2018
test Fix assert.ifError() usage in test (#233) May 19, 2018
third-party Update 3rd party library 'args' to latest version (7bf1700) (#215) Apr 4, 2018
unittest Timers related function, set/clear Immediate/Timeout/Interval (#207) Apr 4, 2018
.gitignore convert transport builtin types test to TypeScript (#168) Dec 23, 2017
.npmignore Add file npm-debug.log to ignore list (#159) Dec 14, 2017
.travis.yml Fix crash on some linux environment (#229) May 2, 2018
CMakeLists.txt Fix crash on some linux environment (#229) May 2, 2018
LICENSE.txt Merged PR 327505: Merge dev/dapeng/license to master Jul 19, 2017
README.md Add an example that uses napa.sync.Lock (#179) Jan 5, 2018
appveyor.yml Fix crash on some linux environment (#229) May 2, 2018
build.bat Added a script for building napa in embed mode (#47) Aug 29, 2017
build.js Added a script for building napa in embed mode (#47) Aug 29, 2017
package.json Add cmake-js to devDependencies (#246) Jul 23, 2018

README.md

Build Status for Linux/MacOS Build Status for Windows npm version Downloads

Napa.js

Napa.js is a multi-threaded JavaScript runtime built on V8, which was originally designed to develop highly iterative services with non-compromised performance in Bing. As it evolves, we find it useful to complement Node.js in CPU-bound tasks, with the capability of executing JavaScript in multiple V8 isolates and communicating between them. Napa.js is exposed as a Node.js module, while it can also be embedded in a host process without Node.js dependency.

Installation

Install the latest stable version:

npm install napajs

Other options can be found in Build Napa.js.

Quick Start

var napa = require('napajs');
var zone1 = napa.zone.create('zone1', { workers: 4 });

// Broadcast code to all 4 workers in 'zone1'.
zone1.broadcast('console.log("hello world");');

// Execute an anonymous function in any worker thread in 'zone1'.
zone1.execute(
    (text) => text, 
    ['hello napa'])
    .then((result) => {
        console.log(result.value);
    });

More examples:

Features

  • Multi-threaded JavaScript runtime
  • Node.js compatible module architecture with NPM support
  • API for object transportation, object sharing and synchronization across JavaScript threads
  • API for pluggable logging, metric and memory allocator
  • Distributed as a Node.js module, as well as supporting embed scenarios

Documentation

Contribute

You can contribute to Napa.js in following ways:

  • Report issues and help us verify fixes as they are checked in.
  • Review the source code changes.
  • Contribute to core module compatibility with Node.
  • Contribute bug fixes.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

License

Copyright (c) Microsoft Corporation. All rights reserved.

Licensed under the MIT License.