// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// from webkit-gir-files
// DO NOT EDIT

use crate::{ffi, CheckSyntaxMode, CheckSyntaxResult, Exception, Value, VirtualMachine};
use glib::translate::*;
use std::boxed::Box as Box_;

glib::wrapper! {
    /// JSCContext represents a JavaScript execution context, where all operations
    /// take place and where the values will be associated.
    ///
    /// When a new context is created, a global object is allocated and the built-in JavaScript
    /// objects (Object, Function, String, Array) are populated. You can execute JavaScript in
    /// the context by using jsc_context_evaluate() or jsc_context_evaluate_with_source_uri().
    /// It's also possible to register custom objects in the context with jsc_context_register_class().
    ///
    /// ## Properties
    ///
    ///
    /// #### `virtual-machine`
    ///  The #JSCVirtualMachine in which the context was created.
    ///
    /// Readable | Writeable | Construct Only
    #[doc(alias = "JSCContext")]
    pub struct Context(Object<ffi::JSCContext, ffi::JSCContextClass>);

    match fn {
        type_ => || ffi::jsc_context_get_type(),
    }
}

impl Context {
    /// Create a new #JSCContext. The context is created in a new #JSCVirtualMachine.
    /// Use jsc_context_new_with_virtual_machine() to create a new #JSCContext in an
    /// existing #JSCVirtualMachine.
    ///
    /// # Returns
    ///
    /// the newly created #JSCContext.
    #[doc(alias = "jsc_context_new")]
    pub fn new() -> Context {
        assert_initialized_main_thread!();
        unsafe { from_glib_full(ffi::jsc_context_new()) }
    }

    /// Create a new #JSCContext in @virtual_machine.
    /// ## `vm`
    /// a #JSCVirtualMachine
    ///
    /// # Returns
    ///
    /// the newly created #JSCContext.
    #[doc(alias = "jsc_context_new_with_virtual_machine")]
    #[doc(alias = "new_with_virtual_machine")]
    pub fn with_virtual_machine(vm: &VirtualMachine) -> Context {
        skip_assert_initialized!();
        unsafe {
            from_glib_full(ffi::jsc_context_new_with_virtual_machine(
                vm.to_glib_none().0,
            ))
        }
    }

    /// Check the given @code in @self for syntax errors. The @line_number is the starting line number in @uri;
    /// the value is one-based so the first line is 1. @uri and @line_number are only used to fill the @exception.
    /// In case of errors @exception will be set to a new #JSCException with the details. You can pass [`None`] to
    /// @exception to ignore the error details.
    /// ## `code`
    /// a JavaScript script to check
    /// ## `length`
    /// length of @code, or -1 if @code is a nul-terminated string
    /// ## `mode`
    /// a #JSCCheckSyntaxMode
    /// ## `uri`
    /// the source URI
    /// ## `line_number`
    /// the starting line number
    ///
    /// # Returns
    ///
    /// a #JSCCheckSyntaxResult
    ///
    /// ## `exception`
    /// return location for a #JSCException, or [`None`] to ignore
    #[doc(alias = "jsc_context_check_syntax")]
    pub fn check_syntax(
        &self,
        code: &str,
        mode: CheckSyntaxMode,
        uri: &str,
        line_number: u32,
    ) -> (CheckSyntaxResult, Exception) {
        let length = code.len() as _;
        unsafe {
            let mut exception = std::ptr::null_mut();
            let ret = from_glib(ffi::jsc_context_check_syntax(
                self.to_glib_none().0,
                code.to_glib_none().0,
                length,
                mode.into_glib(),
                uri.to_glib_none().0,
                line_number,
                &mut exception,
            ));
            (ret, from_glib_full(exception))
        }
    }

    /// Clear the uncaught exception in @self if any.
    #[doc(alias = "jsc_context_clear_exception")]
    pub fn clear_exception(&self) {
        unsafe {
            ffi::jsc_context_clear_exception(self.to_glib_none().0);
        }
    }

    /// Evaluate @code in @self.
    /// ## `code`
    /// a JavaScript script to evaluate
    /// ## `length`
    /// length of @code, or -1 if @code is a nul-terminated string
    ///
    /// # Returns
    ///
    /// a #JSCValue representing the last value generated by the script.
    #[doc(alias = "jsc_context_evaluate")]
    pub fn evaluate(&self, code: &str) -> Option<Value> {
        let length = code.len() as _;
        unsafe {
            from_glib_full(ffi::jsc_context_evaluate(
                self.to_glib_none().0,
                code.to_glib_none().0,
                length,
            ))
        }
    }

