Wondering what’s next for npm?Check out our public roadmap! »

    TypeScript icon, indicating that this package has built-in type declarations

    3.1.2 • Public • Published



    npm install node-weakauras-parser
    # or
    yarn add node-weakauras-parser

    The package is pre-built for the following environments (Haswell is used as the target arch):

    OS Node 10 Node 12 Node 14 Node 15
    Linux glibc (x86_64) ✔️ ✔️ ✔️ ✔️
    Linux musl-libc (x86_64) ✔️ ✔️ ✔️ ✔️
    macOS (x86_64) ✔️ ✔️ ✔️ ✔️
    Windows (x86_64) ✔️ ✔️ ✔️ ✔️

    If you use something else, you will need Rust and zlib in order to build from source code.

    If you are getting SIGILL, your CPU does not support some of the instructions that Haswell does. To fix that, you will have to build from source code.


    Non-blocking version:

    const parser = require('node-weakauras-parser');
    (async function() {
        const source = { test: 1 };
        const encoded = await parser.encode(source);
        const decoded = await parser.decode(encoded);
        console.log(JSON.stringify(source) === JSON.stringify(decoded));

    Blocking version (slightly faster, but blocks the event loop):

    const parser = require('node-weakauras-parser');
    const source = { test: 1 };
    const encoded = parser.encodeSync(source);
    const decoded = parser.decodeSync(encoded);
    console.log(JSON.stringify(source) === JSON.stringify(decoded));

    Both decode() and decodeSync() accept an optional argument to configure the memory usage limit for decompression (in bytes). Default value is 8 MBs. You can pass +Infinity to disable it.

    Known issues

    • Table references from LibSerialize are not fully supported. For example, self-referential tables (or tables referencing an ancestor) will cause an error. As far as I know, those cannot be stored in SavedVariables.lua, so it shouldn't be an issue with WA strings.

    Major changes


    • encode() now uses a new serialization algorithm adopted by WA in v2.18.


    • encode() and decode() in v2 still spent majority of their time on the main thread, thus blocking the event loop. This is no longer the case but infinite numbers are no longer supported;
    • Functions now return proper Error objects instead of strings.


    • encode() and decode() are now non-blocking;
    • Old, blocking, implementations are available as encodeSync() and decodeSync().


    The project is licensed under MIT License, unless stated otherwise in a source file.


    npm i node-weakauras-parser

    DownloadsWeekly Downloads






    Unpacked Size

    141 kB

    Total Files


    Last publish


    • avatar