blob: 11f72b7740125c0c780a43a1feddcb238055559b [file] [log] [blame]
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CONTENT_RENDERER_DOM_AUTOMATION_CONTROLLER_H_
#define CONTENT_RENDERER_DOM_AUTOMATION_CONTROLLER_H_
#include <stdint.h>
#include "base/macros.h"
#include "content/public/renderer/render_frame_observer.h"
#include "gin/wrappable.h"
namespace blink {
class WebLocalFrame;
}
namespace gin {
class Arguments;
}
namespace content {
class RenderFrame;
// Provides implementation of window.domAutomationController javascript object.
// Javascript can call domAutomationController.send(...) to send arbitrary data
// to the browser. On the browser side, the data is received via one of the
// following:
// - Product code:
// - Explicit handlers of FrameHostMsg_DomOperationResponse IPC
// - Test code:
// - DOMMessageQueue class
// - ExecuteScriptAndExtractInt/Bool/String functions
class DomAutomationController : public gin::Wrappable<DomAutomationController>,
public RenderFrameObserver {
public:
static gin::WrapperInfo kWrapperInfo;
static void Install(RenderFrame* render_frame, blink::WebLocalFrame* frame);
// Makes the renderer send a javascript value to the app.
// The value to be sent can be either of type String,
// Number (double casted to int32_t) or Boolean. Any other type or no
// argument at all is ignored.
bool SendMsg(const gin::Arguments& args);
private:
explicit DomAutomationController(RenderFrame* render_view);
~DomAutomationController() override;
// gin::WrappableBase
gin::ObjectTemplateBuilder GetObjectTemplateBuilder(
v8::Isolate* isolate) override;
// RenderFrameObserver
void OnDestruct() override;
void DidCreateScriptContext(v8::Local<v8::Context> context,
int world_id) override;
DISALLOW_COPY_AND_ASSIGN(DomAutomationController);
};
} // namespace content
#endif // CONTENT_RENDERER_DOM_AUTOMATION_CONTROLLER_H_