    //#[doc(alias = "jsc_context_evaluate_in_object")]
    //pub fn evaluate_in_object(&self, code: &str, object_instance: /*Unimplemented*/Option<Basic: Pointer>, object_class: Option<&Class>, uri: &str, line_number: u32) -> (Value, Value) {
    //    unsafe { TODO: call ffi:jsc_context_evaluate_in_object() }
    //}

    /// Evaluate @code in @self using @uri as the source URI. The @line_number is the starting line number
    /// in @uri; the value is one-based so the first line is 1. @uri and @line_number will be shown in exceptions and
    /// they don't affect the behavior of the script.
    /// ## `code`
    /// a JavaScript script to evaluate
    /// ## `length`
    /// length of @code, or -1 if @code is a nul-terminated string
    /// ## `uri`
    /// the source URI
    /// ## `line_number`
    /// the starting line number
    ///
    /// # Returns
    ///
    /// a #JSCValue representing the last value generated by the script.
    #[doc(alias = "jsc_context_evaluate_with_source_uri")]
    pub fn evaluate_with_source_uri(
        &self,
        code: &str,
        uri: &str,
        line_number: u32,
    ) -> Option<Value> {
        let length = code.len() as _;
        unsafe {
            from_glib_full(ffi::jsc_context_evaluate_with_source_uri(
                self.to_glib_none().0,
                code.to_glib_none().0,
                length,
                uri.to_glib_none().0,
                line_number,
            ))
        }
    }

    /// Get the last unhandled exception thrown in @self by API functions calls.
    ///
    /// # Returns
    ///
    /// a #JSCException or [`None`] if there isn't any
    ///    unhandled exception in the #JSCContext.
    #[doc(alias = "jsc_context_get_exception")]
    #[doc(alias = "get_exception")]
    pub fn exception(&self) -> Option<Exception> {
        unsafe { from_glib_none(ffi::jsc_context_get_exception(self.to_glib_none().0)) }
    }

    /// Get a #JSCValue referencing the @self global object
    ///
    /// # Returns
    ///
    /// a #JSCValue
    #[doc(alias = "jsc_context_get_global_object")]
    #[doc(alias = "get_global_object")]
    pub fn global_object(&self) -> Option<Value> {
        unsafe { from_glib_full(ffi::jsc_context_get_global_object(self.to_glib_none().0)) }
    }

    /// Get a property of @self global object with @name.
    /// ## `name`
    /// the value name
    ///
    /// # Returns
    ///
    /// a #JSCValue
    #[doc(alias = "jsc_context_get_value")]
    #[doc(alias = "get_value")]
    pub fn value(&self, name: &str) -> Option<Value> {
        unsafe {
            from_glib_full(ffi::jsc_context_get_value(
                self.to_glib_none().0,
                name.to_glib_none().0,
            ))
        }
    }

    /// Get the #JSCVirtualMachine where @self was created.
    ///
    /// # Returns
    ///
    /// the #JSCVirtualMachine where the #JSCContext was created.
    #[doc(alias = "jsc_context_get_virtual_machine")]
    #[doc(alias = "get_virtual_machine")]
    #[doc(alias = "virtual-machine")]
    pub fn virtual_machine(&self) -> Option<VirtualMachine> {
        unsafe { from_glib_none(ffi::jsc_context_get_virtual_machine(self.to_glib_none().0)) }
    }

    /// Remove the last #JSCExceptionHandler previously pushed to @self with
    /// jsc_context_push_exception_handler().
    #[doc(alias = "jsc_context_pop_exception_handler")]
    pub fn pop_exception_handler(&self) {
        unsafe {
            ffi::jsc_context_pop_exception_handler(self.to_glib_none().0);
        }
    }

