JSPM

  • Created
  • Published
  • Downloads 2631
  • Score
    100M100P100Q102997F
  • License MIT

JSON encoder/decoder for AssemblyScript

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (json-as) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    AS-JSON

    AssemblyScript WebAssembly

    Installation

    ~ npm install json-as
    ~ npm install visitor-as

    For arbitrary-length numbers, use

    ~ npm install as-bignum

    Add the transform to your asc command

    --transform json-as/transform

    Or, add it to asconfig.json

    {
      "options": {
        "transform": ["json-as/transform"]
      }
    }

    Usage

    import { JSON } from "json-as/assembly";
    
    // @json or @serializable work here
    @JSON
    class Vec3 {
      x!: f32;
      y!: f32;
      z!: f32;
    }
    
    @JSON
    class Player {
      firstName!: string;
      lastName!: string;
      lastActive!: i32[];
      age!: i32;
      pos!: Vec3 | null;
      isVerified!: boolean;
    }
    
    const player: Player = {
      firstName: "Emmet",
      lastName: "West",
      lastActive: [8, 27, 2022],
      age: 23,
      pos: {
        x: 3.4,
        y: 1.2,
        z: 8.3
      },
      isVerified: true
    };
    
    const stringified = JSON.stringify<Player>(player);
    
    const parsed = JSON.parse<Player>(stringified);

    Notes

    Performance is nearly equal to the JavaScript JSON implementation which is in C++.

    Performance

    Serialize Object (Vec2): ~7.20m ops/s

    Deserialize Object (Vec2): ~2.2m ops/s

    Serialize Array (int[4]): ~1.4m ops/s

    Deserialize Array (int[4]): ~2.8m ops/s

    Serialize String (5): ~5.2m ops/sw

    Deserialize String (5): ~1.36m ops/s

    Issues

    Please submit an issue to https://github.com/JairusSW/as-json/issues if you find anything wrong with this library