mirror of
https://github.com/rustwasm/wasm-bindgen.git
synced 2024-12-29 13:06:06 +03:00
guide: Delete "Feature Reference" page
We now have a rather large section for feature reference, and I don't think there is anything in this page that isn't covered elsewhere and in more detail anymore.
This commit is contained in:
parent
9d291187c5
commit
676611020e
@ -13,7 +13,6 @@
|
||||
- [Receiving JS Closures in Rust](./reference/receiving-js-closures-in-rust.md)
|
||||
- [No ES Modules](./reference/no-esm.md)
|
||||
- [Passing Arbitrary data](./reference/passing-data.md)
|
||||
- [Feature Reference](./reference/feature-reference.md)
|
||||
- [Command Line Interface](./reference/cli.md)
|
||||
- [Supported Types](./reference/types.md)
|
||||
- [`#[wasm_bindgen]` Attributes](./reference/attributes/index.md)
|
||||
|
@ -1,51 +0,0 @@
|
||||
# Feature Reference
|
||||
|
||||
Here this section will attempt to be a reference for the various features
|
||||
implemented in this project. This is likely not exhaustive but the [tests]
|
||||
should also be a great place to look for examples.
|
||||
|
||||
[tests]: https://github.com/rustwasm/wasm-bindgen/tree/master/tests
|
||||
|
||||
The `#[wasm_bindgen]` attribute can be attached to functions, structs,
|
||||
impls, and foreign modules. Impls can only contain functions, and the attribute
|
||||
cannot be attached to functions in an impl block or functions in a foreign
|
||||
module. No lifetime parameters or type parameters are allowed on any of these
|
||||
types. Foreign modules must have the `"C"` abi (or none listed). Free functions
|
||||
with `#[wasm_bindgen]` might not have the `"C"` abi or none listed, and it's also not
|
||||
necessary to annotate with the `#[no_mangle]` attribute.
|
||||
|
||||
All structs referenced through arguments to functions should be defined in the
|
||||
macro itself. Arguments allowed implement the `WasmBoundary` trait, and examples
|
||||
are:
|
||||
|
||||
* Integers (u64/i64 require `BigInt` support)
|
||||
* Floats
|
||||
* Borrowed strings (`&str`)
|
||||
* Owned strings (`String`)
|
||||
* Exported structs (`Foo`, annotated with `#[wasm_bindgen]`)
|
||||
* Exported C-like enums (`Foo`, annotated with `#[wasm_bindgen]`)
|
||||
* Imported types in a foreign module annotated with `#[wasm_bindgen]`
|
||||
* Borrowed exported structs (`&Foo` or `&mut Bar`)
|
||||
* The `JsValue` type and `&JsValue` (not mutable references)
|
||||
* Vectors and slices of supported integer types and of the `JsValue` type.
|
||||
* Optional vectors/slices
|
||||
|
||||
All of the above can also be returned except borrowed references. Passing
|
||||
`Vec<JsValue>` as an argument to a function is not currently supported. Strings are
|
||||
implemented with shim functions to copy data in/out of the Rust heap. That is, a
|
||||
string passed to Rust from JS is copied to the Rust heap (using a generated shim
|
||||
to malloc some space) and then will be freed appropriately.
|
||||
|
||||
Owned values are implemented through boxes. When you return a `Foo` it's
|
||||
actually turned into `Box<RefCell<Foo>>` under the hood and returned to JS as a
|
||||
pointer. The pointer is to have a defined ABI, and the `RefCell` is to ensure
|
||||
safety with reentrancy and aliasing in JS. In general you shouldn't see
|
||||
`RefCell` panics with normal usage.
|
||||
|
||||
JS-values-in-Rust are implemented through indexes that index a table generated
|
||||
as part of the JS bindings. This table is managed via the ownership specified in
|
||||
Rust and through the bindings that we're returning. More information about this
|
||||
can be found in the [design doc].
|
||||
|
||||
All of these constructs currently create relatively straightforward code on the
|
||||
JS side of things, mostly having a 1:1 match in Rust with JS.
|
@ -1,7 +1,7 @@
|
||||
# Passing arbitrary data to JS
|
||||
|
||||
It's possible to pass data from Rust to JS not explicitly supported
|
||||
in the [Feature Reference](./feature-reference.md) by serializing via [Serde](https://github.com/serde-rs/serde).
|
||||
It's possible to pass arbirtrary data from Rust to JavaScript by serializing it
|
||||
with [Serde](https://github.com/serde-rs/serde).
|
||||
|
||||
`wasm-bindgen` includes the `JsValue` type, which streamlines serializing and deserializing.
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user