Amazon Ion 的 JavaScript 实现。
An implementation of Amazon Ion for JavaScript written in TypeScript. This package is tested with Node JS major versions 14, 16, and 18. While this library should be usable within browsers that support ES5+, please note that it is not currently being tested in any browser environments.
You can use this library either as a Node.js module or inside an HTML page.
Add ion-js to your dependencies using npm
npm install --save ion-jsUse the library to read/write Ion data. Here is an example that reads Ion data from a JavaScript string:
let ion = require("ion-js");
// Reading
let ionData = '{ greeting: "Hello", name: "Ion" }';
let value = ion.load(ionData);
console.log(value.greeting + ", " + value.name + "!");
// Writing
let ionText = ion.dumpText(value);
console.log("Serialized Ion: " + ionText);For more examples, see the Ion DOM README.
Note: if your package's public interface exposes part of this library, this library should be specified as a peer dependency in your package's package.json file. Otherwise, packages that depend on your package and this library may experience unexpected behavior, as two installations of this library (even if the same version) are not designed or tested to behave correctly.
You can include the Ion-js bundle (ES5 compatible) using the URLs
These will create and initialize window.ion which has the same exact API as our npm package. Here is an example
TypeDoc generated documentation can be found at here. Please note that anything not documented in the the API documentation is not supported for public use and is subject to change in any version.
This repository contains a git submodule
called ion-tests, which holds test data used by ion-js's unit tests.
The easiest way to clone the ion-js repository and initialize its ion-tests
submodule is to run the following command.
$ git clone --recursive https://github.com/amazon-ion/ion-js.git ion-jsAlternatively, the submodule may be initialized independently from the clone by running the following commands.
$ git submodule init
$ git submodule updateUse npm to setup the dependencies. In the project directory you can run the following:
$ npm installBuilding the package can be done with the release script (which runs the tests).
$ npm run releaseTests can be run using npm as well
$ npm testThis package uses Grunt for its build tasks. For convenience, you may want to install this globally:
$ npm -g install grunt-cli
$ grunt releaseOr you could use the locally installed Grunt:
$ ./node_modules/.bin/grunt releaseThe build above will compile the library into the dist directory. This directory has subdirectories of
the form /. In general, we target ES6 and rely on polyfills to support earlier
versions.
dist/es6/es6 - Targets the ES6 module system and ES6dist/commonjs/es6 - Targets the CommonJS module system and ES6 dist/amd/es6 - Targets the AMD module system and ES6A distribution using browserify and babelify creates a browser friendly polyfilled distribution targeting ES5:
at dist/browser/js/ion-bundle.js.
| Types | IonText | IonBinary | Limitations |
|---|---|---|---|
null |
yes | yes | none |
bool |
yes | yes | none |
int |
yes | yes | underscores, binary digits |
float |
yes | yes | underscores |
decimal |
yes | yes | none |
timestamp |
yes | yes | none |
string |
yes | yes | none |
symbol |
yes | yes | $0, symbol tokens |
blob |
yes | yes | none |
clob |
yes | yes | none |
struct |
yes | yes | none |
list |
yes | yes | none |
sexp |
yes | yes | none |
| annotations | yes | yes | none |
| local symbol tables | yes | yes | none |
| shared symbol tables | no | yes | none |
Notes:
test/iontests.ts defines multiple skipList variables referencing test vectors that are not expected to work at this time.
ion-js supports shared symbol table for Ion Binary. Below is an example of how shared symbol table can be used here:
…See CONTRIBUTING.md
This library is licensed under Apache License version 2.0
For more information about Ion or its other implementation, please see:
暂无开放 Issues,或尚未同步最近议题。