fluencelabs/wasm-bindgen
1
0
Fork 0
mirror of https://github.com/fluencelabs/wasm-bindgen synced 2025-04-02 10:21:07 +00:00
Code Issues Projects Releases Wiki Activity
wasm-bindgen/guide/src/reference/attributes/on-js-imports/raw_module.md
Alex Crichton 0d592fffb0 Add a raw_module attribute to #[wasm_bindgen] 
This allows subverting the checks and resolution performed by the
`module` attribute added as part of [RFC 6] and has been discussed in #1343.

Closes #1343

[RFC 6]: https://github.com/rustwasm/rfcs/pull/6
2019-03-15 08:08:09 -07:00

734 B
Raw Blame History

raw_module = "blah"

This attribute performs exactly the same purpose as the module attribute on JS imports, but it does not attempt to interpret paths starting with ./, ../, or / as JS snippets. For example:

#[wasm_bindgen(raw_module = "./some/js/file.js")]
extern "C" {
    fn the_function();
}

Note that if you use this attribute with a relative or absolute path, it's likely up to the final bundler or project to assign meaning to that path. This typically means that the JS file or module will be resolved relative to the final location of the wasm file itself. That means that raw_module is likely unsuitable for libraries on crates.io, but may be usable within end-user applications.