//! Runtime support for the `wasm-bindgen` tool //! //! This crate contains the runtime support necessary for `wasm-bindgen` the //! attribute and tool. Crates pull in the `#[wasm_bindgen]` attribute through //! this crate and this crate also provides JS bindings through the `JsValue` //! interface. #![no_std] #![doc(html_root_url = "https://docs.rs/wasm-bindgen/0.2")] #![cfg_attr(feature = "nightly", feature(unsize))] use core::fmt; use core::marker; use core::mem; use core::ops::{Deref, DerefMut}; use crate::convert::FromWasmAbi; macro_rules! if_std { ($($i:item)*) => ($( #[cfg(feature = "std")] $i )*) } macro_rules! externs { ($(#[$attr:meta])* extern "C" { $(fn $name:ident($($args:tt)*) -> $ret:ty;)* }) => ( #[cfg(all(target_arch = "wasm32", not(target_os = "emscripten")))] $(#[$attr])* extern "C" { $(fn $name($($args)*) -> $ret;)* } $( #[cfg(not(all(target_arch = "wasm32", not(target_os = "emscripten"))))] #[allow(unused_variables)] unsafe extern fn $name($($args)*) -> $ret { panic!("function not implemented on non-wasm32 targets") } )* ) } /// A module which is typically glob imported from: /// /// ``` /// use wasm_bindgen::prelude::*; /// ``` pub mod prelude { pub use crate::JsValue; pub use crate::UnwrapThrowExt; #[doc(hidden)] pub use wasm_bindgen_macro::__wasm_bindgen_class_marker; pub use wasm_bindgen_macro::wasm_bindgen; if_std! { pub use crate::closure::Closure; } } pub mod convert; pub mod describe; mod cast; pub use crate::cast::JsCast; if_std! { extern crate std; use std::prelude::v1::*; pub mod closure; mod anyref; mod cache; pub use cache::intern::intern; } /// Representation of an object owned by JS. /// /// A `JsValue` doesn't actually live in Rust right now but actually in a table /// owned by the `wasm-bindgen` generated JS glue code. Eventually the ownership /// will transfer into wasm directly and this will likely become more efficient, /// but for now it may be slightly slow. pub struct JsValue { idx: u32, _marker: marker::PhantomData<*mut u8>, // not at all threadsafe } const JSIDX_OFFSET: u32 = 32; // keep in sync with js/mod.rs const JSIDX_UNDEFINED: u32 = JSIDX_OFFSET + 0; const JSIDX_NULL: u32 = JSIDX_OFFSET + 1; const JSIDX_TRUE: u32 = JSIDX_OFFSET + 2; const JSIDX_FALSE: u32 = JSIDX_OFFSET + 3; const JSIDX_RESERVED: u32 = JSIDX_OFFSET + 4; impl JsValue { /// The `null` JS value constant. pub const NULL: JsValue = JsValue { idx: JSIDX_NULL, _marker: marker::PhantomData, }; /// The `undefined` JS value constant. pub const UNDEFINED: JsValue = JsValue { idx: JSIDX_UNDEFINED, _marker: marker::PhantomData, }; /// The `true` JS value constant. pub const TRUE: JsValue = JsValue { idx: JSIDX_TRUE, _marker: marker::PhantomData, }; /// The `false` JS value constant. pub const FALSE: JsValue = JsValue { idx: JSIDX_FALSE, _marker: marker::PhantomData, }; #[inline] fn _new(idx: u32) -> JsValue { JsValue { idx, _marker: marker::PhantomData, } } /// Creates a new JS value which is a string. /// /// The utf-8 string provided is copied to the JS heap and the string will /// be owned by the JS garbage collector. #[inline] pub fn from_str(s: &str) -> JsValue { unsafe { JsValue::_new(__wbindgen_string_new(s.as_ptr(), s.len())) } } /// Creates a new JS value which is a number. /// /// This function creates a JS value representing a number (a heap /// allocated number) and returns a handle to the JS version of it. #[inline] pub fn from_f64(n: f64) -> JsValue { unsafe { JsValue::_new(__wbindgen_number_new(n)) } } /// Creates a new JS value which is a boolean. /// /// This function creates a JS object representing a boolean (a heap /// allocated boolean) and returns a handle to the JS version of it. #[inline] pub fn from_bool(b: bool) -> JsValue { if b { JsValue::TRUE } else { JsValue::FALSE } } /// Creates a new JS value representing `undefined`. #[inline] pub fn undefined() -> JsValue { JsValue::UNDEFINED } /// Creates a new JS value representing `null`. #[inline] pub fn null() -> JsValue { JsValue::NULL } /// Creates a new JS symbol with the optional description specified. /// /// This function will invoke the `Symbol` constructor in JS and return the /// JS object corresponding to the symbol created. pub fn symbol(description: Option<&str>) -> JsValue { unsafe { match description { Some(description) => JsValue::_new(__wbindgen_symbol_named_new( description.as_ptr(), description.len(), )), None => JsValue::_new(__wbindgen_symbol_anonymous_new()), } } } /// Creates a new `JsValue` from the JSON serialization of the object `t` /// provided. /// /// This function will serialize the provided value `t` to a JSON string, /// send the JSON string to JS, parse it into a JS object, and then return /// a handle to the JS object. This is unlikely to be super speedy so it's /// not recommended for large payloads, but it's a nice to have in some /// situations! /// /// Usage of this API requires activating the `serde-serialize` feature of /// the `wasm-bindgen` crate. /// /// # Errors /// /// Returns any error encountered when serializing `T` into JSON. #[cfg(feature = "serde-serialize")] pub fn from_serde(t: &T) -> serde_json::Result where T: serde::ser::Serialize + ?Sized, { let s = serde_json::to_string(t)?; unsafe { Ok(JsValue::_new(__wbindgen_json_parse(s.as_ptr(), s.len()))) } } /// Invokes `JSON.stringify` on this value and then parses the resulting /// JSON into an arbitrary Rust value. /// /// This function will first call `JSON.stringify` on the `JsValue` itself. /// The resulting string is then passed into Rust which then parses it as /// JSON into the resulting value. /// /// Usage of this API requires activating the `serde-serialize` feature of /// the `wasm-bindgen` crate. /// /// # Errors /// /// Returns any error encountered when parsing the JSON into a `T`. #[cfg(feature = "serde-serialize")] pub fn into_serde(&self) -> serde_json::Result where T: for<'a> serde::de::Deserialize<'a>, { unsafe { let mut ret = [0usize; 2]; __wbindgen_json_serialize(&mut ret, self.idx); let s = Vec::from_raw_parts(ret[0] as *mut u8, ret[1], ret[1]); let s = String::from_utf8_unchecked(s); serde_json::from_str(&s) } } /// Returns the `f64` value of this JS value if it's an instance of a /// number. /// /// If this JS value is not an instance of a number then this returns /// `None`. pub fn as_f64(&self) -> Option { let mut invalid = 0; unsafe { let ret = __wbindgen_number_get(self.idx, &mut invalid); if invalid == 1 { None } else { Some(ret) } } } /// Tests whether this JS value is a JS string. pub fn is_string(&self) -> bool { unsafe { __wbindgen_is_string(self.idx) == 1 } } /// If this JS value is a string value, this function copies the JS string /// value into wasm linear memory, encoded as UTF-8, and returns it as a /// Rust `String`. /// /// To avoid the copying and re-encoding, consider the /// `JsString::try_from()` function from [js-sys](https://docs.rs/js-sys) /// instead. /// /// If this JS value is not an instance of a string or if it's not valid /// utf-8 then this returns `None`. /// /// # UTF-16 vs UTF-8 /// /// JavaScript strings in general are encoded as UTF-16, but Rust strings /// are encoded as UTF-8. This can cause the Rust string to look a bit /// different than the JS string sometimes. For more details see the /// [documentation about the `str` type][caveats] which contains a few /// caveats about the encodings. /// /// [caveats]: https://rustwasm.github.io/docs/wasm-bindgen/reference/types/str.html #[cfg(feature = "std")] pub fn as_string(&self) -> Option { unsafe { let mut len = 0; let ptr = __wbindgen_string_get(self.idx, &mut len); if ptr.is_null() { None } else { let data = Vec::from_raw_parts(ptr, len, len); Some(String::from_utf8_unchecked(data)) } } } /// Returns the `bool` value of this JS value if it's an instance of a /// boolean. /// /// If this JS value is not an instance of a boolean then this returns /// `None`. pub fn as_bool(&self) -> Option { unsafe { match __wbindgen_boolean_get(self.idx) { 0 => Some(false), 1 => Some(true), _ => None, } } } /// Tests whether this JS value is `null` #[inline] pub fn is_null(&self) -> bool { unsafe { __wbindgen_is_null(self.idx) == 1 } } /// Tests whether this JS value is `undefined` #[inline] pub fn is_undefined(&self) -> bool { unsafe { __wbindgen_is_undefined(self.idx) == 1 } } /// Tests whether the type of this JS value is `symbol` #[inline] pub fn is_symbol(&self) -> bool { unsafe { __wbindgen_is_symbol(self.idx) == 1 } } /// Tests whether `typeof self == "object" && self !== null`. #[inline] pub fn is_object(&self) -> bool { unsafe { __wbindgen_is_object(self.idx) == 1 } } /// Tests whether the type of this JS value is `function`. #[inline] pub fn is_function(&self) -> bool { unsafe { __wbindgen_is_function(self.idx) == 1 } } /// Tests whether the value is ["truthy"]. /// /// ["truthy"]: https://developer.mozilla.org/en-US/docs/Glossary/Truthy #[inline] pub fn is_truthy(&self) -> bool { !self.is_falsy() } /// Tests whether the value is ["falsy"]. /// /// ["falsy"]: https://developer.mozilla.org/en-US/docs/Glossary/Falsy #[inline] pub fn is_falsy(&self) -> bool { unsafe { __wbindgen_is_falsy(self.idx) == 1 } } /// Get a string representation of the JavaScript object for debugging #[cfg(feature = "std")] fn as_debug_string(&self) -> String { unsafe { let mut ret = [0; 2]; __wbindgen_debug_string(&mut ret, self.idx); let data = Vec::from_raw_parts(ret[0] as *mut u8, ret[1], ret[1]); String::from_utf8_unchecked(data) } } } impl PartialEq for JsValue { #[inline] fn eq(&self, other: &JsValue) -> bool { unsafe { __wbindgen_jsval_eq(self.idx, other.idx) != 0 } } } impl PartialEq for JsValue { #[inline] fn eq(&self, other: &bool) -> bool { self.as_bool() == Some(*other) } } impl PartialEq for JsValue { #[inline] fn eq(&self, other: &str) -> bool { *self == JsValue::from_str(other) } } impl<'a> PartialEq<&'a str> for JsValue { #[inline] fn eq(&self, other: &&'a str) -> bool { >::eq(self, other) } } if_std! { impl PartialEq for JsValue { #[inline] fn eq(&self, other: &String) -> bool { >::eq(self, other) } } impl<'a> PartialEq<&'a String> for JsValue { #[inline] fn eq(&self, other: &&'a String) -> bool { >::eq(self, other) } } } impl<'a> From<&'a str> for JsValue { #[inline] fn from(s: &'a str) -> JsValue { JsValue::from_str(s) } } if_std! { impl<'a> From<&'a String> for JsValue { #[inline] fn from(s: &'a String) -> JsValue { JsValue::from_str(s) } } impl From for JsValue { #[inline] fn from(s: String) -> JsValue { JsValue::from_str(&s) } } } impl From for JsValue { #[inline] fn from(s: bool) -> JsValue { JsValue::from_bool(s) } } impl<'a, T> From<&'a T> for JsValue where T: JsCast, { #[inline] fn from(s: &'a T) -> JsValue { s.as_ref().clone() } } impl From> for JsValue where JsValue: From, { #[inline] fn from(s: Option) -> JsValue { match s { Some(s) => s.into(), None => JsValue::undefined(), } } } impl JsCast for JsValue { // everything is a `JsValue`! #[inline] fn instanceof(_val: &JsValue) -> bool { true } #[inline] fn unchecked_from_js(val: JsValue) -> Self { val } #[inline] fn unchecked_from_js_ref(val: &JsValue) -> &Self { val } } impl AsRef for JsValue { #[inline] fn as_ref(&self) -> &JsValue { self } } macro_rules! numbers { ($($n:ident)*) => ($( impl PartialEq<$n> for JsValue { #[inline] fn eq(&self, other: &$n) -> bool { self.as_f64() == Some(f64::from(*other)) } } impl From<$n> for JsValue { #[inline] fn from(n: $n) -> JsValue { JsValue::from_f64(n.into()) } } )*) } numbers! { i8 u8 i16 u16 i32 u32 f32 f64 } externs! { #[link(wasm_import_module = "__wbindgen_placeholder__")] extern "C" { fn __wbindgen_object_clone_ref(idx: u32) -> u32; fn __wbindgen_object_drop_ref(idx: u32) -> (); fn __wbindgen_string_new(ptr: *const u8, len: usize) -> u32; fn __wbindgen_number_new(f: f64) -> u32; fn __wbindgen_symbol_named_new(ptr: *const u8, len: usize) -> u32; fn __wbindgen_symbol_anonymous_new() -> u32; fn __wbindgen_anyref_heap_live_count() -> u32; fn __wbindgen_is_null(idx: u32) -> u32; fn __wbindgen_is_undefined(idx: u32) -> u32; fn __wbindgen_is_symbol(idx: u32) -> u32; fn __wbindgen_is_object(idx: u32) -> u32; fn __wbindgen_is_function(idx: u32) -> u32; fn __wbindgen_is_string(idx: u32) -> u32; fn __wbindgen_is_falsy(idx: u32) -> u32; fn __wbindgen_number_get(idx: u32, invalid: *mut u8) -> f64; fn __wbindgen_boolean_get(idx: u32) -> u32; fn __wbindgen_string_get(idx: u32, len: *mut usize) -> *mut u8; fn __wbindgen_debug_string(ret: *mut [usize; 2], idx: u32) -> (); fn __wbindgen_throw(a: *const u8, b: usize) -> !; fn __wbindgen_rethrow(a: u32) -> !; fn __wbindgen_cb_drop(idx: u32) -> u32; fn __wbindgen_cb_forget(idx: u32) -> (); fn __wbindgen_describe(v: u32) -> (); fn __wbindgen_describe_closure(a: u32, b: u32, c: u32) -> u32; fn __wbindgen_json_parse(ptr: *const u8, len: usize) -> u32; fn __wbindgen_json_serialize(ret: *mut [usize; 2], idx: u32) -> (); fn __wbindgen_jsval_eq(a: u32, b: u32) -> u32; fn __wbindgen_memory() -> u32; fn __wbindgen_module() -> u32; fn __wbindgen_function_table() -> u32; } } impl Clone for JsValue { #[inline] fn clone(&self) -> JsValue { unsafe { let idx = __wbindgen_object_clone_ref(self.idx); JsValue::_new(idx) } } } #[cfg(feature = "std")] impl fmt::Debug for JsValue { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "JsValue({})", self.as_debug_string()) } } #[cfg(not(feature = "std"))] impl fmt::Debug for JsValue { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { f.write_str("JsValue") } } impl Drop for JsValue { #[inline] fn drop(&mut self) { unsafe { // We definitely should never drop anything in the stack area debug_assert!(self.idx >= JSIDX_OFFSET, "free of stack slot {}", self.idx); // Otherwise if we're not dropping one of our reserved values, // actually call the intrinsic. See #1054 for eventually removing // this branch. if self.idx >= JSIDX_RESERVED { __wbindgen_object_drop_ref(self.idx); } } } } /// Wrapper type for imported statics. /// /// This type is used whenever a `static` is imported from a JS module, for /// example this import: /// /// ```ignore /// #[wasm_bindgen] /// extern "C" { /// static console: JsValue; /// } /// ``` /// /// will generate in Rust a value that looks like: /// /// ```ignore /// static console: JsStatic = ...; /// ``` /// /// This type implements `Deref` to the inner type so it's typically used as if /// it were `&T`. #[cfg(feature = "std")] pub struct JsStatic { #[doc(hidden)] pub __inner: &'static std::thread::LocalKey, } #[cfg(feature = "std")] impl Deref for JsStatic { type Target = T; fn deref(&self) -> &T { // We know that our tls key is never overwritten after initialization, // so it should be safe (on that axis at least) to hand out a reference // that lives longer than the closure below. // // FIXME: this is not sound if we ever implement thread exit hooks on // wasm, as the pointer will eventually be invalidated but you can get // `&'static T` from this interface. We... probably need to deprecate // and/or remove this interface nowadays. unsafe { self.__inner.with(|ptr| &*(ptr as *const T)) } } } #[cold] #[inline(never)] #[deprecated(note = "renamed to `throw_str`")] #[doc(hidden)] pub fn throw(s: &str) -> ! { throw_str(s) } /// Throws a JS exception. /// /// This function will throw a JS exception with the message provided. The /// function will not return as the wasm stack will be popped when the exception /// is thrown. /// /// Note that it is very easy to leak memory with this function because this /// function, unlike `panic!` on other platforms, **will not run destructors**. /// It's recommended to return a `Result` where possible to avoid the worry of /// leaks. #[cold] #[inline(never)] pub fn throw_str(s: &str) -> ! { unsafe { __wbindgen_throw(s.as_ptr(), s.len()); } } /// Rethrow a JS exception /// /// This function will throw a JS exception with the JS value provided. This /// function will not return and the wasm stack will be popped until the point /// of entry of wasm itself. /// /// Note that it is very easy to leak memory with this function because this /// function, unlike `panic!` on other platforms, **will not run destructors**. /// It's recommended to return a `Result` where possible to avoid the worry of /// leaks. #[cold] #[inline(never)] pub fn throw_val(s: JsValue) -> ! { unsafe { let idx = s.idx; mem::forget(s); __wbindgen_rethrow(idx); } } /// Get the count of live `anyref`s / `JsValue`s in `wasm-bindgen`'s heap. /// /// ## Usage /// /// This is intended for debugging and writing tests. /// /// To write a test that asserts against unnecessarily keeping `anref`s / /// `JsValue`s alive: /// /// * get an initial live count, /// /// * perform some series of operations or function calls that should clean up /// after themselves, and should not keep holding onto `anyref`s / `JsValue`s /// after completion, /// /// * get the final live count, /// /// * and assert that the initial and final counts are the same. /// /// ## What is Counted /// /// Note that this only counts the *owned* `anyref`s / `JsValue`s that end up in /// `wasm-bindgen`'s heap. It does not count borrowed `anyref`s / `JsValue`s /// that are on its stack. /// /// For example, these `JsValue`s are accounted for: /// /// ```ignore /// #[wasm_bindgen] /// pub fn my_function(this_is_counted: JsValue) { /// let also_counted = JsValue::from_str("hi"); /// assert!(wasm_bindgen::anyref_heap_live_count() >= 2); /// } /// ``` /// /// While this borrowed `JsValue` ends up on the stack, not the heap, and /// therefore is not accounted for: /// /// ```ignore /// #[wasm_bindgen] /// pub fn my_other_function(this_is_not_counted: &JsValue) { /// // ... /// } /// ``` pub fn anyref_heap_live_count() -> u32 { unsafe { __wbindgen_anyref_heap_live_count() } } /// An extension trait for `Option` and `Result` for unwraping the `T` /// value, or throwing a JS error if it is not available. /// /// These methods should have a smaller code size footprint than the normal /// `Option::unwrap` and `Option::expect` methods, but they are specific to /// working with wasm and JS. /// /// On non-wasm32 targets, defaults to the normal unwrap/expect calls. /// /// # Example /// /// ``` /// use wasm_bindgen::prelude::*; /// /// // If the value is `Option::Some` or `Result::Ok`, then we just get the /// // contained `T` value. /// let x = Some(42); /// assert_eq!(x.unwrap_throw(), 42); /// /// let y: Option = None; /// /// // This call would throw an error to JS! /// // /// // y.unwrap_throw() /// // /// // And this call would throw an error to JS with a custom error message! /// // /// // y.expect_throw("woopsie daisy!") /// ``` pub trait UnwrapThrowExt: Sized { /// Unwrap this `Option` or `Result`, but instead of panicking on failure, /// throw an exception to JavaScript. fn unwrap_throw(self) -> T { self.expect_throw("`unwrap_throw` failed") } /// Unwrap this container's `T` value, or throw an error to JS with the /// given message if the `T` value is unavailable (e.g. an `Option` is /// `None`). fn expect_throw(self, message: &str) -> T; } impl UnwrapThrowExt for Option { fn expect_throw(self, message: &str) -> T { if cfg!(all(target_arch = "wasm32", not(target_os = "emscripten"))) { match self { Some(val) => val, None => throw_str(message), } } else { self.expect(message) } } } impl UnwrapThrowExt for Result where E: core::fmt::Debug, { fn expect_throw(self, message: &str) -> T { if cfg!(all(target_arch = "wasm32", not(target_os = "emscripten"))) { match self { Ok(val) => val, Err(_) => throw_str(message), } } else { self.expect(message) } } } /// Returns a handle to this wasm instance's `WebAssembly.Module` /// /// Note that this is only available when the final wasm app is built with /// `--target no-modules`, it's not recommended to rely on this API yet! This is /// largely just an experimental addition to enable threading demos. Using this /// may prevent your wasm module from building down the road. #[doc(hidden)] pub fn module() -> JsValue { unsafe { JsValue::_new(__wbindgen_module()) } } /// Returns a handle to this wasm instance's `WebAssembly.Memory` pub fn memory() -> JsValue { unsafe { JsValue::_new(__wbindgen_memory()) } } /// Returns a handle to this wasm instance's `WebAssembly.Table` which is the /// indirect function table used by Rust pub fn function_table() -> JsValue { unsafe { JsValue::_new(__wbindgen_function_table()) } } #[doc(hidden)] pub mod __rt { use core::cell::{Cell, UnsafeCell}; use core::ops::{Deref, DerefMut}; pub extern crate core; #[cfg(feature = "std")] pub extern crate std; #[macro_export] #[doc(hidden)] #[cfg(feature = "std")] macro_rules! __wbindgen_if_not_std { ($($i:item)*) => {}; } #[macro_export] #[doc(hidden)] #[cfg(not(feature = "std"))] macro_rules! __wbindgen_if_not_std { ($($i:item)*) => ($($i)*) } #[inline] pub fn assert_not_null(s: *mut T) { if s.is_null() { throw_null(); } } #[cold] #[inline(never)] fn throw_null() -> ! { super::throw_str("null pointer passed to rust"); } /// A vendored version of `RefCell` from the standard library. /// /// Now why, you may ask, would we do that? Surely `RefCell` in libstd is /// quite good. And you're right, it is indeed quite good! Functionally /// nothing more is needed from `RefCell` in the standard library but for /// now this crate is also sort of optimizing for compiled code size. /// /// One major factor to larger binaries in Rust is when a panic happens. /// Panicking in the standard library involves a fair bit of machinery /// (formatting, panic hooks, synchronization, etc). It's all worthwhile if /// you need it but for something like `WasmRefCell` here we don't actually /// need all that! /// /// This is just a wrapper around all Rust objects passed to JS intended to /// guard accidental reentrancy, so this vendored version is intended solely /// to not panic in libstd. Instead when it "panics" it calls our `throw` /// function in this crate which raises an error in JS. pub struct WasmRefCell { borrow: Cell, value: UnsafeCell, } impl WasmRefCell { pub fn new(value: T) -> WasmRefCell where T: Sized, { WasmRefCell { value: UnsafeCell::new(value), borrow: Cell::new(0), } } pub fn get_mut(&mut self) -> &mut T { unsafe { &mut *self.value.get() } } pub fn borrow(&self) -> Ref { unsafe { if self.borrow.get() == usize::max_value() { borrow_fail(); } self.borrow.set(self.borrow.get() + 1); Ref { value: &*self.value.get(), borrow: &self.borrow, } } } pub fn borrow_mut(&self) -> RefMut { unsafe { if self.borrow.get() != 0 { borrow_fail(); } self.borrow.set(usize::max_value()); RefMut { value: &mut *self.value.get(), borrow: &self.borrow, } } } pub fn into_inner(self) -> T where T: Sized, { self.value.into_inner() } } pub struct Ref<'b, T: ?Sized + 'b> { value: &'b T, borrow: &'b Cell, } impl<'b, T: ?Sized> Deref for Ref<'b, T> { type Target = T; #[inline] fn deref(&self) -> &T { self.value } } impl<'b, T: ?Sized> Drop for Ref<'b, T> { fn drop(&mut self) { self.borrow.set(self.borrow.get() - 1); } } pub struct RefMut<'b, T: ?Sized + 'b> { value: &'b mut T, borrow: &'b Cell, } impl<'b, T: ?Sized> Deref for RefMut<'b, T> { type Target = T; #[inline] fn deref(&self) -> &T { self.value } } impl<'b, T: ?Sized> DerefMut for RefMut<'b, T> { #[inline] fn deref_mut(&mut self) -> &mut T { self.value } } impl<'b, T: ?Sized> Drop for RefMut<'b, T> { fn drop(&mut self) { self.borrow.set(0); } } fn borrow_fail() -> ! { super::throw_str( "recursive use of an object detected which would lead to \ unsafe aliasing in rust", ); } if_std! { use std::alloc::{alloc, dealloc, realloc, Layout}; use std::mem; #[no_mangle] pub extern "C" fn __wbindgen_malloc(size: usize) -> *mut u8 { let align = mem::align_of::(); if let Ok(layout) = Layout::from_size_align(size, align) { unsafe { if layout.size() > 0 { let ptr = alloc(layout); if !ptr.is_null() { return ptr } } else { return align as *mut u8 } } } malloc_failure(); } #[no_mangle] pub unsafe extern "C" fn __wbindgen_realloc(ptr: *mut u8, old_size: usize, new_size: usize) -> *mut u8 { let align = mem::align_of::(); debug_assert!(old_size > 0); debug_assert!(new_size > 0); if let Ok(layout) = Layout::from_size_align(old_size, align) { let ptr = realloc(ptr, layout, new_size); if !ptr.is_null() { return ptr } } malloc_failure(); } #[cold] fn malloc_failure() -> ! { if cfg!(debug_assertions) { super::throw_str("invalid malloc request") } else { std::process::abort(); } } #[no_mangle] pub unsafe extern "C" fn __wbindgen_free(ptr: *mut u8, size: usize) { // This happens for zero-length slices, and in that case `ptr` is // likely bogus so don't actually send this to the system allocator if size == 0 { return } let align = mem::align_of::(); let layout = Layout::from_size_align_unchecked(size, align); dealloc(ptr, layout); } } /// This is a curious function necessary to get wasm-bindgen working today, /// and it's a bit of an unfortunate hack. /// /// The general problem is that somehow we need the above two symbols to /// exist in the final output binary (__wbindgen_malloc and /// __wbindgen_free). These symbols may be called by JS for various /// bindings, so we for sure need to make sure they're exported. /// /// The problem arises, though, when what if no Rust code uses the symbols? /// For all intents and purposes it looks to LLVM and the linker like the /// above two symbols are dead code, so they're completely discarded! /// /// Specifically what happens is this: /// /// * The above two symbols are generated into some object file inside of /// libwasm_bindgen.rlib /// * The linker, LLD, will not load this object file unless *some* symbol /// is loaded from the object. In this case, if the Rust code never calls /// __wbindgen_malloc or __wbindgen_free then the symbols never get linked /// in. /// * Later when `wasm-bindgen` attempts to use the symbols they don't /// exist, causing an error. /// /// This function is a weird hack for this problem. We inject a call to this /// function in all generated code. Usage of this function should then /// ensure that the above two intrinsics are translated. /// /// Due to how rustc creates object files this function (and anything inside /// it) will be placed into the same object file as the two intrinsics /// above. That means if this function is called and referenced we'll pull /// in the object file and link the intrinsics. /// /// Ideas for how to improve this are most welcome! pub fn link_mem_intrinsics() { crate::anyref::link_intrinsics(); } static mut GLOBAL_EXNDATA: [u32; 2] = [0; 2]; #[no_mangle] pub unsafe extern "C" fn __wbindgen_exn_store(idx: u32) { debug_assert_eq!(GLOBAL_EXNDATA[0], 0); GLOBAL_EXNDATA[0] = 1; GLOBAL_EXNDATA[1] = idx; } pub fn take_last_exception() -> Result<(), super::JsValue> { unsafe { let ret = if GLOBAL_EXNDATA[0] == 1 { Err(super::JsValue::_new(GLOBAL_EXNDATA[1])) } else { Ok(()) }; GLOBAL_EXNDATA[0] = 0; GLOBAL_EXNDATA[1] = 0; return ret; } } } /// A wrapper type around slices and vectors for binding the `Uint8ClampedArray` /// array in JS. /// /// If you need to invoke a JS API which must take `Uint8ClampedArray` array, /// then you can define it as taking one of these types: /// /// * `Clamped<&[u8]>` /// * `Clamped<&mut [u8]>` /// * `Clamped>` /// /// All of these types will show up as `Uint8ClampedArray` in JS and will have /// different forms of ownership in Rust. #[derive(Copy, Clone, PartialEq, Debug, Eq)] pub struct Clamped(pub T); impl Deref for Clamped { type Target = T; fn deref(&self) -> &T { &self.0 } } impl DerefMut for Clamped { fn deref_mut(&mut self) -> &mut T { &mut self.0 } }