RustJS

info What is RustJS?

RustJS is an engine that is able to convert Rust code into native JavaScript, so that it can run directly on the browser without issues instead of heavy web-assembly. This project is also open-source, so if you'd like to suggest any changes, please, consider making a pull request on GitHub.

help Does it contain all of Rust?

Currently, no. Some parts may be tricky to implement, but some core features are there and (hopefully) everything will have been implemented some time into the near future.

download How to Install (Also in README.md)

Static

The files for RustJS are hosted on this very site, so to install RustJS, all you need to do is:

• Add a <script> tag inside your HTML file. Place it before any runner files to avoid scope errors.
• Set the source of the script to the latest version of RustJS. This site will automatically serve the latest version of RustJS if specified.

            <script src="https://rustjs.netlify.app/cdn/rustjs/latest"></script>
        

You should be all set now. In order to actually use RustJS, first, call the function rustjs.init(). Then to do the conversion, simply add rustjs.convert() anywhere after RustJS is initialised. Make sure to add the Rust code you would like to convert as the parameter. The function will return the JavaScript code.

npm / Node.js

Currently not supported in v0.1.
Support for Node.js will be added in a future release — so stay tuned for that.

integration_instructions Using RustJS

Using RustJS is simple. To initialise, simply call rustjs.init(). And to convert any code directly to JavaScript, all you have to do is call rustjs.convert().
Below shows an example involving Microsoft's Monaco Editor.

            // Initialise the package:
            rustjs.init();
            // Monaco Example (assuming it already exists):
            rustjs.convert(window.editor.getValue());
        

            <script src="https://rustjs.netlify.app/cdn/rustjs/v0.1"></script>