mozjs 0.15.14

Rust bindings to the Mozilla SpiderMonkey JavaScript engine.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

#![allow(
    non_upper_case_globals,
    non_camel_case_types,
    non_snake_case,
    improper_ctypes
)]

//! # Running scripts
//! Here is the code under "Running scripts" in the MDN User Guide[1] translated into Rust. This
//! only shows the ``run()`` function's contents because the original does as well.
//!
//! The actual code that is run is designed to be testable, unlike the example given.
//! [1]: https://developer.mozilla.org/en-US/docs/Mozilla/Projects/SpiderMonkey/JSAPI_User_Guide
//!

use ::std::ptr;

use mozjs::jsapi::OnNewGlobalHookOption;
use mozjs::jsval::UndefinedValue;
use mozjs::rooted;
use mozjs::rust::evaluate_script;
use mozjs::rust::wrappers2::*;
use mozjs::rust::CompileOptionsWrapper;
use mozjs::rust::SIMPLE_GLOBAL_CLASS;
use mozjs::rust::{JSEngine, RealmOptions, Runtime};

fn run(mut rt: Runtime) {
    let options = RealmOptions::default();
    rooted!(&in(rt.cx()) let global = unsafe {
        JS_NewGlobalObject(rt.cx(), &SIMPLE_GLOBAL_CLASS, ptr::null_mut(),
                           OnNewGlobalHookOption::FireOnNewGlobalHook,
                           &*options)
    });

    /* These should indicate source location for diagnostics. */
    let filename = c"inline.js".to_owned();
    let lineno: u32 = 1;

    /*
     * The return value comes back here. If it could be a GC thing, you must add it to the
     * GC's "root set" with the rooted! macro.
     */
    rooted!(&in(rt.cx()) let mut rval = UndefinedValue());

    /*
     * Some example source in a string. This is equivalent to JS_EvaluateScript in C++.
     */
    let source: &'static str = "40 + 2";

    let options = CompileOptionsWrapper::new(rt.cx_no_gc(), filename, lineno);
    let res = evaluate_script(rt.cx(), global.handle(), source, rval.handle_mut(), options);

    if res.is_ok() {
        /* Should get a number back from the example source. */
        assert!(rval.get().is_int32());
        assert_eq!(rval.get().to_int32(), 42);
    }
}

fn main() {
    let engine = JSEngine::init().expect("failed to initalize JS engine");
    let runtime = Runtime::new(engine.handle());
    run(runtime);
}

/// For `cargo test` to actually run example
#[test]
fn eval_example() {
    main()
}