/* 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 https://mozilla.org/MPL/2.0/. */ //! An actor-based remote devtools server implementation. Only tested with //! nightly Firefox versions at time of writing. Largely based on //! reverse-engineering of Firefox chrome devtool logs and reading of //! [code](http://mxr.mozilla.org/mozilla-central/source/toolkit/devtools/server/). #![crate_name = "devtools"] #![crate_type = "rlib"] #![allow(non_snake_case)] #![deny(unsafe_code)] #[macro_use] extern crate log; #[macro_use] extern crate serde; use crate::actor::{Actor, ActorRegistry}; use crate::actors::browsing_context::BrowsingContextActor; use crate::actors::console::ConsoleActor; use crate::actors::device::DeviceActor; use crate::actors::emulation::EmulationActor; use crate::actors::framerate::FramerateActor; use crate::actors::inspector::InspectorActor; use crate::actors::network_event::{EventActor, NetworkEventActor, ResponseStartMsg}; use crate::actors::performance::PerformanceActor; use crate::actors::profiler::ProfilerActor; use crate::actors::root::RootActor; use crate::actors::stylesheets::StyleSheetsActor; use crate::actors::thread::ThreadActor; use crate::actors::timeline::TimelineActor; use crate::actors::worker::WorkerActor; use crate::protocol::JsonPacketStream; use crossbeam_channel::{unbounded, Receiver, Sender}; use devtools_traits::{ChromeToDevtoolsControlMsg, ConsoleMessage, DevtoolsControlMsg}; use devtools_traits::{DevtoolScriptControlMsg, DevtoolsPageInfo, LogLevel, NetworkEvent}; use devtools_traits::{ScriptToDevtoolsControlMsg, WorkerId}; use ipc_channel::ipc::IpcSender; use msg::constellation_msg::PipelineId; use std::borrow::ToOwned; use std::cell::RefCell; use std::collections::hash_map::Entry::{Occupied, Vacant}; use std::collections::HashMap; use std::net::{Shutdown, TcpListener, TcpStream}; use std::sync::{Arc, Mutex}; use std::thread; use time::precise_time_ns; mod actor; /// Corresponds to http://mxr.mozilla.org/mozilla-central/source/toolkit/devtools/server/actors/ mod actors { pub mod browsing_context; pub mod console; pub mod device; pub mod emulation; pub mod framerate; pub mod inspector; pub mod memory; pub mod network_event; pub mod object; pub mod performance; pub mod profiler; pub mod root; pub mod stylesheets; pub mod thread; pub mod timeline; pub mod worker; } mod protocol; #[derive(Serialize)] struct ConsoleAPICall { from: String, #[serde(rename = "type")] type_: String, message: ConsoleMsg, } #[derive(Serialize)] struct ConsoleMsg { level: String, timeStamp: u64, arguments: Vec, filename: String, lineNumber: usize, columnNumber: usize, } #[derive(Serialize)] struct NetworkEventMsg { from: String, #[serde(rename = "type")] type_: String, eventActor: EventActor, } #[derive(Serialize)] struct NetworkEventUpdateMsg { from: String, #[serde(rename = "type")] type_: String, updateType: String, } #[derive(Serialize)] struct EventTimingsUpdateMsg { totalTime: u64, } #[derive(Serialize)] struct SecurityInfoUpdateMsg { state: String, } #[derive(Serialize)] struct ResponseStartUpdateMsg { from: String, #[serde(rename = "type")] type_: String, updateType: String, response: ResponseStartMsg, } /// Spin up a devtools server that listens for connections on the specified port. pub fn start_server(port: u16) -> Sender { let (sender, receiver) = unbounded(); { let sender = sender.clone(); thread::Builder::new() .name("Devtools".to_owned()) .spawn(move || run_server(sender, receiver, port)) .expect("Thread spawning failed"); } sender } fn run_server( sender: Sender, receiver: Receiver, port: u16, ) { let listener = TcpListener::bind(&("127.0.0.1", port)).unwrap(); let mut registry = ActorRegistry::new(); let performance = PerformanceActor::new(registry.new_name("performance")); let device = DeviceActor::new(registry.new_name("device")); let root = Box::new(RootActor { tabs: vec![], device: device.name(), performance: performance.name(), }); registry.register(root); registry.register(Box::new(performance)); registry.register(Box::new(device)); registry.find::("root"); let actors = registry.create_shareable(); let mut accepted_connections: Vec = Vec::new(); let mut actor_pipelines: HashMap = HashMap::new(); let mut actor_requests: HashMap = HashMap::new(); let mut actor_workers: HashMap<(PipelineId, WorkerId), String> = HashMap::new(); /// Process the input from a single devtools client until EOF. fn handle_client(actors: Arc>, mut stream: TcpStream) { debug!("connection established to {}", stream.peer_addr().unwrap()); { let actors = actors.lock().unwrap(); let msg = actors.find::("root").encodable(); stream.write_json_packet(&msg); } 'outer: loop { match stream.read_json_packet() { Ok(Some(json_packet)) => { if let Err(()) = actors .lock() .unwrap() .handle_message(json_packet.as_object().unwrap(), &mut stream) { debug!("error: devtools actor stopped responding"); let _ = stream.shutdown(Shutdown::Both); break 'outer; } }, Ok(None) => { debug!("error: EOF"); break 'outer; }, Err(err_msg) => { debug!("error: {}", err_msg); break 'outer; }, } } } fn handle_framerate_tick(actors: Arc>, actor_name: String, tick: f64) { let mut actors = actors.lock().unwrap(); let framerate_actor = actors.find_mut::(&actor_name); framerate_actor.add_tick(tick); } // We need separate actor representations for each script global that exists; // clients can theoretically connect to multiple globals simultaneously. // TODO: move this into the root or target modules? fn handle_new_global( actors: Arc>, ids: (PipelineId, Option), script_sender: IpcSender, actor_pipelines: &mut HashMap, actor_workers: &mut HashMap<(PipelineId, WorkerId), String>, page_info: DevtoolsPageInfo, ) { let mut actors = actors.lock().unwrap(); let (pipeline, worker_id) = ids; //TODO: move all this actor creation into a constructor method on BrowsingContextActor let ( target, console, emulation, inspector, timeline, profiler, performance, styleSheets, thread, ) = { let console = ConsoleActor { name: actors.new_name("console"), script_chan: script_sender.clone(), pipeline: pipeline, streams: RefCell::new(Vec::new()), }; let emulation = EmulationActor::new(actors.new_name("emulation")); let inspector = InspectorActor { name: actors.new_name("inspector"), walker: RefCell::new(None), pageStyle: RefCell::new(None), highlighter: RefCell::new(None), script_chan: script_sender.clone(), pipeline: pipeline, }; let timeline = TimelineActor::new(actors.new_name("timeline"), pipeline, script_sender); let profiler = ProfilerActor::new(actors.new_name("profiler")); let performance = PerformanceActor::new(actors.new_name("performance")); // the strange switch between styleSheets and stylesheets is due // to an inconsistency in devtools. See Bug #1498893 in bugzilla let styleSheets = StyleSheetsActor::new(actors.new_name("stylesheets")); let thread = ThreadActor::new(actors.new_name("context")); let DevtoolsPageInfo { title, url } = page_info; let target = BrowsingContextActor { name: actors.new_name("target"), title: String::from(title), url: url.into_string(), console: console.name(), emulation: emulation.name(), inspector: inspector.name(), timeline: timeline.name(), profiler: profiler.name(), performance: performance.name(), styleSheets: styleSheets.name(), thread: thread.name(), }; let root = actors.find_mut::("root"); root.tabs.push(target.name.clone()); ( target, console, emulation, inspector, timeline, profiler, performance, styleSheets, thread, ) }; if let Some(id) = worker_id { let worker = WorkerActor { name: actors.new_name("worker"), console: console.name(), id: id, }; actor_workers.insert((pipeline, id), worker.name.clone()); actors.register(Box::new(worker)); } actor_pipelines.insert(pipeline, target.name.clone()); actors.register(Box::new(target)); actors.register(Box::new(console)); actors.register(Box::new(emulation)); actors.register(Box::new(inspector)); actors.register(Box::new(timeline)); actors.register(Box::new(profiler)); actors.register(Box::new(performance)); actors.register(Box::new(styleSheets)); actors.register(Box::new(thread)); } fn handle_console_message( actors: Arc>, id: PipelineId, worker_id: Option, console_message: ConsoleMessage, actor_pipelines: &HashMap, actor_workers: &HashMap<(PipelineId, WorkerId), String>, ) { let console_actor_name = match find_console_actor( actors.clone(), id, worker_id, actor_workers, actor_pipelines, ) { Some(name) => name, None => return, }; let actors = actors.lock().unwrap(); let console_actor = actors.find::(&console_actor_name); let msg = ConsoleAPICall { from: console_actor.name.clone(), type_: "consoleAPICall".to_owned(), message: ConsoleMsg { level: match console_message.logLevel { LogLevel::Debug => "debug", LogLevel::Info => "info", LogLevel::Warn => "warn", LogLevel::Error => "error", _ => "log", } .to_owned(), timeStamp: precise_time_ns(), arguments: vec![console_message.message], filename: console_message.filename, lineNumber: console_message.lineNumber, columnNumber: console_message.columnNumber, }, }; for stream in &mut *console_actor.streams.borrow_mut() { stream.write_json_packet(&msg); } } fn find_console_actor( actors: Arc>, id: PipelineId, worker_id: Option, actor_workers: &HashMap<(PipelineId, WorkerId), String>, actor_pipelines: &HashMap, ) -> Option { let actors = actors.lock().unwrap(); if let Some(worker_id) = worker_id { let actor_name = (*actor_workers).get(&(id, worker_id))?; Some(actors.find::(actor_name).console.clone()) } else { let actor_name = (*actor_pipelines).get(&id)?; Some( actors .find::(actor_name) .console .clone(), ) } } fn handle_network_event( actors: Arc>, mut connections: Vec, actor_pipelines: &HashMap, actor_requests: &mut HashMap, actor_workers: &HashMap<(PipelineId, WorkerId), String>, pipeline_id: PipelineId, request_id: String, network_event: NetworkEvent, ) { let console_actor_name = match find_console_actor( actors.clone(), pipeline_id, None, actor_workers, actor_pipelines, ) { Some(name) => name, None => return, }; let netevent_actor_name = find_network_event_actor(actors.clone(), actor_requests, request_id); let mut actors = actors.lock().unwrap(); let actor = actors.find_mut::(&netevent_actor_name); match network_event { NetworkEvent::HttpRequest(httprequest) => { //Store the request information in the actor actor.add_request(httprequest); //Send a networkEvent message to the client let msg = NetworkEventMsg { from: console_actor_name, type_: "networkEvent".to_owned(), eventActor: actor.event_actor(), }; for stream in &mut connections { stream.write_json_packet(&msg); } }, NetworkEvent::HttpResponse(httpresponse) => { //Store the response information in the actor actor.add_response(httpresponse); let msg = NetworkEventUpdateMsg { from: netevent_actor_name.clone(), type_: "networkEventUpdate".to_owned(), updateType: "requestHeaders".to_owned(), }; for stream in &mut connections { stream.write_merged_json_packet(&msg, &actor.request_headers()); } let msg = NetworkEventUpdateMsg { from: netevent_actor_name.clone(), type_: "networkEventUpdate".to_owned(), updateType: "requestCookies".to_owned(), }; for stream in &mut connections { stream.write_merged_json_packet(&msg, &actor.request_cookies()); } //Send a networkEventUpdate (responseStart) to the client let msg = ResponseStartUpdateMsg { from: netevent_actor_name.clone(), type_: "networkEventUpdate".to_owned(), updateType: "responseStart".to_owned(), response: actor.response_start(), }; for stream in &mut connections { stream.write_json_packet(&msg); } let msg = NetworkEventUpdateMsg { from: netevent_actor_name.clone(), type_: "networkEventUpdate".to_owned(), updateType: "eventTimings".to_owned(), }; let extra = EventTimingsUpdateMsg { totalTime: actor.total_time(), }; for stream in &mut connections { stream.write_merged_json_packet(&msg, &extra); } let msg = NetworkEventUpdateMsg { from: netevent_actor_name.clone(), type_: "networkEventUpdate".to_owned(), updateType: "securityInfo".to_owned(), }; let extra = SecurityInfoUpdateMsg { state: "insecure".to_owned(), }; for stream in &mut connections { stream.write_merged_json_packet(&msg, &extra); } let msg = NetworkEventUpdateMsg { from: netevent_actor_name.clone(), type_: "networkEventUpdate".to_owned(), updateType: "responseContent".to_owned(), }; for stream in &mut connections { stream.write_merged_json_packet(&msg, &actor.response_content()); } let msg = NetworkEventUpdateMsg { from: netevent_actor_name.clone(), type_: "networkEventUpdate".to_owned(), updateType: "responseCookies".to_owned(), }; for stream in &mut connections { stream.write_merged_json_packet(&msg, &actor.response_cookies()); } let msg = NetworkEventUpdateMsg { from: netevent_actor_name, type_: "networkEventUpdate".to_owned(), updateType: "responseHeaders".to_owned(), }; for stream in &mut connections { stream.write_merged_json_packet(&msg, &actor.response_headers()); } }, } } // Find the name of NetworkEventActor corresponding to request_id // Create a new one if it does not exist, add it to the actor_requests hashmap fn find_network_event_actor( actors: Arc>, actor_requests: &mut HashMap, request_id: String, ) -> String { let mut actors = actors.lock().unwrap(); match (*actor_requests).entry(request_id) { Occupied(name) => { //TODO: Delete from map like Firefox does? name.into_mut().clone() }, Vacant(entry) => { let actor_name = actors.new_name("netevent"); let actor = NetworkEventActor::new(actor_name.clone()); entry.insert(actor_name.clone()); actors.register(Box::new(actor)); actor_name }, } } thread::Builder::new() .name("DevtoolsClientAcceptor".to_owned()) .spawn(move || { // accept connections and process them, spawning a new thread for each one for stream in listener.incoming() { // connection succeeded sender .send(DevtoolsControlMsg::FromChrome( ChromeToDevtoolsControlMsg::AddClient(stream.unwrap()), )) .unwrap(); } }) .expect("Thread spawning failed"); while let Ok(msg) = receiver.recv() { match msg { DevtoolsControlMsg::FromChrome(ChromeToDevtoolsControlMsg::AddClient(stream)) => { let actors = actors.clone(); accepted_connections.push(stream.try_clone().unwrap()); thread::Builder::new() .name("DevtoolsClientHandler".to_owned()) .spawn(move || handle_client(actors, stream.try_clone().unwrap())) .expect("Thread spawning failed"); }, DevtoolsControlMsg::FromScript(ScriptToDevtoolsControlMsg::FramerateTick( actor_name, tick, )) => handle_framerate_tick(actors.clone(), actor_name, tick), DevtoolsControlMsg::FromScript(ScriptToDevtoolsControlMsg::NewGlobal( ids, script_sender, pageinfo, )) => handle_new_global( actors.clone(), ids, script_sender, &mut actor_pipelines, &mut actor_workers, pageinfo, ), DevtoolsControlMsg::FromScript(ScriptToDevtoolsControlMsg::ConsoleAPI( id, console_message, worker_id, )) => handle_console_message( actors.clone(), id, worker_id, console_message, &actor_pipelines, &actor_workers, ), DevtoolsControlMsg::FromScript(ScriptToDevtoolsControlMsg::ReportCSSError( id, css_error, )) => { let console_message = ConsoleMessage { message: css_error.msg, logLevel: LogLevel::Warn, filename: css_error.filename, lineNumber: css_error.line as usize, columnNumber: css_error.column as usize, }; handle_console_message( actors.clone(), id, None, console_message, &actor_pipelines, &actor_workers, ) }, DevtoolsControlMsg::FromChrome(ChromeToDevtoolsControlMsg::NetworkEvent( request_id, network_event, )) => { // copy the accepted_connections vector let mut connections = Vec::::new(); for stream in &accepted_connections { connections.push(stream.try_clone().unwrap()); } let pipeline_id = match network_event { NetworkEvent::HttpResponse(ref response) => response.pipeline_id, NetworkEvent::HttpRequest(ref request) => request.pipeline_id, }; handle_network_event( actors.clone(), connections, &actor_pipelines, &mut actor_requests, &actor_workers, pipeline_id, request_id, network_event, ); }, DevtoolsControlMsg::FromChrome(ChromeToDevtoolsControlMsg::ServerExitMsg) => break, } } for connection in &mut accepted_connections { let _ = connection.shutdown(Shutdown::Both); } }