Zstandard compression and decompression and base64 encoding and decoding in WebAssembly.
npm install @itk-wasm/compress-stringify
Import:
import {
compressStringify,
parseStringDecompress,
setPipelinesBaseUrl,
getPipelinesBaseUrl,
} from "@itk-wasm/compress-stringify"
Given a binary, compress and optionally base64 encode.
async function compressStringify(
input: Uint8Array,
options: CompressStringifyOptions = {}
) : Promise<CompressStringifyResult>
Parameter | Type | Description |
---|---|---|
input |
Uint8Array | Input binary |
CompressStringifyOptions
interface:
Property | Type | Description |
---|---|---|
stringify |
boolean | Stringify the output |
compressionLevel |
number | Compression level, typically 1-9 |
dataUrlPrefix |
string | dataURL prefix |
webWorker |
null or Worker or boolean | WebWorker for computation. Set to null to create a new worker. Or, pass an existing worker. Or, set to false to run in the current thread / worker. |
noCopy |
boolean | When SharedArrayBuffer's are not available, do not copy inputs. |
CompressStringifyResult
interface:
Property | Type | Description |
---|---|---|
output |
Uint8Array | Output compressed binary |
webWorker |
Worker | WebWorker used for computation. |
Given a binary or string produced with compress-stringify, decompress and optionally base64 decode.
async function parseStringDecompress(
input: Uint8Array,
options: ParseStringDecompressOptions = {}
) : Promise<ParseStringDecompressResult>
Parameter | Type | Description |
---|---|---|
input |
Uint8Array | Compressed input |
ParseStringDecompressOptions
interface:
Property | Type | Description |
---|---|---|
parseString |
boolean | Parse the input string before decompression |
webWorker |
null or Worker or boolean | WebWorker for computation. Set to null to create a new worker. Or, pass an existing worker. Or, set to false to run in the current thread / worker. |
noCopy |
boolean | When SharedArrayBuffer's are not available, do not copy inputs. |
ParseStringDecompressResult
interface:
Property | Type | Description |
---|---|---|
output |
Uint8Array | Output decompressed binary |
webWorker |
Worker | WebWorker used for computation. |
Set base URL for WebAssembly assets when vendored.
function setPipelinesBaseUrl(
baseUrl: string | URL
) : void
Get base URL for WebAssembly assets when vendored.
function getPipelinesBaseUrl() : string | URL
Import:
import {
compressStringifyNode,
parseStringDecompressNode,
} from "@itk-wasm/compress-stringify"
Given a binary, compress and optionally base64 encode.
async function compressStringifyNode(
input: Uint8Array,
options: CompressStringifyNodeOptions = {}
) : Promise<CompressStringifyNodeResult>
Parameter | Type | Description |
---|---|---|
input |
Uint8Array | Input binary |
CompressStringifyNodeOptions
interface:
Property | Type | Description |
---|---|---|
stringify |
boolean | Stringify the output |
compressionLevel |
number | Compression level, typically 1-9 |
dataUrlPrefix |
string | dataURL prefix |
CompressStringifyNodeResult
interface:
Property | Type | Description |
---|---|---|
output |
Uint8Array | Output compressed binary |
Given a binary or string produced with compress-stringify, decompress and optionally base64 decode.
async function parseStringDecompressNode(
input: Uint8Array,
options: ParseStringDecompressNodeOptions = {}
) : Promise<ParseStringDecompressNodeResult>
Parameter | Type | Description |
---|---|---|
input |
Uint8Array | Compressed input |
ParseStringDecompressNodeOptions
interface:
Property | Type | Description |
---|---|---|
parseString |
boolean | Parse the input string before decompression |
ParseStringDecompressNodeResult
interface:
Property | Type | Description |
---|---|---|
output |
Uint8Array | Output decompressed binary |