[System-Keyboard-Lock] Forward navigator functions to RenderFrameHost

content/common/frame.mojom

 // Copyright 2014 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.
 
 module content.mojom;
 
+import "mojo/common/string16.mojom";
+
 import "services/service_manager/public/interfaces/interface_provider.mojom";
 
 // The name of the InterfaceProviderSpec in service manifests used by the
 // frame tree to expose frame-specific interfaces between renderer and browser.
 const string kNavigation_FrameSpec = "navigation:frame";
 
 // Implemented by the frame provider (e.g. renderer processes).
 interface Frame {
   GetInterfaceProvider(service_manager.mojom.InterfaceProvider& interfaces);
 };
 
 // Implemented by the frame (e.g. renderer processes).
 // Instances of this interface must be associated with (i.e., FIFO with) the
 // legacy IPC channel.
 interface FrameBindingsControl {
   // Used to tell a render frame whether it should expose various bindings
   // that allow JS content extended privileges. See BindingsPolicy for valid
   // flag values.
   AllowBindings(int32 enabled_bindings_flags);
 };
 
 // Implemented by the frame server (i.e. the browser process).
 interface FrameHost {
   GetInterfaceProvider(service_manager.mojom.InterfaceProvider& interfaces);
+
+  RequestKeyLock(array<string> key_codes)

[whywhat, 2017/04/11 14:52:33]

I think the intention here is for various APIs to live under their own Mojo
interfaces that FrameHost interface allows the renderer to acquire via
GetInterfaceProvider above - see RegisterMojoInterfaces in RenderFrameHostImpl
and how various mojo services registered there are implemented.

[Hzj_jie, 2017/04/12 02:51:05]

Got you, thank you.
The code has been updated.

+    => (bool allowed_by_user_or_browser, mojo.common.mojom.String16 reason);
+
+  CancelKeyLock() => ();

[whywhat, 2017/04/11 14:52:33]

nit: I believe you can just omit => () if it's not used?

[Hzj_jie, 2017/04/12 02:51:05]

The plan is to let browser tell renderer the finish of this function, though for
now we do not actively export the result to the web page.
These APIs are still under discussing, some users require the callback (promise
v.s. void) of the navigator.cancelKeyLock(), so I would ensure in most of the
design, the signal is correctly posted.

 };
 
 // Implemented by a service that provides implementations of the Frame
 // interface. (e.g. renderer processes).
 interface FrameFactory {
   CreateFrame(int32 frame_routing_id, Frame& frame, FrameHost host);
 };