    /// Push an exception handler in @self. Whenever a JavaScript exception happens in
    /// the #JSCContext, the given @handler will be called. The default #JSCExceptionHandler
    /// simply calls jsc_context_throw_exception() to throw the exception to the #JSCContext.
    /// If you don't want to catch the exception, but only get notified about it, call
    /// jsc_context_throw_exception() in @handler like the default one does.
    /// The last exception handler pushed is the only one used by the #JSCContext, use
    /// jsc_context_pop_exception_handler() to remove it and set the previous one. When @handler
    /// is removed from the context, @destroy_notify i called with @user_data as parameter.
    /// ## `handler`
    /// a #JSCExceptionHandler
    /// ## `destroy_notify`
    /// destroy notifier for @user_data
    #[doc(alias = "jsc_context_push_exception_handler")]
    pub fn push_exception_handler<P: Fn(&Context, &Exception) + 'static>(&self, handler: P) {
        let handler_data: Box_<P> = Box_::new(handler);
        unsafe extern "C" fn handler_func<P: Fn(&Context, &Exception) + 'static>(
            context: *mut ffi::JSCContext,
            exception: *mut ffi::JSCException,
            user_data: glib::ffi::gpointer,
        ) {
            let context = from_glib_borrow(context);
            let exception = from_glib_borrow(exception);
            let callback = &*(user_data as *mut P);
            (*callback)(&context, &exception)
        }
        let handler = Some(handler_func::<P> as _);
        unsafe extern "C" fn destroy_notify_func<P: Fn(&Context, &Exception) + 'static>(
            data: glib::ffi::gpointer,
        ) {
            let _callback = Box_::from_raw(data as *mut P);
        }
        let destroy_call3 = Some(destroy_notify_func::<P> as _);
        let super_callback0: Box_<P> = handler_data;
        unsafe {
            ffi::jsc_context_push_exception_handler(
                self.to_glib_none().0,
                handler,
                Box_::into_raw(super_callback0) as *mut _,
                destroy_call3,
            );
        }
    }

    //#[doc(alias = "jsc_context_register_class")]
    //pub fn register_class(&self, name: &str, parent_class: Option<&Class>, vtable: /*Ignored*/Option<&mut ClassVTable>) -> Option<Class> {
    //    unsafe { TODO: call ffi:jsc_context_register_class() }
    //}

    /// Set a property of @self global object with @name and @value.
    /// ## `name`
    /// the value name
    /// ## `value`
    /// a #JSCValue
    #[doc(alias = "jsc_context_set_value")]
    pub fn set_value(&self, name: &str, value: &Value) {
        unsafe {
            ffi::jsc_context_set_value(
                self.to_glib_none().0,
                name.to_glib_none().0,
                value.to_glib_none().0,
            );
        }
    }

    /// Throw an exception to @self using the given error message. The created #JSCException
    /// can be retrieved with jsc_context_get_exception().
    /// ## `error_message`
    /// an error message
    #[doc(alias = "jsc_context_throw")]
    pub fn throw(&self, error_message: &str) {
        unsafe {
            ffi::jsc_context_throw(self.to_glib_none().0, error_message.to_glib_none().0);
        }
    }

    /// Throw @exception to @self.
    /// ## `exception`
    /// a #JSCException
    #[doc(alias = "jsc_context_throw_exception")]
    pub fn throw_exception(&self, exception: &Exception) {
        unsafe {
            ffi::jsc_context_throw_exception(self.to_glib_none().0, exception.to_glib_none().0);
        }
    }

    //#[doc(alias = "jsc_context_throw_printf")]
    //pub fn throw_printf(&self, format: &str, : /*Unknown conversion*//*Unimplemented*/Basic: VarArgs) {
    //    unsafe { TODO: call ffi:jsc_context_throw_printf() }
    //}

    /// Throw an exception to @self using the given error name and message. The created #JSCException
    /// can be retrieved with jsc_context_get_exception().
    /// ## `error_name`
    /// the error name
    /// ## `error_message`
    /// an error message
    #[doc(alias = "jsc_context_throw_with_name")]
    pub fn throw_with_name(&self, error_name: &str, error_message: &str) {
        unsafe {
            ffi::jsc_context_throw_with_name(
                self.to_glib_none().0,
                error_name.to_glib_none().0,
                error_message.to_glib_none().0,
            );
        }
    }

    //#[doc(alias = "jsc_context_throw_with_name_printf")]
    //pub fn throw_with_name_printf(&self, error_name: &str, format: &str, : /*Unknown conversion*//*Unimplemented*/Basic: VarArgs) {
    //    unsafe { TODO: call ffi:jsc_context_throw_with_name_printf() }
    //}

    /// Get the #JSCContext that is currently executing a function. This should only be
    /// called within a function or method callback, otherwise [`None`] will be returned.
    ///
    /// # Returns
    ///
    /// the #JSCContext that is currently executing.
    #[doc(alias = "jsc_context_get_current")]
    #[doc(alias = "get_current")]
    pub fn current() -> Option<Context> {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::jsc_context_get_current()) }
    }
}

impl Default for Context {
    fn default() -> Self {
        Self::new()
    }
}