/* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ use devtools_traits::ScriptToDevtoolsControlMsg; use dom::bindings::inheritance::Castable; use dom::bindings::js::Root; use dom::globalscope::GlobalScope; use dom::paintworkletglobalscope::PaintWorkletGlobalScope; use dom::paintworkletglobalscope::PaintWorkletTask; use dom::testworkletglobalscope::TestWorkletGlobalScope; use dom::testworkletglobalscope::TestWorkletTask; use dom::worklet::WorkletExecutor; use dom_struct::dom_struct; use ipc_channel::ipc; use ipc_channel::ipc::IpcSender; use js::jsapi::JSContext; use js::jsval::UndefinedValue; use js::rust::Runtime; use microtask::Microtask; use microtask::MicrotaskQueue; use msg::constellation_msg::PipelineId; use net_traits::ResourceThreads; use net_traits::image_cache::ImageCache; use profile_traits::mem; use profile_traits::time; use script_layout_interface::message::Msg; use script_runtime::CommonScriptMsg; use script_runtime::ScriptThreadEventCategory; use script_thread::MainThreadScriptMsg; use script_thread::Runnable; use script_thread::ScriptThread; use script_traits::ScriptMsg; use script_traits::ScriptToConstellationChan; use script_traits::TimerSchedulerMsg; use servo_url::ImmutableOrigin; use servo_url::MutableOrigin; use servo_url::ServoUrl; use std::sync::Arc; use std::sync::mpsc::Sender; #[dom_struct] /// https://drafts.css-houdini.org/worklets/#workletglobalscope pub struct WorkletGlobalScope { /// The global for this worklet. globalscope: GlobalScope, /// The base URL for this worklet. base_url: ServoUrl, /// The microtask queue for this worklet microtask_queue: MicrotaskQueue, /// Sender back to the script thread #[ignore_heap_size_of = "channels are hard"] to_script_thread_sender: Sender, /// Worklet task executor executor: WorkletExecutor, } impl WorkletGlobalScope { /// Create a new stack-allocated `WorkletGlobalScope`. pub fn new_inherited(pipeline_id: PipelineId, base_url: ServoUrl, executor: WorkletExecutor, init: &WorkletGlobalScopeInit) -> WorkletGlobalScope { // Any timer events fired on this global are ignored. let (timer_event_chan, _) = ipc::channel().unwrap(); let script_to_constellation_chan = ScriptToConstellationChan { sender: init.to_constellation_sender.clone(), pipeline_id: pipeline_id, }; WorkletGlobalScope { globalscope: GlobalScope::new_inherited(pipeline_id, init.devtools_chan.clone(), init.mem_profiler_chan.clone(), init.time_profiler_chan.clone(), script_to_constellation_chan, init.scheduler_chan.clone(), init.resource_threads.clone(), timer_event_chan, MutableOrigin::new(ImmutableOrigin::new_opaque())), base_url: base_url, microtask_queue: MicrotaskQueue::default(), to_script_thread_sender: init.to_script_thread_sender.clone(), executor: executor, } } /// Get the JS context. pub fn get_cx(&self) -> *mut JSContext { self.globalscope.get_cx() } /// Evaluate a JS script in this global. pub fn evaluate_js(&self, script: &str) -> bool { debug!("Evaluating JS."); rooted!(in (self.globalscope.get_cx()) let mut rval = UndefinedValue()); self.globalscope.evaluate_js_on_global_with_result(&*script, rval.handle_mut()) } /// Run a runnable in the main script thread. pub fn run_in_script_thread(&self, runnable: R) where R: 'static + Send + Runnable, { let msg = CommonScriptMsg::RunnableMsg(ScriptThreadEventCategory::WorkletEvent, box runnable); let msg = MainThreadScriptMsg::Common(msg); self.to_script_thread_sender.send(msg).expect("Worklet thread outlived script thread."); } /// Send a message to layout. pub fn send_to_layout(&self, msg: Msg) { struct RunnableMsg(PipelineId, Msg); impl Runnable for RunnableMsg { fn main_thread_handler(self: Box, script_thread: &ScriptThread) { script_thread.send_to_layout(self.0, self.1); } } let pipeline_id = self.globalscope.pipeline_id(); self.run_in_script_thread(RunnableMsg(pipeline_id, msg)); } /// The base URL of this global. pub fn base_url(&self) -> ServoUrl { self.base_url.clone() } /// The worklet executor. pub fn executor(&self) -> WorkletExecutor { self.executor.clone() } /// Queue up a microtask to be executed in this global. pub fn enqueue_microtask(&self, job: Microtask) { self.microtask_queue.enqueue(job); } /// Perform any queued microtasks. pub fn perform_a_microtask_checkpoint(&self) { self.microtask_queue.checkpoint(|id| { let global = self.upcast::(); assert_eq!(global.pipeline_id(), id); Some(Root::from_ref(global)) }); } /// Perform a worklet task pub fn perform_a_worklet_task(&self, task: WorkletTask) { match task { WorkletTask::Test(task) => match self.downcast::() { Some(global) => global.perform_a_worklet_task(task), None => warn!("This is not a test worklet."), }, WorkletTask::Paint(task) => match self.downcast::() { Some(global) => global.perform_a_worklet_task(task), None => warn!("This is not a paint worklet."), }, } } } /// Resources required by workletglobalscopes #[derive(Clone)] pub struct WorkletGlobalScopeInit { /// Channel to the main script thread pub to_script_thread_sender: Sender, /// Channel to a resource thread pub resource_threads: ResourceThreads, /// Channel to the memory profiler pub mem_profiler_chan: mem::ProfilerChan, /// Channel to the time profiler pub time_profiler_chan: time::ProfilerChan, /// Channel to devtools pub devtools_chan: Option>, /// Messages to send to constellation pub to_constellation_sender: IpcSender<(PipelineId, ScriptMsg)>, /// Message to send to the scheduler pub scheduler_chan: IpcSender, /// The image cache pub image_cache: Arc, } /// https://drafts.css-houdini.org/worklets/#worklet-global-scope-type #[derive(Clone, Copy, Debug, HeapSizeOf, JSTraceable)] pub enum WorkletGlobalScopeType { /// A servo-specific testing worklet Test, /// A paint worklet Paint, } impl WorkletGlobalScopeType { /// Create a new heap-allocated `WorkletGlobalScope`. pub fn new(&self, runtime: &Runtime, pipeline_id: PipelineId, base_url: ServoUrl, executor: WorkletExecutor, init: &WorkletGlobalScopeInit) -> Root { match *self { WorkletGlobalScopeType::Test => Root::upcast(TestWorkletGlobalScope::new(runtime, pipeline_id, base_url, executor, init)), WorkletGlobalScopeType::Paint => Root::upcast(PaintWorkletGlobalScope::new(runtime, pipeline_id, base_url, executor, init)), } } } /// A task which can be performed in the context of a worklet global. pub enum WorkletTask { Test(TestWorkletTask), Paint(PaintWorkletTask), }