// Copyright (c) 2019 Slack Technologies, Inc. // Use of this source code is governed by the MIT license that can be // found in the LICENSE file. #include "electron/shell/renderer/electron_api_service_impl.h" #include #include #include #include "base/environment.h" #include "base/macros.h" #include "base/threading/thread_restrictions.h" #include "gin/data_object_builder.h" #include "mojo/public/cpp/system/platform_handle.h" #include "shell/common/electron_constants.h" #include "shell/common/gin_converters/blink_converter.h" #include "shell/common/gin_converters/value_converter.h" #include "shell/common/heap_snapshot.h" #include "shell/common/node_includes.h" #include "shell/common/options_switches.h" #include "shell/common/v8_value_serializer.h" #include "shell/renderer/electron_render_frame_observer.h" #include "shell/renderer/renderer_client_base.h" #include "third_party/blink/public/web/blink.h" #include "third_party/blink/public/web/web_local_frame.h" #include "third_party/blink/public/web/web_message_port_converter.h" namespace electron { namespace { const char kIpcKey[] = "ipcNative"; // Gets the private object under kIpcKey v8::Local GetIpcObject(v8::Local context) { auto* isolate = context->GetIsolate(); auto binding_key = gin::StringToV8(isolate, kIpcKey); auto private_binding_key = v8::Private::ForApi(isolate, binding_key); auto global_object = context->Global(); auto value = global_object->GetPrivate(context, private_binding_key).ToLocalChecked(); if (value.IsEmpty() || !value->IsObject()) { LOG(ERROR) << "Attempted to get the 'ipcNative' object but it was missing"; return v8::Local(); } return value->ToObject(context).ToLocalChecked(); } void InvokeIpcCallback(v8::Local context, const std::string& callback_name, std::vector> args) { TRACE_EVENT0("devtools.timeline", "FunctionCall"); auto* isolate = context->GetIsolate(); auto ipcNative = GetIpcObject(context); if (ipcNative.IsEmpty()) return; // Only set up the node::CallbackScope if there's a node environment. // Sandboxed renderers don't have a node environment. node::Environment* env = node::Environment::GetCurrent(context); std::unique_ptr callback_scope; if (env) { callback_scope.reset(new node::CallbackScope(isolate, ipcNative, {0, 0})); } auto callback_key = gin::ConvertToV8(isolate, callback_name) ->ToString(context) .ToLocalChecked(); auto callback_value = ipcNative->Get(context, callback_key).ToLocalChecked(); DCHECK(callback_value->IsFunction()); // set by init.ts auto callback = callback_value.As(); ignore_result(callback->Call(context, ipcNative, args.size(), args.data())); } void EmitIPCEvent(v8::Local context, bool internal, const std::string& channel, std::vector> ports, v8::Local args, int32_t sender_id) { auto* isolate = context->GetIsolate(); v8::HandleScope handle_scope(isolate); v8::Context::Scope context_scope(context); v8::MicrotasksScope script_scope(isolate, v8::MicrotasksScope::kRunMicrotasks); std::vector> argv = { gin::ConvertToV8(isolate, internal), gin::ConvertToV8(isolate, channel), gin::ConvertToV8(isolate, ports), args, gin::ConvertToV8(isolate, sender_id)}; InvokeIpcCallback(context, "onMessage", argv); } } // namespace ElectronApiServiceImpl::~ElectronApiServiceImpl() = default; ElectronApiServiceImpl::ElectronApiServiceImpl( content::RenderFrame* render_frame, RendererClientBase* renderer_client) : content::RenderFrameObserver(render_frame), renderer_client_(renderer_client), weak_factory_(this) {} void ElectronApiServiceImpl::BindTo( mojo::PendingAssociatedReceiver receiver) { // Note: BindTo might be called for multiple times. if (receiver_.is_bound()) receiver_.reset(); receiver_.Bind(std::move(receiver)); receiver_.set_disconnect_handler( base::BindOnce(&ElectronApiServiceImpl::OnConnectionError, GetWeakPtr())); } void ElectronApiServiceImpl::DidCreateDocumentElement() { document_created_ = true; } void ElectronApiServiceImpl::OnDestruct() { delete this; } void ElectronApiServiceImpl::OnConnectionError() { if (receiver_.is_bound()) receiver_.reset(); } void ElectronApiServiceImpl::Message(bool internal, bool send_to_all, const std::string& channel, blink::CloneableMessage arguments, int32_t sender_id) { // Don't handle browser messages before document element is created. // // Note: It is probably better to save the message and then replay it after // document is ready, but current behavior has been there since the first // day of Electron, and no one has complained so far. // // Reason 1: // When we receive a message from the browser, we try to transfer it // to a web page, and when we do that Blink creates an empty // document element if it hasn't been created yet, and it makes our init // script to run while `window.location` is still "about:blank". // (See https://github.com/electron/electron/pull/1044.) // // Reason 2: // The libuv message loop integration would be broken for unkown reasons. // (See https://github.com/electron/electron/issues/19368.) if (!document_created_) return; blink::WebLocalFrame* frame = render_frame()->GetWebFrame(); if (!frame) return; v8::Isolate* isolate = blink::MainThreadIsolate(); v8::HandleScope handle_scope(isolate); v8::Local context = renderer_client_->GetContext(frame, isolate); v8::Context::Scope context_scope(context); v8::Local args = gin::ConvertToV8(isolate, arguments); EmitIPCEvent(context, internal, channel, {}, args, sender_id); // Also send the message to all sub-frames. // TODO(MarshallOfSound): Completely move this logic to the main process if (send_to_all) { for (blink::WebFrame* child = frame->FirstChild(); child; child = child->NextSibling()) if (child->IsWebLocalFrame()) { v8::Local child_context = renderer_client_->GetContext(child->ToWebLocalFrame(), isolate); EmitIPCEvent(child_context, internal, channel, {}, args, sender_id); } } } void ElectronApiServiceImpl::ReceivePostMessage( const std::string& channel, blink::TransferableMessage message) { blink::WebLocalFrame* frame = render_frame()->GetWebFrame(); if (!frame) return; v8::Isolate* isolate = blink::MainThreadIsolate(); v8::HandleScope handle_scope(isolate); v8::Local context = renderer_client_->GetContext(frame, isolate); v8::Context::Scope context_scope(context); v8::Local message_value = DeserializeV8Value(isolate, message); std::vector> ports; for (auto& port : message.ports) { ports.emplace_back( blink::WebMessagePortConverter::EntangleAndInjectMessagePortChannel( context, std::move(port))); } std::vector> args = {message_value}; EmitIPCEvent(context, false, channel, ports, gin::ConvertToV8(isolate, args), 0); } #if BUILDFLAG(ENABLE_REMOTE_MODULE) void ElectronApiServiceImpl::DereferenceRemoteJSCallback( const std::string& context_id, int32_t object_id) { const auto* channel = "ELECTRON_RENDERER_RELEASE_CALLBACK"; if (!document_created_) return; blink::WebLocalFrame* frame = render_frame()->GetWebFrame(); if (!frame) return; v8::Isolate* isolate = blink::MainThreadIsolate(); v8::HandleScope handle_scope(isolate); v8::Local context = renderer_client_->GetContext(frame, isolate); v8::Context::Scope context_scope(context); base::ListValue args; args.AppendString(context_id); args.AppendInteger(object_id); v8::Local v8_args = gin::ConvertToV8(isolate, args); EmitIPCEvent(context, true /* internal */, channel, {}, v8_args, 0 /* sender_id */); } #endif void ElectronApiServiceImpl::TakeHeapSnapshot( mojo::ScopedHandle file, TakeHeapSnapshotCallback callback) { base::ThreadRestrictions::ScopedAllowIO allow_io; base::PlatformFile platform_file; if (mojo::UnwrapPlatformFile(std::move(file), &platform_file) != MOJO_RESULT_OK) { LOG(ERROR) << "Unable to get the file handle from mojo."; std::move(callback).Run(false); return; } base::File base_file(platform_file); bool success = electron::TakeHeapSnapshot(blink::MainThreadIsolate(), &base_file); std::move(callback).Run(success); } } // namespace electron