external/uBlock
1
0
Fork 0
mirror of https://github.com/gorhill/uBlock.git synced 2024-11-11 17:41:03 +01:00
Code Issues Projects Releases Packages Wiki Activity
uBlock/src/lib/lz4
History
Raymond Hill 69c87c5117
Fix Promise chain of WASM module load operations 
The Promise chain was not properly designed for WASM module
loading. This became apparent when removing WASM modules
from Opera build[1].

The problem was that errors thrown by fetch() -- used to
load WASM modules -- were not properly handled.

[1] Opera refuses updating uBO if there are unrecognized file
types in the package, and `.wasm`/`.wat` files are not
recognized by Opera uploader.
2019-02-01 08:20:43 -05:00
..
lz4-block-codec-any.js Fix Promise chain of WASM module load operations 2019-02-01 08:20:43 -05:00
lz4-block-codec-js.js Fix Promise chain of WASM module load operations 2019-02-01 08:20:43 -05:00
lz4-block-codec-wasm.js Fix Promise chain of WASM module load operations 2019-02-01 08:20:43 -05:00
lz4-block-codec.wasm reorganize cache storage compression; workaround fix for #2812 2018-08-11 10:39:43 -04:00
lz4-block-codec.wat include source code of lz4-block-codec.wasm for reviewers 2018-10-19 11:56:28 -03:00
README.md Update README.md 2018-10-19 12:02:04 -03:00

README.md

Purpose

The purpose of this library is to implement LZ4 compression/decompression, as documented at the official LZ4 repository:

https://github.com/lz4/lz4/blob/dev/doc/lz4_Block_format.md

The files in this directory are developed as a separate project at:

https://github.com/gorhill/lz4-wasm

Files

lz4-block-codec-any.js

The purpose is to instanciate a WebAssembly- or pure javascript-based LZ4 block codec.

If the choosen implementation is not specified, there will be an attempt to create a WebAssembly-based instance. If for whatever reason this fails, a pure javascript-based instance will be created.

The script for either instance are dynamically loaded and only when needed, such that no resources are wasted by keeping in memory code which won't be used.

lz4-block-codec-wasm.js

This contains the code to instanciate WebAssembly-based LZ4 block codec. Note that the WebAssembly module is loaded using a same-origin fetch, hence ensuring that no code outside the package is loaded.

lz4-block-codec-js.js

This contains the code to instanciate pure javascript-based LZ4 block codec.

This is used as a fallback implementation should WebAssembly not be available for whatever reason.

lz4-block-codec.wasm

This is the WebAssembly module, loaded by lz4-block-codec-wasm.js using a same-origin fetch.

lz4-block-codec.wat

The WebAssembly source code used to generate the WebAssembly module lz4-block-codec.wasm.

wat2wasm ./lz4-block-codec.wat -o ./lz4-block-codec.wasm
wasm-opt ./lz4-block-codec.wasm -O4 -o ./lz4-block-codec.wasm

You can get wat2wasm at https://github.com/WebAssembly/wabt, and wasm-opt at https://github.com/WebAssembly/binaryen.