1
0
Fork 0
mirror of https://github.com/Luzifer/wasm-openssl.git synced 2024-11-08 14:50:10 +00:00
wasm-openssl/README.md
Knut Ahlers 17e3802b9c
Update META
Signed-off-by: Knut Ahlers <knut@ahlers.me>
2018-09-18 18:52:37 +02:00

2 KiB

Go Report Card

Luzifer / wasm-openssl

wasm-openssl is a WASM wrapper around go-openssl to be used in Javascript projects.

Usage

You will need to have wasm_exec.js installed in your project to load the binary:

$ curl -sSfLo wasm_exec.js "https://raw.githubusercontent.com/golang/go/go1.11/misc/wasm/wasm_exec.js"

Afterwards in your HTML you can include the wasm_exec.js and load the binary:

<!doctype html>
<html>
  <head>
    <meta charset="utf-8">
  </head>
  <body>
    <script src="wasm_exec.js"></script>
    <script>
      function opensslLoaded() { console.log("openssl.wasm loaded") }

      const go = new Go()
      WebAssembly.instantiateStreaming(fetch("openssl.wasm"), go.importObject).then(async obj => await go.run(obj.instance))
    </script>
  </body>
</html>

Be sure to have a top-level function opensslLoaded() defined as this will be called in the initialization of the openssl.wasm. This serves as a notification you do have now access to the top-level functions encrypt and decrypt:

function decrypt(ciphertext, passphrase, callback) {}
function encrypt(plaintext, passphrase, callback) {}

The functions will not return anything in the moment as in the current state Go WASM support does not have return values. Instead the callback function you've provided will be called and always have two arguments: function callback(result, error) - The result will be the plaintext on decrypt and the ciphertext on encrypt. The error will either be null or a string containing details about the error. When an error occurred the result is null.