Struct sapp_jsutils::JsObject

#[repr(transparent)]pub struct JsObject(_);

Pointer type for Js allocated object Consider this as a Box, but pointing into JS memory -1 is nil

Implementations

impl JsObject

pub fn weak(&self) -> JsObjectWeak

Get a weak reference to js memory No guarantees against js garbage collector

impl JsObject

pub fn string(string: &str) -> JsObject

Allocate new javascript object with string type

pub fn buffer(data: &[u8]) -> JsObject

Allocate new javascript object with Uint8Array type

pub fn object() -> JsObject

Allocate new javascript object with object type. Like "var object = {}" in JS.

pub fn to_string(&self, buf: &mut String)

Read JS object content to a given string Will panic if object is not a string Will not allocate memory if string is large enough, will use "String::reserve" otherwise

pub fn to_byte_buffer(&self, buf: &mut Vec<u8>)

Read JS object content to a given bytes buffer Will panic if object is not a buffer Will use .resize() on "buf", so if "buf" is large enough - no memory is going to be allocated here

pub fn field(&self, field: &str) -> JsObject

Get a new JsObject from this object .field Will panic if self is not an object or map

pub fn set_field_f32(&self, field: &str, data: f32)

Set .field or ["field"] to given f32, like "object.field = data"; Will panic if self is not an object or map

pub fn is_nil(&self) -> bool

JS function returning JsObject may return -1 instead. Those JsObject are considering nil and if function may do this JsObjects should be checked for nil. Unfortunately this is not typecheked by rust complier at all, so any "f() -> JsObject" function may return nil

Trait Implementations

impl Drop for JsObject

pub fn drop(&mut self)

Executes the destructor for this type.