| commit | ba0680f642cc66b383e69ac8631642a1753c00c8 | [log] [tgz] |
|---|---|---|
| author | Ali Ghassemi <aghassemi@google.com> | Fri May 08 10:59:00 2015 -0700 |
| committer | Ali Ghassemi <aghassemi@google.com> | Fri May 08 10:59:02 2015 -0700 |
| tree | e0628d279fe3ab98919b731a5f5bcd04b97d9932 | |
| parent | acdbe574c4df7a00d75530fd27ffcca5bf1c76f9 [diff] |
core.js: Adding an example which shows service methods to jsdocs. this is needed to help ensure devs realize they need to include ctx and serverCall as first two params and also to show an async method with both Promise and Callback way of doing it. Change-Id: Id5bfe11bd05bb72bb4e2a70d4671bcd60c752d66
This repository defines the JavaScript API for Vanadium. The client and server APIs defined here work both in Node.js and the browser.
npm can be used to install this library:
npm install --save git@github.com:vanadium/js.git
Documentation for this API is available at https://jsdoc.v.io/ Tutorials can be found at https://v.io/tutorials/javascript/
The entry point to the API is through a module called vanadium, everything else is considered private and should not be accessed by the users of the API.
The vanadium module is exported as a global in the browser JavaScript library and for Browserify and Node.js the “main” property in the package.json points to /src/vanadium making it the index module and therefore Browserify and Node.js users can gain access to the API with:
var vanadium = require("vanadium");
One of the goals of this project is to only write the code once and have it run in both Node.js and browsers. Therefore, specific build and testing steps have been designed in the project to ensure this goal.
When run in a browser, vanadium.js expects that the vanadium extension will be installed.
Bugs and feature requests should be filed in the Vanadium issue tracker.
GNU Make is used to build and test Vanadium.
Build everything:
make build
Test everything:
make test
Run a specific test suite:
make test-unit make test-unit-node make test-unit-browser make test-integration make test-integration-node make test-integration-browser
Remove all build and testing artifacts:
make clean