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

1.1.0 • Public • Published


npm version

An easy experience for encoding and decoding JPEG XL images in the browser. Powered by WebAssembly ⚡️.

⚠️ No stable browser release supports displaying JPEG XL yet. This package is intended for experimentation and testing.

Uses the libjxl library.

A jSquash package. Codecs and supporting code derived from the Squoosh app.


npm install --save @jsquash/jxl
# Or your favourite package manager alternative


Note: You will need to either manually include the wasm files from the codec directory or use a bundler like WebPack or Rollup to include them in your app/server.

decode(data: ArrayBuffer): Promise

Decodes JPEG XL binary ArrayBuffer to raw RGB image data.


Type: ArrayBuffer


import { decode } from '@jsquash/jxl';

const formEl = document.querySelector('form');
const formData = new FormData(formEl);
// Assuming user selected an input JPEG XL file
const imageData = await decode(await formData.get('image').arrayBuffer());

encode(data: ImageData, options?: EncodeOptions): Promise

Encodes raw RGB image data to JPEG format and resolves to an ArrayBuffer of binary data.


Type: ImageData


Type: Partial<EncodeOptions>

The JPEG XL encoder options for the output image. See default values.


import { encode } from '@jsquash/jxl';

async function loadImage(src) {
  const img = document.createElement('img');
  img.src = src;
  await new Promise(resolve => img.onload = resolve);
  const canvas = document.createElement('canvas');
  [canvas.width, canvas.height] = [img.width, img.height];
  const ctx = canvas.getContext('2d');
  ctx.drawImage(img, 0, 0);
  return ctx.getImageData(0, 0, img.width, img.height);

const rawImageData = await loadImage('/example.png');
const jpegBuffer = await encode(rawImageData);

Manual WASM initialisation (not recommended)

In most situations there is no need to manually initialise the provided WebAssembly modules. The generated glue code takes care of this and supports most web bundlers.

One situation where this arises is when using the modules in Cloudflare Workers (See the README for more info).

The encode and decode modules both export an init function that can be used to manually load the wasm module.

import decode, { init as initJXLDecode } from '@jsquash/jxl/decode';

initJXLDecode(WASM_MODULE); // The `WASM_MODULE` variable will need to be sourced by yourself and passed as an ArrayBuffer.
const image = await fetch('./image.jpeg').then(res => res.arrayBuffer()).then(decode);

Known Issues

See jSquash Project README

Package Sidebar


npm i @jsquash/jxl

Weekly Downloads






Unpacked Size

5.87 MB

Total Files


Last publish


  • jamsinclair