Skip to main content
Star us on GitHub Star

Chrome Origin Trials

BrowZer uses JSPI, or WebAssembly JSPI (JavaScript Promise Integration). This is a new API to bridge JavaScript Promises with WebAssembly workflows and is vital to BrowZer's workflow.

::: note JSPI is still in review and not fully adopted by Chromium-based browsers

JSPI can be enabled in multiple ways, including:

  • by the end-user of the browser, by enabling the flag (down in chrome://flags)
  • via what is known as an "Origin Trial 3"

Some browsers (like Edge) have recently stopped making the JSPI flag available in the edge://flags UI for users to update. The only way to enable JSPI for these browsers is via a Chrome Origin Trial.

It also is a better overall experience for end users. These users never need to manually enable JSPI or even know JSPI exists. Origin Trials will transparently enable the JSPI flag for the end-user of your BrowZer-protected web app.

Sign Up

To sign up for the Origin Trial you need to:

  • visit this page and register for the JavaScript Promise Integration Trial. It's free.
  • Sign in to Google using the button in the upper right corner
  • fill in the fields
    • Web Origin: this should be your "wildcard url". If you obtained a wildcard cert for *.mybrowzer.example.com, you would enter mybrowzer.example.com in this field
    • Check the "I need a token to match all subdomains of the origin"
    • Fill out the expected usage
    • Check all the checkboxes for the disclosures and acknowledgements after understanding them
    • Click Register

After filling out the fields you'll receive a token. Save/copy the token. The token will be needed when you configure your BrowZer instance.